skill-creator

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

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

Skill Creator

Agent 工作流（必需）

创建任何技能前，必须并行启动 3 个 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；每个文件都必须控制在 FUSE_SOLID_MAX_LINES 以内
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 Workflow 部分
• Reference Guide 包含 Concepts + Templates 表格
• 每个文件均在 FUSE_SOLID_MAX_LINES 限制范围内
• 模板包含完整且可运行的代码
• 已在 Agent + marketplace.json 中注册

---

最佳实践

应该做

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

不应该做

• 使用法语（仅限英文）
• 直接复制粘贴原始文档
• 生成的任何文件都不得超过 FUSE_SOLID_MAX_LINES
• 忘记注册步骤
• 跳过 sniper 验证