skill-creator

Skill Creator 会遵循项目的技能规范，搭建完整的 `SKILL.md` + `references/` 结构：将概念性参考资料（WHY + WHEN，每篇最多 150 行）与可直接复制粘贴的模板分开。它涵盖四种流程——创建全新技能、重构不符合该模式的技能、完善缺少参考资料或内容过时的技能，以及将现有技能改编为适用于其他框架的技能——每种流程最后都要在所属 Agent 的 frontmatter 和 marketplace.json 中注册，然后通过 `fuse-ai-pilot:sniper` 进行验证。

它只生成技能的结构和文档内容，不会生成技能实质性的技术指南——这些内容必须来自写作前收集的 research-expert + explore-codebase 调研结果。

Skill Creator

Agent 工作流（必须执行）

创建任何技能之前，必须并行启动 3 个 Agent，每个 Agent 各调用一次 Agent，并指定 name：

1. fuse-ai-pilot:explore-codebase - 检查现有技能并分析结构
2. fuse-ai-pilot:research-expert - 在线获取最新官方文档
3. mcp__context7__query-docs - 获取官方来源中的代码示例

创建完成后，运行 fuse-ai-pilot:sniper 进行验证。

---

概述

操作	使用时机
新建技能	尚未编写文档的库/框架
重构	现有技能不符合模式
完善	缺少参考资料或内容过时
改编	复制类似技能（Next.js → React）

---

关键规则

1. 所有内容都必须使用英文 - 不得使用法语或其他语言
2. SKILL.md 用于描述 - 引导 Agent 查阅参考资料/模板
3. 参考资料是概念性的 - WHY + WHEN，每篇最多 150 行
4. 模板必须完整 - 代码可直接复制粘贴
5. 在 Agent + marketplace.json 中注册 - 否则技能不会加载
6. 创建后运行 sniper - 验证所有文件

---

架构

skills/<skill-name>/
├── SKILL.md                    # Entry point (guides agent)
└── references/                 # All documentation
    ├── installation.md         # Setup, configuration (conceptual)
    ├── patterns.md             # Core patterns (conceptual)
    ├── ...                     # Other references
    └── templates/              # Complete code examples
        ├── basic-setup.md      # Full project setup
        └── feature-example.md  # Feature implementation

→ 详情请参阅 architecture.md

---

参考指南

概念

主题	参考资料	查阅时机
工作流	workflow.md	创建/完善技能时
架构	architecture.md	了解技能结构时
内容规则	content-rules.md	编写参考资料/模板时
注册	registration.md	使技能可用时
改编	adaptation.md	在不同框架间转换时

模板

模板	使用时机
SKILL-template.md	创建新的 SKILL.md
reference-template.md	创建参考文件
template-template.md	创建代码模板

---

快速参考

创建新技能

# 1. Research documentation
→ research-expert + context7/exa

# 2. Create structure
mkdir -p plugins/<agent>/skills/<name>/references/templates

# 3. Create files
→ SKILL.md (from template)
→ references/*.md (conceptual)
→ references/templates/*.md (code)

# 4. Register
→ agent frontmatter + marketplace.json

# 5. Validate
→ sniper

完善现有技能

# 1. Analyze
→ explore-codebase

# 2. Research updates
→ research-expert (latest docs)

# 3. Add missing files
→ references + templates

# 4. Validate
→ sniper

---

验证清单

• 所有内容都使用英文
• SKILL.md 包含正确的 frontmatter
• frontmatter 中列出了所有参考资料
• 存在 Agent 工作流部分
• 参考指南包含概念和模板表格
• 每篇参考资料少于 150 行
• 模板包含完整且可运行的代码
• 已在 Agent + marketplace.json 中注册

---

最佳实践

应做事项

• 写作前调研官方文档
• 使用表格整理内容
• 在参考资料中链接到模板
• 保持参考资料的概念性
• 确保模板可直接复制粘贴

不应做事项

• 使用法语写作（只能使用英文）
• 直接复制粘贴原始文档
• 参考资料超过 150 行
• 忘记注册步骤
• 跳过 sniper 验证