メニュー
深度 bug 分析，用于打破修复-遗忘-重复循环。分析 root cause 分类、fixes 失败原因、预防机制，并将知识捕获到 specs。修复 bug 后用于防止同类 bug。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/yreidev/fluxseek --skill trellis-break-loopコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
实现开始前，从 .trellis/spec/ 发现并注入项目特定编码指南。读取目标 package 的 spec indexes、开发前检查清单和共享思考指南。开始新编码 task、写任何代码前、切换到不同 package 或需要刷新项目约定与标准时使用。
实现前引导协作式需求发现。创建 task 目录、初始化 PRD、一次提出一个高价值问题、研究技术选择，并收敛到 MVP scope。当需求不清晰、存在多种有效方案，或用户描述新功能/复杂 task 时使用。
综合质量验证：spec compliance、lint、type-check、tests、cross-layer data flow、代码复用和一致性检查。代码已写完需要质量验证、提交变更前，或长 session 中捕捉 context drift 时使用。
SOC 職業分類に基づく
| name | trellis-break-loop |
| description | 深度 bug 分析，用于打破修复-遗忘-重复循环。分析 root cause 分类、fixes 失败原因、预防机制，并将知识捕获到 specs。修复 bug 后用于防止同类 bug。 |
debug 完成后，使用此 skill 进行深度分析，打破“fix bug -> forget -> repeat”循环。
从以下 5 个维度分析你刚修复的 bug：
这个 bug 属于哪类？
| 分类 | 特征 | 示例 |
|---|---|---|
| A. Missing Spec | 没有说明该怎么做的文档 | 新功能没有 checklist |
| B. Cross-Layer Contract | layers 之间接口不清楚 | API 返回格式与期望不同 |
| C. Change Propagation Failure | 改了一处，漏了其他处 | 修改 function signature，漏了 call sites |
| D. Test Coverage Gap | Unit test 通过，integration 失败 | 单独可用，组合后破坏 |
| E. Implicit Assumption | 代码依赖未记录假设 | Timestamp seconds vs milliseconds |
如果成功前尝试过多种 fixes，分析每次失败：
哪些机制能防止它再次发生？
| 类型 | 描述 | 示例 |
|---|---|---|
| Documentation | 写下来让大家知道 | 更新 thinking guide |
| Architecture | 通过结构让错误不可能发生 | Type-safe wrappers |
| Compile-time | 严格类型检查，无 escape hatches | Signature 变更导致 compile error |
| Runtime | Monitoring、alerts、scans | 检测 orphan entities |
| Test Coverage | E2E tests、integration tests | 验证完整 flow |
| Code Review | Checklist、PR template | “你检查 X 了吗？” |
这个 bug 揭示了哪些更广泛的问题？
将洞察固化到系统中：
.trellis/spec/guides/ thinking guides.trellis/spec/ docs请按此格式输出分析：
## Bug 分析：[简短说明]
### 1. Root Cause 分类
- **分类**：[A/B/C/D/E] - [分类名称]
- **具体原因**：[详细说明]
### 2. Fixes 为什么失败（如适用）
1. [第一次尝试]：[失败原因]
2. [第二次尝试]：[失败原因]
...
### 3. 预防机制
| 优先级 | 机制 | 具体行动 | 状态 |
|----------|-----------|-----------------|--------|
| P0 | ... | ... | TODO/DONE |
### 4. 系统性扩展
- **相似问题**：[列出可能有相似问题的位置]
- **设计改进**：[架构层建议]
- **流程改进**：[开发流程建议]
### 5. 知识捕获
- [ ] [要更新的文档 / 要创建的 tickets]
调试的价值不在于修复这个 bug，而在于让这类 bug 永远不再发生。
三层洞察：
30 分钟分析可以节省未来 30 小时调试。
重要：完成上述分析后，你必须立即：
更新 spec/guides - 不要只列 TODOs，实际更新相关文件：
cross-platform-thinking-guide.mdcross-layer-thinking-guide.mdcode-reuse-thinking-guide.mdbackend/*.md 或 frontend/*.md同步 templates - 更新 .trellis/spec/ 后，同步到 src/templates/markdown/spec/
Commit spec updates - 这是主要输出，而不只是分析文本
如果分析只停留在聊天中，它就没有价值。价值在于更新后的 specs。