S

SDD 任务执行

作者:鹿Sir开发工具v1

SDD(规格驱动开发)工作流的实现阶段技能。读取 docs/tasks/ 中的任务清单,按依赖顺序执行:任务状态流转(TODO → IN_PROGRESS → DONE/BLOCKED)、统一模板提交、任务完成前分类检查清单、以及实现→任务→设计→需求的逆向一致性审查。当用户要求「执行任务清单」「按 tasks 文档开始实现」「SDD 实现阶段」「跑任务并提交」时触发。触发词:任务执行、SDD 实现、任务清单、逆向审查、状态流转、实现阶段。

下载量
411
点赞
99
价格
免费

技能文档

---
name: sdd-task-executing
description: SDD(规格驱动开发)工作流的实现阶段技能。读取 docs/tasks/ 中的任务清单,按依赖顺序执行:任务状态流转(TODO → IN_PROGRESS → DONE/BLOCKED)、统一模板提交、任务完成前分类检查清单、以及实现→任务→设计→需求的逆向一致性审查。当用户要求「执行任务清单」「按 tasks 文档开始实现」「SDD 实现阶段」「跑任务并提交」时触发。触发词:任务执行、SDD 实现、任务清单、逆向审查、状态流转、实现阶段。
title: SDD 任务执行
category: 开发工具
---

# SDD 任务执行

负责 SDD 工作流的实现阶段:

```
requirements-defining → software-designing → task-planning → task-executing
   (docs/requirements/)   (docs/design/)      (docs/tasks/)     (实现)
```

读取 docs/tasks/ 中的任务,逐个实现、更新状态、按模板提交,完成后做逆向一致性审查。

## 技能工作流

### 步骤1:读取任务索引

读取 `docs/tasks/index.md`,识别所有可执行任务:状态为 TODO 且依赖已全部 DONE 的任务。按依赖关系确定本轮可并行与必须串行的任务。

### 步骤2:加载任务详情

读取目标任务的独立任务文件,确认内容:任务描述、验收标准、涉及文件、依赖任务。

### 步骤3:标记开工并提交

任务开始时立即把状态改为 IN_PROGRESS:

- 更新任务文件与 index.md 中的状态
- 提交一次状态变更(使用统一提交模板,见下方「提交规范」)

状态流转:

```
TODO → IN_PROGRESS → DONE
         ↓
      BLOCKED(问题发生时,写明阻塞原因)
```

| 时机 | 状态 | 动作 |
|------|------|------|
| 任务开始 | `IN_PROGRESS` | 更新任务文件与 index.md,提交 |
| 任务完成 | `DONE` | 追加完成摘要,更新状态,提交 |
| 发生问题 | `BLOCKED` | 写明阻塞原因与所需支援 |

### 步骤4:实现任务

按任务描述实现。可并行的任务并行推进;实现方式遵循 docs/design/ 的组件、API 与数据模型设计,不偏离设计文档自创方案。

### 步骤5:核对验收标准

逐条核对任务文件中的验收标准,全部达成才能进入完成流程;有任何一条未达成即视为未完成。

### 步骤6:完成前分类检查清单

标记 DONE 之前,先分析任务内容命中哪些类别,向用户逐项确认对应清单:

**含 UI 变更时**(组件新增/修改、样式、布局):

```text
- [ ] 已在真实浏览器中目视确认
- [ ] 已在目标放置上下文(侧栏/弹窗/整页)中确认布局
- [ ] 需要响应式时已在多个屏宽下确认
```

**含外部系统联动时**(Docker/容器、Git 自动化、外部 API、文件系统操作):

```text
- [ ] 已在真实系统而非 Mock 上确认运行
- [ ] 已确认权限与挂载配置的相互作用
- [ ] 已确认出错时的日志输出与处理
```

**含数据操作时**(数据库、文件读写、集合处理、用户输入):

