| name | frontend-plan |
| description | Use when turning docs/vX.Y.Z/design/*.md into TDD implementation plans for a versioned frontend iteration. |
| disable-model-invocation | true |
前端计划
目标
基于 design 完成最小、有序、可验证 TDD plan，作为实现边界
输入
| 路径 | 必需 | 说明 |
|---|
docs/technical-architecture.md | 是 | 技术栈、测试命令、约定 |
docs/vX.Y.Z/prd/summarized/*.md | 是 | 验收、边界 |
docs/vX.Y.Z/design/*.md | 是 | 方案、文件 |
| 代码库 | 是 | 路径、复用、测试位置 |
缺必需项则停止
输出
调用契约与要求
- 调用契约见
frontend-iteration/references/orchestrated-invocation.md
- Agent 沟通风格见
frontend-iteration/references/agent-communication-style.md
- 只写 TDD 计划，不做其它
工作流
- 读
docs/technical-architecture.md：构建、测试、目录、代码风格
- 读 summarized、design；状态按契约
- 探路径；校正 design 文件与测试位置
- design → TDD task：RED → GREEN → REFACTOR → VERIFY
- 测试矩阵参考
frontend-test → test-writing-guide
- 完成检查
- 摘要：任务、文件边界、命令、风险；确认按契约
规则
- 最小任务：只覆盖 design 已确认方案；不加 design 外抽象/重构/功能
- 文件边界：精确路径；未知先探；仍不确定 → 待确认问题，不猜
- 可执行粒度：每 task 独立完成+验证；过大拆小，过细合并
- TDD 内置：行为改动先失败测试；无法 TDD 须说明
- 顺序明确：标依赖；可并行可注；默认顺序
- 不重新设计：design 缺口 → 停，回
frontend-design；plan 不暗改方案
- 不写代码
- 状态门禁：见
frontend-iteration/references/orchestrated-invocation.md；阻塞待确认问题 → DRAFT/BLOCKED
任务结构
每 task 至少：
| 字段 | 要求 |
|---|
| 目标 | 一句话 |
| 文件 | 新增/改/测路径 |
| 步骤 | 2–6 动作 |
| 验证 | 命令或手动点 |
| 依赖 | 前置 task；无写「无」 |
行为 task 还须：
| 阶段 | 要求 |
|---|
| RED | 最小失败测试 + 预期失败原因 |
| GREEN | 最小生产代码过测 |
| REFACTOR | 不改行为清理；测试仍过 |
| VERIFY | 跑命令；记通过条件 |
常见场景
| 场景 | 处理 |
|---|
| 多页 design | 每页独立 plan；共享放最早依赖 task |
| 只改组件 | 聚焦改+测；不新目录 |
| API 未就绪 | 单独 API task（占位 + TODO(vX.Y.Z): 接口联调待定）；页面 task 依赖；见 frontend-iteration/references/api-integration-guide.md |
| E2E 贵 | 只关键路径；余单元/集成 |
| design 有待确认问题 | 受影响 task 不生成；列阻塞 |
| 超最小改动 | 停；回 design |
| design 更新 | plan、步骤 4 进度、test-report、review → STALE 或重跑 |
完成检查
文件路径解析
读 skill / reference 时按序尝试（命中即用）：
| 资源 | 路径 1（npx skills add） | 路径 2（源码） |
|---|
本子 SKILL.md 目录 | .agents/skills/frontend-plan/ | skills/frontend-plan/ |
| 编排 references | .agents/skills/frontend-iteration/references/<file> | skills/frontend-iteration/references/<file> |
| 其他 references | .agents/skills/<name>/references/<file> | skills/<name>/references/<file> |
| 样例 | .agents/skills/frontend-iteration/examples/ | skills/frontend-iteration/examples/ |
参考
