菜单
USE WHEN: 用户想新建 skill / 评估现有 skill 结构 / 生成 skill 骨架。OUTPUT: 完整 skill 目录(SKILL.md + scripts/ + references/),按 Anthropic 6 铁律 + 本项目约定。DO NOT USE: 单纯查 skill 用法(直接读 SKILL.md) / 创建 agent 或 command(那是 `.claude/agents/` 和 `.claude/commands/` 的入口)。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
流程编排引擎。推进 task.json.flow 步骤（init/check/complete/reset）并维护任务级事件流 task.json.events（emit/check/recent）。触发关键词：flow advance、推进流程、当前步骤、初始化流程、emit event、查事件、task.json.events、flow-engine。
TAPD 统一入口 skill。工单拉取、共识管理、子任务回填、事件驱动同步。触发关键词：tapd、初始化、ticket sync、共识、Wiki 评审、子任务、工时回填、QA 通过、QA 打回、TAPD 事件、契约推送、同步工单、拉工单。
产出结构化 handoff 工件，让新 session 无痕接续当前任务。ctx-guard 阻断或主动切换 session 时使用。触发关键词：context reset、上下文重置、新开 session、切换 session、handoff。
运行架构适应度函数检查代码结构、契约、依赖方向。在代码修改前后使用，确保不引入架构违规。触发关键词：fitness、架构检查、适应度、lint、代码质量检查。
工作流熵管理。清理 stale TAPD cache、孤立 _index 条目、过期 task report。每日定时或手动触发。触发关键词：gc、垃圾回收、清理、cleanup、定时清理。
Git 操作统一入口。分支生命周期（create/merge/cleanup）、worktree（create/remove）、提交推送（commit-push）。按 docs/git-brance-spec.md + Conventional Commits 中文规范执行。触发关键词：创建分支、合并到 dev、合并到 uat、删除分支、清理分支、git push、commit、推送代码、worktree、提交代码。
基于 SOC 职业分类
| name | skill-author |
| description | USE WHEN: 用户想新建 skill / 评估现有 skill 结构 / 生成 skill 骨架。OUTPUT: 完整 skill 目录(SKILL.md + scripts/ + references/),按 Anthropic 6 铁律 + 本项目约定。DO NOT USE: 单纯查 skill 用法(直接读 SKILL.md) / 创建 agent 或 command(那是 `.claude/agents/` 和 `.claude/commands/` 的入口)。 |
| model | opus |
把 Anthropic 6 铁律 + 本项目约定固化为可复用的元 skill。新 skill 调它生成,老 skill 用它体检。
新建 skill / 创建 skill / 做一个 X skill / 改 skill 结构 / 体检 skill。
.claude/agents/ 和 .claude/commands/ 的入口）| # | 铁律 | 一句话 |
|---|---|---|
| 1 | Skill 是文件夹 | 不是单文件,配套 scripts/ + references/ 渐进披露 |
| 2 | Description 是触发器 | USE WHEN/DO NOT USE 风格,不写"能做什么" |
| 3 | 给代码不给死指令 | helper 脚本下沉,避免每次让 Claude 重写胶水 |
| 4 | Gotchas 是灵魂 | 记录实际踩过的坑(不是空话),持续累积 |
| 5 | Skill 有记忆 | 读写状态文件实现跨 session 持久化 |
| 6 | 指令留白 | 描述目标而非步骤,让 Claude 适应具体情境 |
详读 references/six-iron-laws.md。
| 约定 | 简述 |
|---|---|
| frontmatter 4 字段 | name / description / model / rules（可选） |
| 目录结构 | .claude/skills/<name>/{SKILL.md, scripts/, references/} |
| Python helper 风格 | argparse 子命令 + PROJECT_DIR 顶部硬编码 + JSON 输出 |
| SKILL.md 段结构 | 触发 / 边界 / Gotchas / CLI / 流程 / 关联 |
| 9 类 skill 全景 | 知识/验证/数据/自动化/脚手架/审查/部署/调试/运维 |
详读：
python .claude/skills/skill-author/scripts/scaffold.py create <name> \
--type <knowledge|validation|data-access|automation|scaffold|code-review|deployment|debug|operation> \
--description "<USE WHEN ... DO NOT USE ...>" \
[--with-scripts] # 默认 true
[--with-references] # 默认 false
[--model sonnet] # haiku|sonnet|opus
[--rules agent-conventions]
输出 JSON：{"ok": true, "path": "...", "files_created": [...]}
flowchart LR
A[1. 定位 9 类] --> B[2. 写 description]
B --> C[3. scaffold 生骨架]
C --> D[4. 填触发/边界]
D --> E[5. helper.py smoke]
E --> F[6. 真实场景试用]
F --> G[7. 回填 Gotchas]
python scaffold.py create <name> ... 生成骨架helper.py --help 能出，至少一个子命令 smoke test 通过sys.path.insert(0, str(Path(__file__).resolve().parents[3] / "scripts")),parents[3] 才是 .claude/.claude/skills/skill-author/scripts/scaffold.pyreferences/