Przejdź do treści
Biblioteka skilli
Programowanie · Planowanie

dev-design

/dev-design

Wybiera rozwiązanie techniczne i dzieli wymagania na zadania, zapisując design.md i tasks.md z niezależną weryfikacją.

Repozytorium
devflow ↗
Licencja
MIT
Ostatnia zmiana repozytorium
10.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
4
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wybiera rozwiązanie techniczne i dzieli wymagania na zadania, zapisując design.md i tasks.md z niezależną weryfikacją.

Wyzwalacze z opisu

设计一下技术方案拆任务
Oryginalny opis (EN)

技术设计和任务拆分(devflow 第 2 阶段)。需求确认(关口 A 通过)后,或在使用 devflow 的项目里用户说“设计一下”“技术方案”“拆任务”时使用。自己选方案(能实验的用原型定)、写技术方案、做前置验证、写测试计划和任务,派独立子 agent 做工程评审,由机器关口 B 放行,不中途问人;难以回头的决定只暂停那一项。产出需求文件夹里的 design.md 和 tasks.md。

Jak działa

  1. 开始
  2. 1. 读
  3. 2. 选方案
  4. 3. 写 design.md
  5. 4. 前置验证
  6. 5. 测试计划
  7. 6. 拆任务
  8. 7. 工程评审
  9. 8. 机器关口 B
  10. 不要做的事
Sekcje z nagłówków SKILL.md, w oryginale · 88 linii, 232 słów
Podgląd SKILL.md
---
name: dev-design
description: 技术设计和任务拆分(devflow 第 2 阶段)。需求确认(关口 A 通过)后,或在使用 devflow 的项目里用户说“设计一下”“技术方案”“拆任务”时使用。自己选方案(能实验的用原型定)、写技术方案、做前置验证、写测试计划和任务,派独立子 agent 做工程评审,由机器关口 B 放行,不中途问人;难以回头的决定只暂停那一项。产出需求文件夹里的 design.md 和 tasks.md。
---

# dev-design:设计

目标:**选定做法、定下接口和数据、拆到开发时不用再做决定。** 本阶段不停下来问用户:方案选择是口味型决定,记下来进汇总;由机器关口 B 放行。

## 开始

1. 先读 `../dev-workflow/SKILL.md` 的“每次开始时”,照做其中第 1–3 步(包括读 `../dev-workflow/references/decisions.md`)。本阶段还要读同目录下的 `verification.md`、`gates.md`。
2. 前提:关口 A 已通过(spec 状态“已确认”);因为改方案回来重做时,状态可能是“开发中”,也可以继续。状态还是“草案”的,回到 dev-requirements。规模“小”不经过本阶段。
3. 状态行“阶段”改为 `dev-design`。
4. **独立模式**:没有需求文件夹、用户只是要“设计一下某个东西”或“把这件事拆成任务”时,按下面的方法做,把结果直接给用户,不过机器关口、不交接。
5. **记数据**(metrics.md):阶段开始、结束;每次原型实验;机器关口 B 的每轮结论(第几轮、验证者);每次派评审者、验证者后记“用量”。

**接着做**:看 design.md、tasks.md 写到哪了,前置验证、工程评审、方案验证做了没有,从没做完的步骤继续。

## 1. 读

spec.md 全文、decisions.md、相关代码(要改的模块、要复用的东西、项目惯例),`.devflow.yml` 的 context 和 `rules.design`。

## 2. 选方案

- 想出 2–3 个真正不同的做法,去掉明显不行的(违背需求目的的、和现有代码冲突的)。
- 能用运行结果区分的(性能、兼容性、可行性),在 `.devflow-tmp/` 写一次性原型或探针跑一下,按结果选(decisions.md 第一节)。
- 其余按决策原则选:spec 优先,然后复用已有、直白优先。难分高下时选推荐的继续做,记口味型 `d<n>`,写清另一个方案和它的影响。
- **难以回头的决定**(迁移或改动已有数据、破坏对外接口兼容、新的基础设施或付费依赖;新增表、字段、接口不算):如果 spec 已经定了,照做;没定而又必须定的,按推荐写进设计,记 `c<n>`,依赖它的任务标“阻塞”(只暂停这些)。

## 3. 写 design.md

按 [references/design-template.md](references/design-template.md) 写。接口写到参数、返回值、错误;每条需求在“对需求的覆盖”里有着落;写明已有数据要不要迁移。

## 4. 前置验证

把设计依赖的前提(依赖能装、接口兼容、服务连得上、版本支持某个特性)逐条实际验证:跑命令、写小脚本、查文档。失败就调整设计(换做法记 `d<n>`),再验证,直到全部通过。只有任何调整都绕不过去、需求根本做不了时,才是“需求走不通”,按 decisions.md 整体停下。

## 5. 测试计划

先把每个验收场景分配到测试层级,写进 tasks.md 的“测试计划”:

