base-goal-executionlisted

# Goal 驱动执行 ## 用途 当 AI 制定计划（Plan）或执行已有计划时，本技能定义从"目标定义 → 任务拆解 → 逐步实现 → 质量门禁 → 交付确认"的完整闭环。 适用于 Qoder Plan 文件、手写任务清单、或任何需要多步执行的工程任务。 ## 核心理念 > **每个任务必须有明确的验收标准，每次执行必须有可观测的进度，每个失败必须有结构化的恢复策略。** 借鉴来源： - [goal-workflow](https://github.com/smallnest/goal-workflow) 的 Issue→Goal→Review→Ship 闭环 - Codex Goal 功能的目标驱动 + 检查点恢复模式 - Qoder 原生 Plan 体系的 `.md` 计划文件 ## 触发条件 以下任一场景应自动激活本技能： 1. 用户要求"制定计划"、"做一个方案"、"规划一下" 2. AI 通过 `CreatePlan` 工具生成了计划文件 3. 用户要求执行某个已有的计划文件（如 Qoder 缓存的 `.md` 计划） 4. 用户说"继续上次的任务"、"恢复执行" 5. 任何涉及 3 个以上步骤的工程任务 ## 执行框架 ### Phase 0: Goal 定义（制定计划时） 制定计划时，必须包含以下结构： ```markdown # [任务名称] ## 目标（Goal） 一句话描述最终交付物。 ## 验收标准（Acceptance Criteria） - [ ] AC-1: 具体可验证的条件 - [ ] AC-2: 具体可验证的条件 - [ ] ... ## 任务拆解（Tasks） 按依赖拓扑排序，每个任务包含： - 任务 ID 和标题 - 输入 / 输出 - 验收标准（至少 1 条） - 依赖关系（如有） ## 风险与约束 - 已识别的风险点 - 外部依赖或前置条件 ``` **Goal 定义质量门禁**： - 验收标准必须可验证（能运行命令、检查文件、观察行为） - 每个任务的粒度应在单次会话中可完成 - 依赖关系必须显式声明，不允许隐式依赖 ### Phase 1: 前置检查（Pre-flight） 执行前验证： | 检查项 | 动作 | |--------|------| | 计划文件存在且完整 | 读取计划文件，确认 Goal + AC + Tasks 齐全 | | 工作区状态清洁 | 检查是否有未提交变更可能冲突 | | 依赖可用 | 确认所需的 CLI、MCP、技能、文件可访问 | | 无循环依赖 | 验证任务依赖图无环 | 任一检查失败 → 停止执行，报告问题，等待用户确认。 ### Phase 2: 逐步执行（Execution） 每个任务的执行循环： ``` 读取任务 → 分析上下文 → 实现 → 验证 → 标记状态 ``` **任务状态流转**： ``` pending → in_progress → done / failed / blocked / skipped ``` **执行纪律**： 1. **单任务聚焦**：同一时间只执行一个任务，完成后才进入下一个 2. **即时验证**：每个任务完成后立即验证其验收标准，不积攒到最后 3. **进度报告**：每完成一个任务，输出当前进度摘要 4. **变更隔离**：只修改当前任务直接相关的文件，不做"顺便"修改 5. **上下文保持**：执行中如需参考计划文件，重新读取而非依赖记忆 **进度报告格式*