菜单
Use when 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景：创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | skill-smith |
| description | Use when 需要创建新的 AI Agent 技能、改进已有 SKILL.md 文件、设计技能工作流或不确定技能该如何组织时。触发场景：创建技能、新建技能、写技能、技能开发、skill-smith、设计技能、编写SKILL.md、制作技能、开发skill、如何写一个好技能、技能质量不好怎么改进。 |
铁律：每一行内容都要对得起 token 消耗。不写 Claude 已经知道的东西，只写它不知道的领域知识、流程规范和决策框架。
技能是给 AI Agent 的"专项培训手册"——把它从通用助手变成领域专家。好的技能应该：
至少收集 3 个具体的使用示例：
询问用户：
"请给我 3 个你会如何使用这个技能的具体例子，
包括你会说什么，以及你期望得到什么输出。"
没有 3 个具体例子，不进入下一步。
同时了解：
加载 references/architecture-guide.md，回答以下问题：
主文件 SKILL.md：
参考文档 references/：
资源文件 assets/（可选）：
架构决策原则：
SKILL.md 控制在 500 行以内references/加载 references/description-guide.md。
---
name: skill-name
description: "核心描述。触发词：[关键词 1]、[关键词 2]、[关键词 3]..."
---
描述要求：
在标题下方立即写出最重要的约束：
# 技能名称
铁律：[最重要的行为约束，用户最需要知道的一条规则]
加载 references/workflow-patterns.md。
使用勾选清单格式，让 AI 可以追踪进度：
## 工作流
- [ ] 第一步：[描述]（标注是否必须）
- [子步骤 1]
- [子步骤 2]
- [ ] 第二步：[描述]
- 用户确认门控：[在继续前必须获得用户批准]
确认门控示例：
**将以上内容展示给用户确认，批准后才继续。**
文件末尾列出所有 references 及加载时机：
## 参考资源
- `references/checklist.md` — 在第 3 步加载，用于[目的]
- `references/template.md` — 在输出阶段加载，用于[目的]
每个 reference 文件：
security-checklist.md 而非 ref1.md）发布前检查清单：
SKILL.md 是否 < 500 行？编写简短的安装和使用说明：
npx skills add ...）skill-name/
├── SKILL.md # 主文件（<500行）
├── README.md # 安装和使用说明
└── references/ # 按需加载的参考文档
├── checklist.md
└── template.md
| 反模式 | 识别特征 | 处理方式 |
|---|---|---|
| 废话文学 | 解释 Claude 已知的基础概念 | 删除 |
| 一次性全加载 | 所有 references 在开头全部加载 | 改为按步骤按需加载 |
| 没有铁律 | 缺少明确的行为约束 | 识别最重要的约束写到最前面 |
| 没有确认门控 | 自作主张连续执行 | 在关键决策前增加用户确认 |
| 超大单文件 | SKILL.md > 1000 行 | 将重型内容移到 references |
| 触发词不足 | description 太短，只有 1-2 句 | 增加 10-20 个触发关键词 |
遇到以下想法，立刻停下——未经验证的技能比没有技能更有害（会给 Agent 错误指导）：
| 借口 | 现实 |
|---|---|
| "需求很清楚，不需要 3 个例子" | 例子的作用是暴露你的假设，不是重复已知信息。没有例子就没有边界检验。 |
| "description 有几个触发词就够了" | 触发词不足导致技能无法被发现。10-20 个关键词是最低要求，不是上限。 |
| "SKILL.md 长一点没关系，内容更全面" | 超过 500 行的 SKILL.md 会消耗过多 context。把重型内容移到 references。 |
| "这个技能很简单，不需要反模式清单" | 简单技能的边界更容易被 Agent 误解。反模式清单是防止误用的护栏。 |
| "用户要的快，先发布再完善" | 未完善的技能会被 Agent 错误遵循，修复成本远高于一开始做好。 |
references/description-guide.md — Frontmatter description 编写指南references/workflow-patterns.md — 工作流设计模式references/architecture-guide.md — 技能架构设计原则超压缩通信模式。通过去掉废话、冠词和客套语，在保持完整技术准确性的同时削减约 75% token 用量。 当用户说"caveman 模式"、"简洁模式"、"少废话"、"省 token"、"简短点"或调用 /caveman 时触发。
对用户的计划或设计进行不留情面的深度追问，直到达成共同理解，逐一解决决策树的每个分支。当用户想要压力测试计划、检验设计时触发。触发词：追问我、grill me、逐一问我、挑战我的方案、深度追问、质疑设计、设计评审追问。
将当前对话压缩为交接文档，供下一个 Agent 会话接续工作。触发词：交接、handoff、下一个会话、会话摘要、接续工作、传给下一个 agent。
在代码库中发现架构"深化"机会——将浅模块变成深模块的重构，提升可测试性和 AI 可导航性。与 architecture-advisor 互补：architecture-advisor 设计新架构，本技能改善现有代码库结构。触发词：改进代码库架构、架构深化、找重构机会、模块耦合太紧、难以测试、代码难以理解、架构改进、improve architecture、refactor opportunities。
快速验证设计的一次性原型。区分两条分支——逻辑/状态模型用终端交互 App，UI 布局用多变体路由切换。当用户想原型验证、检验数据模型或状态机、探索多种 UI 方案时触发。触发词：原型、prototype、验证方案、快速试验、让我玩一玩、试几个设计。
Use when 已有书面实施计划、任务相对独立，且在本会话内通过子代理逐任务落实时。触发场景：执行实施计划、子代理开发、按计划实现、Task 派发实现、两阶段代码审查、plan execution。