开发策略描述
1. 目标
本策略用于 运用 coding agent （亦称AI编码、AI编程、AI coding、AI agent coding）完成跨岗位协作下的软件交付。核心目标是：
在长期、多步骤执行过程中，通过 完整上下文 与 完整逻辑约束，确保执行过程 可控、结果 可验证、阶段之间 可传递，并在跨迭代情况下仍可稳定维护。也即是在团队协作下的长期Agent coding迭代模式。
2. 三要素视角
对 agent 的运用，归纳为三要素：
- 模型
- 上下文工程
- 逻辑演绎
风险主要来自：
- 上下文构筑不完整
- 逻辑演绎路径不稳定
将导致多轮执行不可控、结构发散、索引失效。
3. coding agent 的关键路径（3 条 = 1 条）
为确保执行正确性，coding agent 的运用路径总结为：
- 构筑索引
- 合理拆解
- 最小闭环
本质为：
通过索引保证“可遍历”，
通过拆解保证“可判定”，
通过闭环保证“可验证”。
4. 分阶段运用方式
三个阶段：
- 产品设计
- 开发
- 测试
流程原则：
- 从同一需求原点出发
- 每阶段形成关键产出
- 当前阶段产出成为下一阶段输入
- 每一步均包含完整上下文
5. 跨岗位信息传递规范
必须以文本为载体：
- 产品设计与原型（文本 / 静态 HTML）
- 开发设计与计划（文本）
- 测试用例（文本）
禁止图片作为定义依据。
6. 长期维护机制
6.1 跨迭代策略
- 以“迭代”为单位堆叠文档
- 不覆盖历史版本
- 每迭代生成新的 Index
- 旧任务标记为“废弃/沿用/变更”
目录示例：
docs/
v1/
v2/
v3/
6.2 索引失效处理
索引可能因：
- 文件改名
- 任务重构
- 页面删除
而失效。
处理原则：
- 索引不写行号
- 索引不写物理路径
- 使用任务编号作为锚点
6.3 索引自动维护原则
- 人维护任务内容
- Coding agent 扫描任务生成 Index
- 每次迭代自动重建映射表
- 索引可丢弃，可重建
范本 1：任务索引（Index.md）
# 项目任务索引
> 目的：确保无遗漏、可遍历、可重建
> 本文件仅用于核对与映射。
---
## 一、阶段 × 模块矩阵
| 阶段 | 设计 | 小程序端 | PC端 | 后端 | 测试 |
|------|------|----------|------|------|------|
| 框架搭建 | T-02-01 | T-03-01 | T-04-01 | T-05-01 | — |
| 一阶段 | T-02-完成 | T-03-02 | T-04-02 | T-05-02 | T-06-01 |
---
## 二、需求编号 ↔ 任务映射
| 需求编号 | 对应任务编号 |
|----------|--------------|
| R-01 | T-03-02 / T-05-02 |
| R-02 | T-03-03 |
---
## 三、功能闭环覆盖
| 闭环编号 | 前端 | 后端 | 管理端 |
|----------|------|------|--------|
| F-01 | T-03-02 | T-05-02 | T-04-02 |
---
## 四、完整性检查
- [ ] 所有需求均有任务
- [ ] 所有页面均有任务
- [ ] 所有闭环均覆盖
- [ ] 测试与阶段对应
范本 2：任务（Task.md）
# T-XX-任务名称
---
## 一、任务目标
定义边界与目标。
---
## 二、输入
- 来源任务编号：
- 来源需求编号：
- 来源文档：
---
## 三、约束
- 不可变更：
- 必须遵守：
- 依赖接口/模型：
---
## 四、产出
- 文件：
- 页面：
- 接口：
- 数据模型：
---
## 五、验收
- 测试编号：
- 验证方式：
---
## 六、状态
- [ ] 完成
- [ ] 已进入下游任务
范本 3：原型文档（Prototype.md）
# 页面名称
> 描述结构与跳转，不描述实现。
---
## 一、页面结构
1. 顶部区域
2. 主体区域
3. 功能区域
4. 底部区域
---
## 二、模块定义
### 模块A
- 功能说明：
- 触发行为：
- 跳转目标：
- 对应任务编号：
---
## 三、页面跳转关系
| 当前页面 | 操作 | 目标页面 |
|----------|------|----------|
---
## 四、展示规则
- 空状态：
- 加载状态：
- 错误状态：
---
## 五、索引引用
- 需求编号：
- 任务编号：
以上纯个人原创，如有雷同，纯属巧合。
欢迎大家留言讨论。
