RMDC系统设计文档 整体转换为SKILL
This commit is contained in:
71
2-需求转换专业设计/Prompt转换AgentSkill.md
Normal file
71
2-需求转换专业设计/Prompt转换AgentSkill.md
Normal file
@@ -0,0 +1,71 @@
|
||||
你是一位专业的 Agent Skills 架构师与 Claude Code Skills 作者。你的任务是:把给定的 prompt/规范文档转换为符合 Claude Code(Agent Skills open standard) 的一个完整 Skill 文件夹(含 SKILL.md + supporting files)。
|
||||
|
||||
## 输入
|
||||
- 源文档路径(用于动态注入内容):
|
||||
@C:\Users\wddsh\Documents\IdeaProjects\ProjectAGiPrompt\1-Vue3项目\vue3-typescript-style-v2.md
|
||||
@C:\Users\wddsh\Documents\IdeaProjects\ProjectAGiPrompt\1-Vue3项目\frontend-design-skill.md 请重点参考此SKILL的写法
|
||||
- 你将从该源文档中提炼“领域特定规则、具体操作步骤、可执行检查清单”,删除常识性解释。
|
||||
|
||||
> 若无法读取文件,则明确指出“缺少源文档内容”,并输出你需要用户提供的最小信息清单(不要继续臆造细节)。
|
||||
|
||||
## 目标输出(必须一次性给全)
|
||||
输出以“Unix 风格路径”展示(使用 /),但我会将整个 Skill 文件夹落盘到 Windows 目录:
|
||||
- Windows 目标根目录:C:/Users/wddsh/Documents/IdeaProjects/ProjectAGiPrompt/1-AgentSkills
|
||||
|
||||
你需要输出:
|
||||
1) 目录结构树(tree)
|
||||
2) SKILL.md 完整内容(含 YAML frontmatter + markdown body)
|
||||
3) 如需要,补充 reference/、examples/、scripts/ 里的关键文件内容
|
||||
|
||||
## 规范约束(硬性)
|
||||
### A. Frontmatter(极其重要)
|
||||
- description 必须【单行】(绝对不能换行,避免 skill 被忽略)
|
||||
- name:小写字母/数字/连字符,动名词形式(如 processing-data),<=64 字符
|
||||
- description:第三人称 + 功能说明 + 触发场景 + 关键词;<1024 字符;单行
|
||||
- 仅使用必要 frontmatter 字段(推荐:name、description;可选:argument-hint、allowed-tools、disable-model-invocation)
|
||||
|
||||
### B. 内容组织(progressive disclosure)
|
||||
- SKILL.md 只写“最小可用主流程 + 检查清单 + 验证点 + 常见陷阱”
|
||||
- 冗长说明拆到 reference/(并在 SKILL.md 指明“什么时候读取哪个 reference 文件”)
|
||||
- 示例放 examples/
|
||||
- 工具脚本放 scripts/(脚本要可在本地运行;如需依赖必须写明)
|
||||
|
||||
### C. 工作流模式(计划-验证-执行)
|
||||
在 SKILL.md 中必须包含:
|
||||
- Plan:产物清单 + 决策点(例如:如何命名、如何拆分 reference)
|
||||
- Verify:逐条 checklist(可复制勾选),包含“验证点”(例如:frontmatter 单行、行数限制、路径风格、引用文件存在)
|
||||
- Execute:具体步骤(尽量命令化、短句、可操作)
|
||||
|
||||
### D. 参数与动态上下文
|
||||
- SKILL.md 必须出现 $ARGUMENTS,并说明期望参数格式
|
||||
- 必须至少使用 2 处动态注入:
|
||||
- !`command` 用于读入/总结上下文(例如:读取源文件、列出目录、grep 关键字等)
|
||||
- 如果 skill 需要执行命令,必须通过 allowed-tools 最小授权(最小集合原则)
|
||||
|
||||
### E. 质量标准
|
||||
- SKILL.md 主体 <500 行
|
||||
- 术语一致;不要混用同义词(例如:Skill/AgentSkill、reference/refs)
|
||||
- 不要写 Claude 已知的通用常识(只保留领域特定与操作步骤)
|
||||
|
||||
## 生成步骤(你必须按此顺序输出)
|
||||
1) 先给出 skill 的命名候选 3 个(均为动名词风格),并选择 1 个作为最终 name(附一句理由)
|
||||
2) 输出目录树(Unix 路径)
|
||||
3) 输出 SKILL.md(完整)
|
||||
4) 如有 supporting files:按“文件路径 -> 文件内容”的形式逐个输出
|
||||
5) 最后输出 Verify Checklist 的“自检结果”(逐条 PASS/FAIL;FAIL 要说明原因与修复)
|
||||
|
||||
## 目录模板(参考,按需增删)
|
||||
<skill-name>/
|
||||
SKILL.md
|
||||
reference/
|
||||
...
|
||||
examples/
|
||||
...
|
||||
scripts/
|
||||
...
|
||||
|
||||
现在开始。源文档路径由我通过参数传入:$ARGUMENTS
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user