Task Splitting

AI 实施任务拆分

需求通过开工自检以后,下一步不是直接让 AI 写代码,而是把上下文、范围、影响面、实现闭环、验证和交接拆清楚。这样换任何 AI agent 都能按任务继续推进。

这页解决什么

开工自检回答“需求够不够”,任务拆分回答“够了以后怎么做”。每一批开发都要先确认上下文和范围,再列影响面,最后按闭环实现、验证和交接推进。

它适合主站迭代、在线工具、Java 后端、服务器部署。不同产品类型可以按下面的分层清单展开。

通用拆分顺序

所有产品类型都先走这 6 步。差别只在每一步里具体影响哪些层。

1

读取上下文

先确认当前目标、仓库状态、最近提交、需求包、自检结果和上线保护规则。

输出物

当前要交付的产品类型和首版目标。
必须读取的文件、页面、数据源和内部文档。
当前不可越过的限制,例如 密钥、报价和生产数据。

检查点

已运行 git status 和 git log。
已阅读 HANDOFF.md、docs/ai-execution-plan.md 和相关需求包。
已确认是否存在用户未提交或未说明的改动。
已确认这批工作是否需要用户提供凭据、素材或外部审批。
2

锁定范围

把首版范围、暂不做范围、验收标准和部署限制写成实施边界。

输出物

本批必须完成的功能清单。
明确不做的功能和不能触碰的生产边界。
可交付的验收动作,而不是抽象描述。

检查点

首版范围和暂不做范围分开。
每个功能都有可观察结果。
风险和缺失信息已写入任务说明。
没有把后续阶段功能偷偷塞进本批。
3

映射影响面

先列出会动到的路由、组件、数据、接口、数据库、环境变量、测试和部署文件。

输出物

受影响文件、模块和页面清单。
新增或变更的数据结构、接口、配置和文档。
需要补的测试、验证命令和回滚点。

检查点

能说明为什么要改这些文件。
没有把无关重构混进本批。
共享数据源、sitemap、changelog 和 HANDOFF 是否需要同步已判断。
涉及生产环境或数据时已先列出备份和回滚路径。
4

按闭环实现

优先做一条能跑通的纵向闭环,再补边界、异常、文档和体验。

输出物

一个可演示的核心流程。
与核心流程匹配的数据、页面、接口、测试和文档。
已记录的未完成项和下一批任务。

检查点

先跑通最小闭环,再扩展列表、配置和边界。
逻辑可测试时优先放入 lib 或后端服务层。
UI、接口、数据和部署记录保持一致。
没有为了“顺手”增加随机功能。
5

验证交付

按单元测试、构建、页面访问、移动端、部署和产品验收清单逐项验证。

输出物

已运行的命令和结果。
本地或线上页面检查记录。
未覆盖风险和残留问题。

检查点

npm run lint、npm run test:unit、npm run build 按需要执行。
新增公开路由已进入 sitemap。
移动端没有横向溢出、按钮遮挡和长文案破版。
没有公开密钥、后台账号、生产数据。
6

记录交接

结束前把改动、验证、风险、下一步和提交号写清,让下一位 AI 可以直接继续。

输出物

HANDOFF.md 和执行计划的最新状态。
changelog 中的公开变化记录。
提交信息、验证结果和推送部署命令。

检查点

已经提交一个清晰批次。
工作区状态明确。
下一步触发条件写清楚。
用户只需要推送和部署,不需要重新解释这批做了什么。

按产品类型拆任务

同一套方法,在不同产品里要落到不同层。先选产品类型,再按层拆任务和验证。

Java 后端实施拆分

先拆数据模型、权限、接口契约、服务逻辑、文档、部署和日志。

对应需求包

数据和权限

表结构、索引、状态、软删除、迁移和回滚。
角色、菜单、按钮权限和数据隔离。

接口和服务

Controller、Service、Mapper、DTO、错误码和校验。
上传、导出、定时任务、第三方接口按风险拆分。

联调和部署

Swagger/Postman、测试账号、样例 JSON 和联调记录。
JDK、MySQL、Redis、Nginx、日志和健康检查。

验收重点

核心接口包含正常、异常、无权限和状态不允许场景。
数据库脚本、环境变量和部署命令可复现。
日志、健康检查和回滚说明已记录。

独立站和在线工具实施拆分

先拆信息架构、工具逻辑、页面组件、SEO、测试、移动端和发布链路。

对应需求包

数据和内容

站点导航、页面清单、内容数据源、changelog 和 sitemap。
工具公式、示例输入输出、默认值和边界条件。

页面和组件

App Router 页面、复用组件、表单控件和结果展示。
桌面和移动端布局、长中文、按钮和表格溢出。

SEO 和验证

metadata、canonical、结构化数据、RSS 和搜索验证。
单元测试、构建、本地页面字符串和移动端宽度检查。

验收重点

工具逻辑有测试,页面能构建访问。
新增公开路由进入 sitemap 和 changelog。
320px 或 360px 宽度没有横向溢出。

服务器部署实施拆分

先拆备份、环境、域名、反向代理、进程、日志、验证和回滚。

对应需求包

前置保护

确认服务器权限、运行时、端口、环境变量、DNS、HTTPS 和防火墙。
数据库迁移、覆盖发布和生产变更前先备份。

执行上线

构建、上传、启动、Nginx、证书、进程守护和健康检查。
客户控制台动作和 AI 可执行命令分开记录。

验证回滚

检查端口、日志、健康接口、核心业务接口和监控。
写清旧版本目录、旧配置、数据库恢复和回滚命令。

验收重点

部署命令、验证 URL、日志路径和重启方式已记录。
数据库备份和恢复命令可执行。
生产环境没有暴露数据库、Redis 和后台管理端口。

实施任务单字段

后续真实需求交给 AI 前,可以按这些字段组织成一张实施任务单。

目标:这批要交付什么,成功信号是什么。
输入:需求包、自检结果、参考示例、截图、仓库、服务器或现有报错。
范围:首版范围、暂不做范围、风险和缺失信息。
影响面:页面、组件、接口、数据、环境变量、测试、文档和部署。
任务:按上下文、范围、影响面、实现、验证、交接拆成可执行步骤。
验收:需要运行的命令、页面检查、移动端检查、接口检查和部署检查。
回滚:涉及部署、数据库或生产配置时的退回路径。
交接:文件变更、验证结果、已知风险、下一步和提交号。
Contact

自检通过后,再拆实施任务

任务拆得越清楚,AI 越容易稳定完成:知道改哪里、怎么测、怎么部署、怎么回滚,也知道哪些边界不能碰。

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