```text
- [ ] 已确认空数据 / null 时的行为
- [ ] 已确认边界值(0 条、1 条、大数据量)下的行为
```

**含组件复用或迁移时**(组件挪用、重构、公共化):

```text
- [ ] 已确认原上下文与新上下文的差异
- [ ] 已确认尺寸约束与父元素影响
```

**涉及远程仓库时**(推送、PR 创建/更新、CI/CD):

```text
- [ ] 测试覆盖率 80% 以上
- [ ] lint 零错误
- [ ] PR 检查全部通过
- [ ] 包括 nits 在内的评审意见全部解决,无新增意见
- [ ] 所选库与工具无安全类指摘
```

确认方式示例:

```text
【任务完成前检查】

Task 1.3: 用户列表组件的侧栏适配

命中类别:UI 变更、组件复用迁移

[UI 变更]
- [ ] 已在真实浏览器中目视确认
- [ ] 已在侧栏上下文中确认布局
- [ ] 已在多屏宽下确认响应式

[组件复用迁移]
- [ ] 已确认整页 → 侧栏的上下文差异
- [ ] 已确认尺寸约束与父元素影响

以上各项是否都已确认?如有未确认项,请确认后再标记完成。
```

有未确认项时警告并**暂缓标记完成**。

### 步骤7:按模板提交

每个任务一次提交,模板:

```
<type>(<scope>): <主题>

<body>

Task: <任务编号> - <任务标题>
Refs: docs/tasks/<任务文件>.md
```

- type:`feat` 新功能 / `fix` 修复 / `refactor` 重构 / `test` 测试 / `docs` 文档 / `chore` 杂项
- 提交信息与文档中一律不使用 emoji
- 状态变更为 DONE 与完成摘要合并进本次提交

### 步骤8:逆向一致性审查

任务完成后,按「实现 → 任务 → 设计 → 需求」的顺序逆向核对:

1. **实现 → 任务**:验收标准是否全部达成、变更文件与任务文件一致、测试通过
2. **任务 → 设计**:组件/API/数据模型是否与 docs/design/ 对应
3. **设计 → 需求**:docs/requirements/ 的需求是否被覆盖、是否存在需求之外的超额实现

发现不一致时先修复再进入下一任务;逆向审查不可省略。

### 步骤9:循环与收尾

回到步骤 1 取下一个可执行任务,直到全部 DONE。完成条件:

- 所有任务状态为 DONE
- 逆向审查无不一致(或已全部解决)
- 所有提交已创建

## 最佳实践

1. 任务开始**必须先更新状态**再动手:IN_PROGRESS 并提交
2. 提交模板严格执行:必须包含对相关文档的引用
3. 验收标准全部达成才算完成,缺一条都不行
4. 逆向审查不省略:一致性问题越早发现成本越低
5. 提交信息与文档全部禁止 emoji

使用说明

# SDD 任务执行

SDD(规格驱动开发)工作流的实现阶段技能:读取 docs/tasks/ 任务清单,按依赖顺序逐个实现。任务状态 TODO → IN_PROGRESS → DONE/BLOCKED 全程流转并提交留痕,完成前按类别跑检查清单(UI/外部系统/数据操作/组件复用/远程仓库),每个任务完成后做实现→任务→设计→需求的逆向一致性审查。

## 最简用法

```text
按 docs/tasks/ 的任务清单开始实现
```

```text
执行任务 1.3,完成后做逆向审查
```

## 特点

- 状态流转全程提交留痕,进度可审计
- 分类完成前检查清单,杜绝「感觉做完了」
- 逆向审查保证实现、任务、设计、需求四层一致
- 统一提交模板,Git 历史与任务文档互相索引
- 支持无依赖任务并行推进

如何安装此技能?

访问技能市场,点击「安装」按钮,按提示将技能包放入 AI 编程助手的 skills 目录即可。

浏览技能市场

支持平台:Qoder · QoderWork · Claude · Codex 等 AI 编程助手