| 场景 | 层级 | 测试名 | 要点 | 谁写 |
|------|------|--------|------|------|
| R1.1 | 单元 | `comments_create_valid_text` | 返回 201,内容原样保存 | T1 |
| R1.3 | 浏览器 | `R1.3 访问码过期后打开评论页` | 显示“访问码已过期” | dev-test |

- **单元、集成**:由负责的任务编写。
- **浏览器**:有界面的每个关键场景至少一个,**统一由 dev-test 编写**;实现任务要给关键元素加 `data-testid`,在任务里写明。

再列 3–5 个**容易出问题、但 spec 没明说的情况**(重复提交、超长输入、并发修改、网络中断、权限边界),写清合理的预期行为,把测试分给负责的任务或 dev-test。

## 6. 拆任务

按 [references/tasks-template.md](references/tasks-template.md) 写 tasks.md:
- 一个任务有自己完整的测试循环,完成后系统仍能运行;准备工作、配置、文档并入用到它的任务。
- 先做能跑通最小闭环的,再做扩展。
- 每个任务写清:文件(带路径)、接口(用什么、提供什么)、对应场景、测试名和关键断言(用 spec 的具体值)、完成定义(命令和期望输出)。
- 不写不做决定的句子(“处理边界情况”“TBD”);也不把代码写完(计划比代码长就是写成了代码)。

自查:每个场景都有负责的任务或 dev-test;前后任务的名字和签名一致;依赖无循环;完成定义都能执行。

## 7. 工程评审

派一个全新的子 agent,用 [references/eng-review-prompt.md](references/eng-review-prompt.md) 评审**方案加任务**。按 decisions.md 第六节处理:明确错误直接改;取舍记 `d<n>`;需求问题和难以回头的决定记 `c<n>`。改动大(换了方案、改了接口)时再评审一次,最多两次。

## 8. 机器关口 B

按 verification.md 选验证者(优先同级别的其他模型),让它检查并给出结论,写进 design.md 末尾的“方案验证”一节:

```
请验证这份方案能否进入开发。需求:<spec.md>;设计:<design.md>;任务:<tasks.md>;仓库:<路径>。
逐项检查并给出证据:
1. 每条需求、每个场景都能在设计和任务里找到着落(列出对照);
2. 前置验证的每一项都实际跑过且通过(重跑其中最关键的 1–2 项);
3. 工程评审提出的错误都已处理;
4. 列出所有仍未决定、只能由用户决定的事项。
结论写:通过 / 通过,有备注 / 不通过,以及原因。
```

- **通过 / 通过,有备注**:按 gates.md 更新汇总(方案要点、`d` 和 `c`)。
  - **L1**:状态和阶段先不改;汇总末尾请用户回复,状态行写 `待关口:B`,提交,这一轮结束。回复后按 gates.md 的表处理(状态“开发中”、阶段 `dev-build`)。
  - **L2 / L3**:状态改为“开发中”,阶段改为 `dev-build`,提交,然后读 `../dev-build/SKILL.md` 并执行。
- **不通过**:按原因修改设计或任务,再验证;同一个原因 3 轮不过,记 `c<n>` 交给用户。

## 不要做的事

- 不要停下来问“用 A 还是 B”:能跑就跑,不能跑就选推荐的,记成 `d<n>`。
- 不要为“以后可能用到”加抽象、加配置项。
- 不要在设计里写需求没有的功能。
- 不要跳过前置验证。
Pliki w paczce (4)
  • SKILL.md 7 KB
  • references/design-template.md 4 KB
  • references/eng-review-prompt.md 2 KB
  • references/tasks-template.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · lflish/devflow100MIT
pi-ixel/awesome-agent-workflow100MIT
tejitpabari99/tejit-plugin100MIT
FOURTEEN1416/academic-agent-toolkit96CC-BY-4.0
codeaholicguy/ai-devkit90Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki e00103ff2dca (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100devflow
    Prowadzi pracę w projekcie DevFlow z katalogiem .devflow/ i krokowymi przepływami z bramkami.
  • 90dev-build
    Prowadzi etap rozwoju w devflow: pisze testy przed kodem dla każdego zadania, rozstrzyga problemy i przekazuje wynik do oceny.
  • 100dev-test
    Prowadzi testy i odbiór w projekcie devflow: testy przeglądarkowe, e2e, eksplorację i niezależną weryfikację przed zamknięciem.
  • 100s08-05-spec-tasks
    Dzieli plan na zadania w kolejności zależności, z właścicielem, szacunkiem czasu i kryteriami akceptacji w pliku tasks.md.
  • 86devflow-update
    Aktualizuje system agentów DevFlow do najnowszej wersji z repozytorium źródłowego i instaluje go ponownie.
  • 90devflow-rule-placement
    Wskazuje, gdzie w przestrzeni roboczej devflow zapisać regułę projektu: we wspólnym pliku, w etapach, w zestawach technologii czy w nadpisaniach.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.