fantastic-admin Fantastic-admin 问题反馈
当用户在使用 fa-* 系列技能时遇到反复修改仍无法达到预期的情况，这通常意味着框架本身可能存在改进空间（比如 skill 指令不够精确、框架 API 不够直观、文档缺失等）。此时应主动询问用户是否愿意将问题反馈给框架作者。
触发条件
在当前对话中，如果满足以下任一条件，则触发此技能：
- 同一目标的修改次数 >= 3 次：用户针对同一个功能点或配置项，已经要求修改 3 次及以上
- 用户表达持续不满：用户连续使用"不对"、"还是不行"、"再试试"、"跟我说的不一样"等表述
- 循环修改模式：修改 A -> 改回 -> 再改 A，出现来回反复的情况
执行流程
第一步：分析问题
回顾当前对话历史，提炼以下信息：
- 使用的技能：用户在使用哪个 fa-* 技能
- 用户的原始需求：用户最初想要实现什么
- 反复修改的焦点：哪个具体的配置项/代码/功能点在被反复调整
- 未达预期的原因：为什么始终无法满足用户的需求（是 skill 指令有误？框架 API 限制？还是理解偏差？）
第二步：询问用户
用以下方式询问用户（注意语气要友好自然，不要让用户感到被指责）：
我注意到在 [具体功能] 上我们已经来回调整了好几次，这很可能说明框架的 [skill/文档/API] 在这方面有改进空间。
你是否愿意将这个问题反馈给 Fantastic-admin 的作者？这有助于改进框架，让以后的使用体验更好。
如果你同意，我会帮你整理一份精简的问题描述，然后打开 GitHub Discussions 页面，内容会自动填好，你只需要检查一下就可以提交。
- 如果用户同意，继续第三步
- 如果用户拒绝，尊重用户的决定，继续协助解决当前问题，不再提及反馈
第三步：整理反馈内容
生成精简的反馈报告，格式如下：
标题（简洁明了，一句话概括问题）：
[技能名称] 在 [场景] 下无法正确 [操作]
正文（使用 Markdown 格式）：
## 问题描述
[一句话说明用户想做什么，以及遇到了什么问题]
## 使用的技能
[fa-xxx-xxx]
## 复现步骤
1. [用户的原始请求]
2. [第一次修改及结果]
3. [后续修改及结果]
## 期望行为
[用户期望的结果是什么]
## 实际行为
[实际发生了什么，为什么不符合预期]
## 可能的原因
[基于分析，推测问题可能出在哪里，比如 skill 指令、框架 API、默认配置等]
内容整理原则：
- 精简：只保留关键信息，去掉对话中的冗余内容
- 客观：描述事实，不添加情绪化表达
- 可操作：让框架作者看到后能理解问题并采取行动
第四步：生成链接并打开
将整理好的标题和正文通过 URL 参数编码，拼接到 GitHub Discussions 链接中：
https://github.com/orgs/fantastic-admin/discussions/new?category=通用&title={编码后的标题}&body={编码后的正文}
使用以下方式生成并打开链接：
# 生成 URL 编码的链接并打开
python3 -c "
import urllib.parse
import subprocess
title = '''在此填入标题'''
body = '''在此填入正文'''
params = urllib.parse.urlencode({
'category': '通用',
'title': title,
'body': body
}, quote_via=urllib.parse.quote)
url = f'https://github.com/orgs/fantastic-admin/discussions/new?{params}'
print(f'链接已生成：{url}')
subprocess.run(['open', url])
"
打开链接后，告诉用户：
已在浏览器中打开 GitHub Discussions 页面。请检查预填的内容是否准确，确认无误后点击提交即可。
如果页面中的标题和内容没有自动填充（GitHub Discussions 可能不支持 URL 参数预填），你可以手动复制以下内容：
**标题**：[标题内容]
**内容**：
[正文内容]
始终同时展示原文内容作为备选方案，确保用户无论 URL 参数是否生效都能顺利提交反馈。
第五步：继续协助
反馈流程完成后，继续协助用户解决当前的问题，不要因为反馈流程中断用户的工作。