第 10 章：自动编排 — 用 CLAUDE.md 让命令自动执行

你将学到什么

• 回顾前 9 章手动执行的命令序列
• 在 CLAUDE.md 中定义项目规则，让 Claude 自动选择正确的命令
• 用 /writing-skills 创建自定义 skill
• 从手动到自动的演进路径

10.1 问题：每次都要手动输命令

回顾前 9 章，你手动执行了很多命令：

/plan-ceo-review → /plan-design-review → /plan-eng-review
→ /design-consultation → /design-shotgun → /design-html → /design-review
→ /writing-plans → /subagent-driven-development
→ /requesting-code-review → /review → /qa

每次新项目都要重新输一遍？能不能让 Claude 自动知道该用哪些命令？

答案是可以，但有条件。

10.2 CLAUDE.md 作为编排引擎

CLAUDE.md 不只是项目说明文件——它可以让 Claude 遵循特定的工作流规则。

在 CLAUDE.md 中添加工作流规则

# CLAUDE.md

## AI Workflow Rules

### 新功能开发流程
1. 需求阶段：先用 /plan-eng-review 审查需求可行性
2. 设计阶段：用 /design-shotgun 生成 UI 方案
3. 计划阶段：用 /writing-plans 拆解任务
4. 编码阶段：用 /subagent-driven-development 自动执行
5. 审查阶段：用 /requesting-code-review 检查代码质量
6. 所有改动必须有测试覆盖

### Bug 修复流程
1. 用 /systematic-debugging 排查问题
2. 写回归测试（先红灯再绿灯）
3. 修复后运行全量测试确认无回归

### 禁止事项
- 不要跳过测试直接提交代码
- 不要在没有计划的情况下做大型重构
- 不要忽略 code review 中的 Critical 问题

这样做的好处

当你告诉 Claude "帮我添加一个导出功能"时，它会：

1. 读取 CLAUDE.md 中的工作流规则
2. 按规则执行：先 /plan-eng-review，再 /writing-plans，再 /subagent-driven-development
3. 不需要你手动指定每一步

这样做的限制

CLAUDE.md 是规则提示，不是强制执行。Claude 可能：

• 在某些情况下忽略规则（比如"这个改动很小不需要 plan"）
• 对规则的理解跟你预期不同
• 不会严格按顺序执行每一步

简单说：CLAUDE.md 是"建议"，不是"程序"。 如果需要严格的执行顺序，要写自定义 skill。

10.3 /writing-skills — 创建自定义 skill

什么是 skill

skill 就是一个预定义的提示模板。你写好一个 skill，以后只要输入 /skill-name 就能触发一整套操作。

实战：创建 NoteFlow 迭代 skill

/writing-skills

Claude 会引导你创建 skill。我们创建一个 /noteflow-iterate skill：

Skill 定义文件： .claude/skills/noteflow-iterate/SKILL.md

# NoteFlow 功能迭代 Skill

## 触发条件
当用户要求为 NoteFlow 添加新功能或修改现有功能时。

## 执行步骤

### Step 1: 需求审查
运行 /plan-eng-review 审查需求的技术可行性。

### Step 2: 更新计划
在 docs/superpowers/plans/ 下创建或更新实施计划。
确保：
- 每个任务有完整的代码和测试
- 无 placeholder
- 考虑与现有功能的兼容性

### Step 3: 自动执行
运行 /subagent-driven-development 执行计划。

### Step 4: 质量检查
- 运行 /requesting-code-review 检查代码质量
- 运行全量测试确认无回归
- 处理所有 Critical 级别问题

### Step 5: Commit
所有改动必须包含：
- 功能代码
- 对应测试
- 有意义的 commit message

## 注意事项
- 不跳过任何步骤
- 测试必须通过才能 commit
- Critical 问题必须修复

使用自定义 skill

创建好后，以后只要输入：

/noteflow-iterate 添加 Markdown 预览支持

Claude 就会按照 skill 定义的步骤自动执行。

10.4 从手动到自动的演进路径

flowchart LR
    A["第 1 级
手动执行
━━━━━━━━
每步手动输命令"] --> B["第 2 级
CLAUDE.md 规则
━━━━━━━━
Claude 遵循规则
自动选择命令"]
    B --> C["第 3 级
自定义 skill
━━━━━━━━
一键触发
完整工作流"]
    C --> D["第 4 级
CI/CD 集成
━━━━━━━━
提交 PR 自动
触发审查流程"]

    style A fill:#fecaca,stroke:#dc2626
    style B fill:#fef3c7,stroke:#d97706
    style C fill:#dbeafe,stroke:#2563eb
    style D fill:#dcfce7,stroke:#16a34a

建议： 跟完本教程后从第 2 级开始。等项目成熟后创建第 3 级的自定义 skill。

10.5 gstack 和 superpowers 能被编排吗

回到之前的问题：能不能把这些命令编排成自动流水线？

现实情况： gstack 和 superpowers 的 skill 都是 markdown 文件，不是代码。它们能被 CLAUDE.md "引导"，但不能像代码脚本那样严格编排。

最佳实践： 用 CLAUDE.md 定义规则 + 自定义 skill 封装流程 = 足够好的自动化。不需要 100% 自动，80% 就够。

动手做

1. 更新 CLAUDE.md，添加工作流规则
2. 运行 /writing-skills，创建 /noteflow-iterate skill
3. 测试 skill：/noteflow-iterate 添加笔记导出功能
4. 观察 Claude 是否按 skill 定义的步骤执行

本章小结

核心原则： 从手动开始，逐步自动化。先用 CLAUDE.md 定规则，再用 skill 封装流程。不要一步到位追求全自动。