planning

Planning - 实施规划与步骤分解

前置协议

强制触发规则

触发时机：prompt-enhancer 完成需求细化后（强制）

触发条件：

• ✅ 已有明确的需求和方案
• ✅ 需要实施规划和步骤分解
• ✅ 复杂任务（需要多个步骤完成）

例外情况：

• 简单任务（单步即可完成）
• 用户明确表示"直接开始"

---

依赖检查

前置依赖：prompt-enhancer

检查内容：

• 检查工件文件：memory/artifacts/prompt-enhancer/
• 确认已有明确的需求和选定方案
• 如果无前置工件，需先执行 prompt-enhancer

---

与 goal-oriented 的协作

触发来源：goal-oriented skill 强制调用

触发流程:

goal-oriented 创建目标
    ↓
调用 prompt-enhancer（需求细化）
    ↓
生成需求方案工件
    ↓
调用 planning（实施规划）
    ↓
读取需求方案工件 → 生成实施计划 → plan-review
    ↓
生成实施计划工件
    ↓
传递给 execution 阶段
    ↓
任务完成后 → experience-manager 经验沉淀

工件接收:

• goal-oriented 会写入工件到 memory/artifacts/prompt-enhancer/
• planning 自动检测并读取最新工件

---

工件传递机制

输入工件（来自 prompt-enhancer）

工件路径: memory/artifacts/prompt-enhancer/result-{timestamp}.json

工件格式:

{
  "skill": "prompt-enhancer",
  "version": "2.0.0",
  "requirement": {
    "original": "用户原始需求",
    "refined": {
      "type": "功能开发|重构|优化",
      "core_features": ["功能1", "功能2"],
      "target_users": "目标用户",
      "platform": "平台",
      "tech_stack": ["技术1", "技术2"],
      "success_criteria": ["标准1", "标准2"],
      "timeline": "时间线"
    }
  },
  "solution": {
    "selected": "选定方案",
    "reasons": ["理由1", "理由2"],
    "alternatives": [
      {
        "name": "备选方案1",
        "pros": ["优势"],
        "cons": ["劣势"]
      }
    ]
  }
}

读取方式:

# 自动检测最新的 prompt-enhancer 工件
PROMPT_ENHANCER_ARTIFACT=$(ls -t memory/artifacts/prompt-enhancer/*.json | grep -v latest.json | head -1)

if [ -n "$PROMPT_ENHANCER_ARTIFACT" ]; then
  echo "✅ Found prompt-enhancer artifact: $PROMPT_ENHANCER_ARTIFACT"
  # Read artifact content using Read tool
else
  echo "❌ No prompt-enhancer artifact found"
  echo "⚠️ Must execute prompt-enhancer before planning"
fi

---

输出工件（传递给后续技能）

工件路径: memory/artifacts/planning/result-{timestamp}.json

工件格式: 见 "步骤8：生成工件"

传递机制:

• 创建工件文件
• 创建 latest.json 符号链接
• 后续技能可自动检测 latest.json

---