复合知识捕获技能Skill phx:compound

---

name: phx:compound description: 将解决的问题捕获为可搜索的Elixir/Phoenix解决方案文档。创建复合知识，使未来调试更快。 argument-hint: [对修复内容的描述]

Compound — 将解决方案捕获为知识

在解决问题后，将解决方案捕获为可搜索的制度化文档。

用法

/phx:compound 修复用户列表中的N+1查询
/phx:compound 解决仪表板中的LiveView超时问题
/phx:compound   # 从最近的会话上下文中自动检测

哲学

每个工程工作单元都应该使后续单元更容易 — 而不是更难。

工作流程

步骤1: 检测上下文

1. 如果提供 $ARGUMENTS，则用作描述
2. 如果没有参数，检查便笺板DEAD-END/DECISION条目、git diff、.claude/plans/{slug}/progress.md 以获取最近完成的内容
3. 如果不明确，询问：“你刚刚解决了什么问题？”

仅记录非平凡问题，即需要调查的问题。

步骤2: 搜索现有解决方案

mkdir -p .claude/solutions
grep -rl "KEYWORD" .claude/solutions/ 2>/dev/null

如果找到：创建新（不同根本原因）、更新现有（相同根本原因，新症状）或跳过。

步骤3: 收集细节并创建解决方案

从会话上下文中提取：模块、症状、调查步骤、根本原因、解决方案代码和预防建议。

根据 compound-docs/references/schema.md 验证前端事务，然后使用 compound-docs/references/resolution-template.md 创建文件。

步骤4: 决策菜单

1. 继续（默认）
2. 提升到铁律检查 — 添加到 iron-law-judge
3. 更新技能参考 — 添加到相关技能
4. 更新 CLAUDE.md — 添加预防规则

自动触发短语

当用户说"那工作了"、“它修复了”、“问题解决了”、“修复是” — 建议 /phx:compound。

铁律

1. YAML前端事务验证或停止
2. 症状必须具体 — 不是"它坏了"
3. 根本原因是为什么，而不是什么
4. 每个文件一个问题

与工作流集成

/phx:review → 完成 → /phx:compound  ← 你在这里
                              │
                 .claude/solutions/{category}/{fix}.md
                              │
              /phx:investigate 和 /phx:plan 在这里搜索

参考

• references/compound-workflow.md — 详细步骤指南
• 另见：compound-docs 技能用于模式和模板