用途:该技能用于在六阶段工作流的第4阶段“规划(Planning)”中,从已完成的规格说明(specification)启动一次规划会话,目标是产出“如何做”——阶段、任务和验收标准,而非直接写代码或进入实现。
主要能力与流程:
- Step 0 强制运行迁移:调用 /migrate 技能并评估输出;若有文件更新,停止并等待用户通过 git diff 等确认后再继续;若无更新则进入下一步。
- Step 1 发现状态:执行 .claude/skills/start-planning/scripts/discovery.sh 获取 YAML 输出,解析规格与计划信息,包括 feature、crosscutting、counts(feature_ready、feature_with_plan、feature_implemented 等)以及 state.scenario。仅使用该脚本进行发现,不额外运行 ls、cat 等命令。
- Step 2 按场景路由:no_specs 时提示先运行 /start-specification 并终止;nothing_actionable 时展示状态;has_options 时展示可选规格或可续接计划。
- Step 3 加载 display-state.md 展示工作流状态与选项。
- Step 4 按计划状态路由:无计划则收集上下文,已有计划则直接进入调用。
- Step 5 收集补充上下文,提示用户输入 c/continue 或提供优先级、约束等新信息,并等待回应。
- Step 6 加载 cross-cutting-context.md 展示横切上下文。
- Step 7 保存会话书签后加载 invoke-skill.md 并调用技术规划技能,书签命令为:.claude/hooks/workflows/write-session-state.sh "{topic}" "skills/technical-planning/SKILL.md" ".workflows/planning/{topic}/plan.md"。
使用方式与限制:需在 Claude 相关环境中安装该技能,并依赖 .workflows/specification/ 下已完成的规格;没有规格时无法规划。技能强调零输出规则:除非步骤明确要求显示内容,否则不要叙述处理过程。每一步完成后须停止等待用户响应,不得跳过或合并步骤。规划阶段只创建计划,不进入实现或编写代码。