skill-architect
能力
引导用户从零设计并构建高质量的 Agent 技能,覆盖独立 skill 和 MCP-enhanced 工作流。
适用触发:
- "我想创建一个新 skill"
- "帮我把这个流程封装成 skill"
- "I want to automate this workflow"
- "how do I teach my Agent to do X"
- 需要创建
SKILL.md文件时
不适用于:创建 subagent 或撰写技术设计文档。
5 阶段工作流
严格按顺序执行,不允许跳步:
Rendering diagram…
① Discovery — 理解需求
- 理解用户想解决什么问题
- 定义 2–3 个具体用例
- 明确触发条件和成功标准
- 识别边界情况、已有工具能力
② Architecture — 选模式 + 规划结构
选择合适的设计模式:
| 模式 | 何时用 |
|---|---|
| 顺序工作流 | 流程固定、步骤清晰 |
| 迭代精化 | 需要多轮反馈、逐步收敛 |
| 上下文感知 | 输出高度依赖当前上下文 |
| 领域智能 | 需要大量专业知识、LLM 逻辑主导 |
规划目录结构、撰写 description(含触发短语 + 负向边界)。
③ Craft — 编写
- frontmatter(
namekebab-case +description≤ 1024 字符) - 指令正文(≤ 500 行)
- 真实示例
- 错误处理路径
④ Validate — 校验
- 结构校验(frontmatter 格式、kebab-case、无 README.md)
- 触发测试(描述是否会被正确唤起)
- 指令质量审查(歧义、冗余、缺失)
⑤ Deliver — 交付
使用 skills_create(name, description, content) 工具创建技能。content 只传 Markdown 正文(# 标题开始),不含 --- frontmatter 块。
硬性规则
| 规则 | 要求 |
|---|---|
| name | kebab-case,无空格无大写 |
| description | [功能] + [触发短语] + [不适用场景],≤ 1024 字符,不含 XML 尖括号 |
| SKILL.md | 正文 ≤ 500 行 |
| 不许跳 Discovery | 禁止跳过 Discovery 直接生成 SKILL.md |
反模式(必须避免)
- description 写成"一段描述性文字"而没有触发短语
- 未做 Discovery 就开始 Craft
- 把用户原话直接抄进 skill 而不提炼通用规则
- 不明确负向边界("不适用于...")
触发方式
自然语言示例:
- "帮我做一个 skill 把我常用的 SQL 查询封装起来"
- "给我的 Agent 教会怎么做 A/B 测试报告"
- "turn this workflow into a skill"
相关文档
- skill-refinement — 已有 skill 的改进(vs. 从零创建)
- 自定义技能开发
- 核心概念 · Skill 技能体系