用途:plan-hard 属于规划类技能,目标是在实施前完成研究、代码库分析与分阶段实施计划编写,本身只做规划,不执行代码改动。
主要能力:支持并行 researcher 子代理研究不同方面(每个最多 5 次工具调用),分析代码库并查找项目参考文档(patterns-reference、project-structure、architecture、adr),由 planner 子代理生成 plan.md 与 phase-XX 文件。计划要求每个阶段包含测试规格(TC-{FEAT}-{NNN} 编号),并映射功能需求到测试用例。
关键约束:强调批判性思维与反幻觉,任何结论需 file:line 证据且置信度大于 80% 才行动;删除组件前检查下游引用;修改后追踪完整依赖链;调试时先判断责任层,在拥有不变量的最低层修复;变更前先理解现有代码(HARD-GATE);跨服务场景需检查事件生产者、消费者、Saga、共享契约与数据归属。
估算框架:使用故事点(修正斐波那契)与人天估算,区分传统与 AI 辅助两种口径,输出 story_points、complexity、man_days_traditional、man_days_ai 到计划前置元数据。
使用方式:先做预检查判断是否存在活动或建议计划,创建目录后运行 node .claude/scripts/set-active-plan.cjs {plan-dir};随后研究、分析代码库、生成计划,创建后运行 /plan-review,并询问用户确认。可选通过 /plan-validate 进行验证访谈。若检测到无实际代码目录与清单文件,会自动切换到 greenfield 模式,跳过代码库分析,改用市场调研与业务评估,并委派 solution-architect 代理做架构决策。
限制:仅规划不实现;研究报告中不超过 150 行、plan.md 不超过 80 行;每阶段不超过 5 个文件、不超过 3 小时;新引入技术或库需检索前 3 个替代方案并让用户确认。具体脚本路径、代理名称与配置项以实际项目为准,资料未提供完整安装命令与收费信息。