planner

规划器

为多任务项目创建结构化、可供编排器使用的计划。

来源：改编自 am-will 的 codex-skills 工作流模式 配套：用于后续实施的 task-orchestrator 技能

---

快速开始

按以下流程进行：

1. 阶段 0：明确需求（提出最多 5 个有针对性的问题）
2. 阶段 1：研究并了解代码库
3. 阶段 2：制定详细计划，包含冲刺、任务和验收标准
4. 阶段 3：由子 Agent 审查计划
5. 阶段 4：以 Markdown 格式返回计划；仅在用户要求生成可持久保存的产物时才保存文件

---

核心原则

任务原子性

每项任务都必须：

• 原子化且可提交——规模小、相互独立
• 具体且可执行——不能含糊
• 可测试——包含测试或验证方法
• 有明确位置——包含文件路径和代码位置

好坏任务拆分示例

❌ 不佳：“实现第三方登录”

✓ 良好：

• “将登录配置添加到环境变量”
• “安装并配置所需的身份验证包”
• “在 src/routes/auth.ts 中创建登录回调路由处理程序”
• “在登录界面中添加登录按钮”

冲刺结构

每个冲刺都必须：

• 产出一个可演示、可运行、可测试的增量成果
• 在前一个冲刺的工作基础上推进
• 包含清晰的演示／验证检查清单

---

计划模板

# Plan: [Task Name]

**Generated**: [Date]
**Estimated Complexity**: [Low/Medium/High]

## Overview
[Brief summary of what needs to be done and the general approach]

## Prerequisites
- [Dependencies or requirements that must be met first]
- [Tools, libraries, or access needed]
- [Tooling limitations, e.g., browser relay/CDP restrictions]

## Sprint 1: [Sprint Name]
**Goal**: [What this sprint accomplishes]
**Demo/Validation**:
- [How to run/demo this sprint's output]
- [What to verify]

### Task 1.1: [Task Name]
- **Location**: [File paths or components involved]
- **Description**: [What needs to be done]
- **Perceived Complexity**: [1-10]
- **Dependencies**: [Any previous tasks this depends on]
- **Acceptance Criteria**:
  - [Specific, testable criteria]
- **Validation**:
  - [Test(s) or alternate validation steps]

### Task 1.2: [Task Name]
[...]

## Sprint 2: [Sprint Name]
[...]

## Testing Strategy
- [How to test the implementation]
- [What to verify at each sprint]

## Potential Risks
- [Things that could go wrong]
- [Mitigation strategies]

## Rollback Plan
- [How to undo changes if needed]

---

交接

计划就绪后，交接给并行任务执行器：

Please run parallel-task.md against my-plan.md

也可直接调用：

“使用并行子 Agent 执行 plan.md 中所有未受阻的任务。持续循环，直到所有任务完成。”

安全边界

• 除非用户要求生成计划文件，或周边工作流明确需要可持久保存的产物，否则不要保存计划文件。
• 不要为并行任务分配相互重叠的写入范围；如有冲突，必须明确指出。
• 不要臆造代码库上下文不支持的依赖项、验证步骤或完成状态。
• 除非用户明确要求从规划转向实施，否则不要将规划请求转为实施工作。

---

相关内容

• parallel-task — 执行此技能所生成计划的并行任务执行器

改编自 am-will 的 codex-skills planner/parallel-task 提示词。