用途:在已有代码库中快速产出实施计划,不进行调研、不写任何代码。适用于需要先明确改动范围与步骤、再进入实现的开发任务。
主要能力:先读目标区域代码、用 grep/glob 搜索 3 个以上相似模式并引用 file:line 证据;在存在 .code-graph/graph.db 时运行 python .claude/scripts/code_graph trace <file> --direction both --json 追踪依赖;把非平凡任务的分析写入 .ai/workspace/analysis/ 并在实现前重读。产出 plan.md 与 phase-XX-*.md,plan.md 带 YAML frontmatter(title、description、status、priority、effort、story_points、branch、tags、created),每个阶段包含 Context links、Overview、Key Insights、Requirements、Architecture、UI Layout、Related code files、Implementation Steps、Todo list、Success Criteria、Risk Assessment、Security Considerations、Next steps。用修正斐波那契估算 story_points(1/2/3/5/8/13/21),SP>8 应拆分;复杂度评分 >=6 必须分解为多阶段,每阶段 ≤5 个文件、≤3 小时,按 plan→implement→review→fix→verify 循环。每个阶段必须含 ## Test Specifications 与 TC-{FEAT}-{NNN} 编号。
使用方式:检查 Plan Context,复用活动计划或按命名规范新建目录并运行 node .claude/scripts/set-active-plan.cjs {plan-dir};阅读 backend-patterns-reference.md、frontend-patterns-reference.md、project-structure-reference.md 分析代码库;创建计划后必须运行 /plan-review,并用 AskUserQuestion 让用户确认。不要使用 EnterPlanMode 工具,不要实现代码。
限制:若检测到无实际代码目录与清单文件(greenfield),会重定向到 /plan-hard。修复问题时应追踪完整数据流并在拥有不变量的最低层修复,而非崩溃点。资料未提供具体收费、平台支持范围与效果数据。