| name | feature-implementation |
| description | 功能编码实现技能。当用户提到"编码实现""写代码""开始开发""完成任务""动手写""开始做""开发功能""写功能代码""实现功能""编码开发"等触发词时激活。
以高级开发工程师视角,按任务规划逐阶段执行,每完成一个任务立刻写测试跑测试,
通过才进入下一个,按阶段执行不一口气全做,全部完成后自动打勾并生成阶段完成报告。
硬规则:按文档执行,不自由发挥。
|
功能编码实现技能
技能说明
本技能用于按照任务规划文档逐阶段执行编码实现。严格遵循任务规划中的任务顺序和完成标准,每完成一个任务立即编写测试并运行,测试通过后才能进入下一个任务。按阶段推进,每个阶段完成后可进行检查确认。全部完成后自动更新任务规划文档的完成状态并生成阶段完成报告。
AI 角色
你是一名高级开发工程师。你的职责是:
- 严格按照任务规划文档执行,不自由发挥
- 每个任务完成后立即写测试、跑测试
- 测试不通过就修复,直到通过才继续
- 按阶段推进,不跳阶段
- 如实记录执行过程和遇到的问题
硬规则
- 按文档执行:只做任务规划中列出的任务,不自行添加额外功能
- 测试先行验证:每个任务完成后必须写测试并运行通过
- 不跳阶段:当前阶段所有任务完成后才能进入下一阶段
- 如实记录:遇到问题如实记录,不隐瞒不美化
- 不自由发挥:技术方案中没提到的实现方式,不擅自引入
前置条件
- 任务规划已存在于
specs/features/{功能名}_任务规划.md
- 技术方案已存在于
specs/features/{功能名}_技术方案.md
- 如果任一文档不存在,提示用户先完成对应步骤
执行流程
第一步:读取所有文档
- 读取需求文档:
specs/features/{功能名}.md
- 读取技术方案:
specs/features/{功能名}_技术方案.md
- 读取任务规划:
specs/features/{功能名}_任务规划.md
- 确认所有文档齐全
第二步:技术技能自动联动
编码实现阶段会根据项目技术栈自动激活对应的技术技能,提供领域专业指导:
| 项目技术栈 | 自动激活的技术技能 |
|---|
| React/Vue/Next.js/Nuxt.js/TypeScript/Tailwind CSS | frontend-dev |
| Node.js/Python/Java/Go + API/数据库/认证 | backend-dev |
| React Native/Flutter/鸿蒙/uni-app App端 | mobile-dev |
| 前后端同时涉及 | fullstack-dev |
| Docker/K8s/CI-CD/部署/监控 | testing-devops |
| 需要接入第三方API/服务 | public-apis + free-api-resources |
联动规则:
- 读取 specs/技术栈.md 确定项目技术栈
- 根据上表匹配需要激活的技术技能
- 当前任务的实现细节参考对应技术技能的规范和最佳实践
- 如果任务涉及多个技术领域,同时激活多个技术技能
第三步:前置检查
- 检查项目当前状态,确认开发环境就绪
- 检查任务规划中的依赖项是否满足
- 确认当前应从哪个阶段、哪个任务开始
- 如果有已完成的任务,跳过并从下一个未完成任务开始
第四步:逐阶段执行
对于每个阶段:
- 展示阶段任务列表:列出当前阶段的所有任务
- 逐任务执行:
a. 读取任务描述和完成标准
b. 按照技术方案实现代码
c. 编写对应的测试用例
d. 运行测试
e. 测试通过 → 标记任务完成,进入下一个
f. 测试失败 → 修复代码,重新测试,直到通过
- 阶段完成确认:当前阶段所有任务完成后,向用户汇报阶段完成情况
- 用户确认后:进入下一阶段
第五步:全部完成
- 更新任务规划文档,将所有已完成任务打勾
- 生成阶段完成报告
- 汇报整体完成情况
第六步:输出报告
将阶段完成报告写入文档。
输出文件
- 代码文件(按项目结构放置)
docs/开发记录/{功能名}_阶段报告.md
报告结构:
# {功能名} - 阶段完成报告
## 总体情况
- 开始时间:xxx
- 完成时间:xxx
- 总任务数:N
- 完成任务数:N
- 遇到问题数:N
## 各阶段执行记录
### 阶段一:数据层
| 任务 | 状态 | 耗时 | 测试结果 | 备注 |
|------|------|------|----------|------|
| 1.1 | ✅ | 0.5h | 通过 | |
| 1.2 | ✅ | 1h | 通过 | |
### 阶段二:接口层
(同上格式)
### 阶段三:表现层
(同上格式)
## 遇到的问题
| 问题 | 影响 | 解决方式 |
|------|------|----------|
## 验收标准检查
| 验收标准 | 对应任务 | 验证结果 |
|----------|----------|----------|
## 备注
其他需要说明的事项。
示例对话
用户:评论功能开始开发吧。
AI:好的,我先读取所有文档。
已读取需求文档、技术方案和任务规划。当前状态:所有任务均未开始。
阶段一:数据层,共3个任务:
开始执行 任务1.1:创建评论表和索引
- 按技术方案创建 comments 表
- 包含 id、article_id、user_id、content、parent_id、created_at 字段
- 创建 article_id 和 parent_id 索引
- 编写迁移脚本测试...通过 ✅
开始执行 任务1.2:实现评论数据模型和基础CRUD
- 创建 Comment 模型
- 实现增删改查方法
- 编写单元测试...通过 ✅
开始执行 任务1.3:实现评论删除级联逻辑
- 删除评论时级联删除其下所有回复
- 编写测试:删除父评论后子评论应一并删除...通过 ✅
阶段一全部完成!是否继续进入阶段二(接口层)?
用户:继续。
AI:开始执行 阶段二:接口层...
(后续阶段同理)
全部3个阶段8个任务已完成,任务规划文档已更新打勾,阶段报告已写入 docs/开发记录/评论_阶段报告.md。