Implementation Ticket

AI 实施任务单模板

需求通过开工自检和任务拆分之后,把目标、输入、范围、影响面、实施步骤、验收、回滚和交接写成一张任务单。这样换 Codex、换 AI agent 或换开发者,也能直接接着做。

复制后怎么用

把这张任务单填好后,直接交给 AI agent。它应该先读上下文,再按任务单改文件、跑验证、写交接,而不是重新问一遍项目要做什么。

这张任务单适合主站迭代、在线工具、小程序、Java 后端、LiteMall 二开和服务器部署。没有填清的部分,就代表还不能稳定开工。

任务单预览

下面是复制按钮生成的 Markdown。真实项目里,把空白项填成具体页面、文件、接口、命令和验收结果。

# AI 实施任务单

## 1. 目标和背景

- 项目名称:
- 产品类型:小程序 / Java 后端 / 独立站和在线工具 / LiteMall / 服务器部署 / 其他
- 这批要交付什么:
- 成功信号:用户或管理员完成什么动作就算可用
- 当前状态:只有想法 / 已有代码 / 已有服务器 / 已部署但有问题 / 生产系统

## 2. 输入资料

- 需求包链接或文本:
- 开工自检结果:
- 需求示例参考:
- 已有仓库、分支、文件路径:
- 截图、报错、接口文档、服务器状态:
- 缺失资料和不确定点:

## 3. 范围边界

- 首版范围:
- 暂不做范围:
- 本批不能触碰的边界:密钥、生产数据、LiteMall 公开链接、支付配置、报价页等
- 风险和前置条件:
- 需要用户手动完成的动作:

## 4. 影响面

- 会改的页面和路由:
- 会改的组件和数据源:
- 会改的接口、数据库、环境变量或部署配置:
- 需要新增或更新的测试:
- 需要同步的文档、sitemap、changelog、HANDOFF:

## 5. 实施任务

- 任务 1:读取上下文并确认范围
- 任务 2:实现最小闭环
- 任务 3:补边界、异常和移动端体验
- 任务 4:补测试、文档和交接记录
- 任务 5:提交并给出推送部署命令

## 6. 验收和验证

- 必须运行的命令:npm run lint / npm run test:unit / npm run build / 其他
- 必须检查的页面或接口:
- 移动端宽度检查:
- 部署验证:
- 不能通过时的处理方式:

## 7. 回滚和安全

- 涉及数据库或生产配置前的备份方式:
- 回滚命令或旧版本路径:
- 敏感信息处理方式:
- 哪些动作必须停止并等待用户确认:

## 8. 交接记录

- 完成后要更新的文件:HANDOFF.md、docs/ai-execution-plan.md、changelog 等
- 最终提交信息:
- 验证结果:
- 残留风险:
- 下一步触发条件:

## 9. 质量检查

- 每个任务都能指向具体文件、页面、接口、数据或命令。
- 首版范围和暂不做范围没有混在一起。
- 验收标准能被另一个 AI 或开发者复现。
- 部署、数据库、密钥和生产环境都有停止规则或回滚说明。
- 任务结束后必须更新 HANDOFF 和执行计划,不能只提交代码。

## 10. 停止规则

- 需求自检没有通过时,先补缺口,不直接写代码。
- 涉及密钥、Token、后台账号、生产数据库和支付配置时,不能写入公开仓库。
- LiteMall 域名、公开入口和小程序 API 变更必须先复查 DNS、HTTPS、后台 401 边界和回滚方案。
- 不能把随机工具、公开报价页或大范围重构混进实施任务。
- 部署或数据库改动没有备份和回滚方案时,不能进入生产执行。

任务单结构

每一段都要能帮助下一位 AI 判断该做什么、哪里不能碰、怎么验证和怎么交接。

任务单字段

1. 目标和背景

项目名称:
产品类型:小程序 / Java 后端 / 独立站和在线工具 / LiteMall / 服务器部署 / 其他
这批要交付什么:
成功信号:用户或管理员完成什么动作就算可用
当前状态:只有想法 / 已有代码 / 已有服务器 / 已部署但有问题 / 生产系统
任务单字段

2. 输入资料

需求包链接或文本:
开工自检结果:
需求示例参考:
已有仓库、分支、文件路径:
截图、报错、接口文档、服务器状态:
缺失资料和不确定点:
任务单字段

3. 范围边界

首版范围:
暂不做范围:
本批不能触碰的边界:密钥、生产数据、LiteMall 公开链接、支付配置、报价页等
风险和前置条件:
需要用户手动完成的动作:
任务单字段

4. 影响面

会改的页面和路由:
会改的组件和数据源:
会改的接口、数据库、环境变量或部署配置:
需要新增或更新的测试:
需要同步的文档、sitemap、changelog、HANDOFF:
任务单字段

5. 实施任务

任务 1:读取上下文并确认范围
任务 2:实现最小闭环
任务 3:补边界、异常和移动端体验
任务 4:补测试、文档和交接记录
任务 5:提交并给出推送部署命令
任务单字段

6. 验收和验证

必须运行的命令:npm run lint / npm run test:unit / npm run build / 其他
必须检查的页面或接口:
移动端宽度检查:
部署验证:
不能通过时的处理方式:
任务单字段

7. 回滚和安全

涉及数据库或生产配置前的备份方式:
回滚命令或旧版本路径:
敏感信息处理方式:
哪些动作必须停止并等待用户确认:
任务单字段

8. 交接记录

完成后要更新的文件:HANDOFF.md、docs/ai-execution-plan.md、changelog 等
最终提交信息:
验证结果:
残留风险:
下一步触发条件:

质量检查

每个任务都能指向具体文件、页面、接口、数据或命令。
首版范围和暂不做范围没有混在一起。
验收标准能被另一个 AI 或开发者复现。
部署、数据库、密钥和生产环境都有停止规则或回滚说明。
任务结束后必须更新 HANDOFF 和执行计划,不能只提交代码。
Contact

任务单填完整,再交给 AI 实施

实施任务单不是额外文档负担,而是让任何 AI agent 都能知道目标、范围、验证、回滚和交接方式。

刘鸡血 微信二维码微信扫码添加