菜单
当 Trellis 子任务实现/验证过程中测试该绿不绿、或自检命令失败时，用一段不可偏离的刚性脚本做系统化根因定位与最小修复。用于 Codex / Claude Code 等驱动 qwen3.6 35b 这类小参数模型调试时——小模型一旦自由发挥就会到处乱改，本技能用"一次只改一处、改完必重跑、禁止猜"的铁律把它锁在窄路径上，并带防御性回归检查。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Create a Trellis MVP task tree from a full requirements document. Use when Codex receives a product brief, requirements document, PRD, zero-to-MVP request, large capability-building request, or partially implemented project and must do read-only analysis, assign stable REQ/AC IDs, build full requirement and MVP coverage matrices, lock project contracts, identify existing implementation evidence, use progressive batch and sub-agent planning to form a complete MVP parent/child task tree, draft PRD/design/implementation artifacts, and create Trellis tasks only after user confirmation; do not write application code.
从完整需求文档创建 Trellis MVP 任务树。用于 Codex 收到产品说明、需求文档、PRD、从 0 到 MVP 的新项目需求、大型能力建设请求，或已经手工实现了一部分功能的项目时，先做只读分析，分配稳定 REQ/AC 编号，生成需求追踪矩阵和项目契约，识别已有实现证据，通过渐进式批次规划和子代理协作形成完整 MVP 父子任务树、PRD、设计/实现产物计划，并在用户确认后创建 Trellis 任务；不编写应用代码。
Audit an existing MVP against a source requirements document and run a sustainable Trellis delivery loop. Use when Codex is asked to continue after an MVP, complete remaining requirements, perform a first full gap audit, maintain a Requirements Traceability Matrix, classify DONE/PARTIAL/MISSING/UNTESTED/UNCLEAR items, initialize or update .trellis/delivery-state.md, choose full/delta/early-exit audit scope, plan bounded gap-closing batches, require worktree + verifier gates, design automated test coverage, classify discovered bugs, or run final acceptance before delivery.
根据源需求文档审计已有 MVP，并执行 Trellis 完整交付 loop 的审计、状态维护、批次规划和最终验收。用于 Codex 被要求在 MVP 后继续、补齐剩余需求、执行 full/delta 差距审计、维护 Requirements Traceability Matrix、分类 DONE/PARTIAL/MISSING/UNTESTED/UNCLEAR 条目、初始化或更新 .trellis/delivery-state.md、规划有边界的补缺批次、要求 worktree + verifier 门、设计自动化测试覆盖、分类发现的 bug，或在交付前执行最终验收的场景。若由 trellis-delivery-controller-zh 调用，则遵循控制器已选定的 loop 模式和审计范围；若单独调用，则按本技能的 delivery-loop-policy 自行判定。
Trellis requirements-to-delivery entrypoint and workflow controller. Use when the user wants to invoke one Trellis skill that detects the current stage and routes work across requirements analysis, MVP task planning, post-MVP gap audit, delivery loop, TDD implementation, systematic debugging, two-stage review, and final acceptance. Coordinates trellis-zero-to-mvp, trellis-mvp-to-delivery, trellis-implement-tdd, trellis-debug-systematic, and trellis-review-twostage while enforcing safety gates.
Trellis 需求交付总入口和流程控制器。用于用户希望只调用一个 Trellis skill 自动判断当前阶段，并在需求分析、MVP 任务规划、MVP 后差距审计、交付 loop、TDD 实现、系统调试、双阶段评审和最终验收之间进行路由、推进和安全门控制的场景。适合基于 trellis-zero-to-mvp-zh、trellis-mvp-to-delivery-zh、trellis-implement-tdd-zh、trellis-debug-systematic-zh 和 trellis-review-twostage-zh 形成端到端交付闭环。
| name | trellis-debug-systematic-zh |
| description | 当 Trellis 子任务实现/验证过程中测试该绿不绿、或自检命令失败时，用一段不可偏离的刚性脚本做系统化根因定位与最小修复。用于 Codex / Claude Code 等驱动 qwen3.6 35b 这类小参数模型调试时——小模型一旦自由发挥就会到处乱改，本技能用"一次只改一处、改完必重跑、禁止猜"的铁律把它锁在窄路径上，并带防御性回归检查。 |
接管一次失败的测试或自检命令，按固定的 4 步把它修绿：固定失败信号 → 定位 → 单一假设验证 → 最小修复 + 回归。本技能存在的意义是防止（尤其是小模型）在调试时乱改、越改越坏——所以它是一段编号脚本 + 铁律，不是建议。
触发：trellis-implement-tdd-zh 的红绿循环里某测试该绿不绿，或 prd.md 自检命令失败，且原因不显然。
调试轨迹固定写入任务目录下的 <task-dir>/debug-report.md。第一次进入调试时从 references/debug-report-template.md 创建，后续每次新的调试事件在同一个文件里追加一个 session 块；不要改 skill 目录里的模板文件。
prd.md 自检命令或测试命令）。<task-dir>/debug-report.md。按代价从低到高，命中即停：
输出：把范围缩小到"具体文件 + 具体行/变量"，不再泛泛说"哪里有问题"。
我认为根因是 X（具体到变量/分支/契约）。prd.md 自检命令全集，确认没引入新的红（无回归）。check.jsonl 记一条回归点（{"file":"<回归测试或风险点>","reason":"<它保护的行为>"}），并考虑补一个回归测试。trellis-implement-tdd-zh 失败的那一步继续。references/debug-protocol.md —— 4 步脚本的判据细节、三招定位法与反模式，开始调试前读取。references/debug-report-template.md —— <task-dir>/debug-report.md 的只读模板；调试过程中全程更新任务目录下的固定文件。