附录 C：术语表与阅读路线¶
术语表¶
| 术语 | 含义 |
|---|---|
| Agent | 能根据上下文选择工具并循环推进任务的模型驱动执行者 |
| Harness | 承载 Agent 的宿主产品，如 Claude Code、Codex、Cursor |
| Skill | 面向 Agent 的过程协议，通常由 SKILL.md 定义 |
| Hook | 在宿主生命周期事件触发外部命令并返回上下文或动作的机制 |
| SessionStart | 会话启动、清空或压缩后可用的初始化事件 |
| Bootstrap | 把入口规则送入新会话的过程 |
| SDD | Subagent-Driven Development，按任务派发 implementer 并独立 review |
| TDD | Test-Driven Development，先 RED，再 GREEN，最后 REFACTOR |
| Worktree | Git 提供的隔离工作目录，可让多个任务基于同一仓库并行工作 |
| Fix loop | reviewer 发现问题后返回 implementer 修复并再次验证的循环 |
| Fresh evidence | 当前工作区、当前命令、当前输出产生的新鲜证据 |
| YAGNI | You Aren’t Gonna Need It，不为未被需求证明的复杂性提前实现 |
| Progressive disclosure | 只在技能适用时加载正文和引用资料，控制上下文成本 |
| Harness adapter | 将通用技能翻译到特定宿主 manifest、hook 和工具名的薄层 |
一次功能请求的阅读路线¶
如果你想跟踪一次新功能从输入到交付，按以下顺序读：
skills/using-superpowers/SKILL.md：为什么要先检查技能；skills/brainstorming/SKILL.md：如何澄清和确认设计；skills/writing-plans/SKILL.md：如何把设计拆成任务；skills/using-git-worktrees/SKILL.md：如何建立干净基线；skills/subagent-driven-development/SKILL.md：如何执行和审查任务；skills/test-driven-development/SKILL.md：如何验证每个行为；skills/verification-before-completion/SKILL.md：如何形成完成证据；skills/finishing-a-development-branch/SKILL.md：如何交付并清理。
一次 bug 的阅读路线¶
现象 → systematic-debugging
→ test-driven-development（补回归测试）
→ verification-before-completion
→ requesting / receiving code review
重点是不要把“bug 修复”理解为一条 if 分支，而要把根因、回归测试和独立验证一起纳入交付物。
一次新 Harness 移植的阅读路线¶
docs/porting-to-a-new-harness.md：了解移植边界；skills/using-superpowers/references/：查看已有工具映射；.codex-plugin/plugin.json或.kimi-plugin/plugin.json：比较 manifest；hooks/session-start：理解共享 transport；tests/opencode/、tests/pi/、tests/kimi/：模仿最窄集成测试。
最后一个判断¶
阅读 Superpowers 时，不要只问“这个技能要求 Agent 做了哪些步骤”，还要问：
- 它在防止哪一种具体失败？
- 哪个事件或输出可以验证它？
- 哪些判断属于通用方法论，哪些只是平台方言？
- 如果删掉这一步，错误会在生命周期的哪个更晚阶段暴露？
这四个问题，正是把一份提示词拆解成工程系统的入口。