SuperAPI AI 工具集

start-planning

智能体与模型

查看项目

更新于 10-16 06:23

技能介绍

用途:该技能用于在六阶段工作流的第4阶段“规划(Planning)”中,从已完成的规格说明(specification)启动一次规划会话,目标是产出“如何做”——阶段、任务和验收标准,而非直接写代码或进入实现。

主要能力与流程:

  1. Step 0 强制运行迁移:调用 /migrate 技能并评估输出;若有文件更新,停止并等待用户通过 git diff 等确认后再继续;若无更新则进入下一步。
  2. Step 1 发现状态:执行 .claude/skills/start-planning/scripts/discovery.sh 获取 YAML 输出,解析规格与计划信息,包括 feature、crosscutting、counts(feature_ready、feature_with_plan、feature_implemented 等)以及 state.scenario。仅使用该脚本进行发现,不额外运行 ls、cat 等命令。
  3. Step 2 按场景路由:no_specs 时提示先运行 /start-specification 并终止;nothing_actionable 时展示状态;has_options 时展示可选规格或可续接计划。
  4. Step 3 加载 display-state.md 展示工作流状态与选项。
  5. Step 4 按计划状态路由:无计划则收集上下文,已有计划则直接进入调用。
  6. Step 5 收集补充上下文,提示用户输入 c/continue 或提供优先级、约束等新信息,并等待回应。
  7. Step 6 加载 cross-cutting-context.md 展示横切上下文。
  8. 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/ 下已完成的规格;没有规格时无法规划。技能强调零输出规则:除非步骤明确要求显示内容,否则不要叙述处理过程。每一步完成后须停止等待用户响应,不得跳过或合并步骤。规划阶段只创建计划,不进入实现或编写代码。