dev-design
/dev-design
Wybiera rozwiązanie techniczne i dzieli wymagania na zadania, zapisując design.md i tasks.md z niezależną weryfikacją.
Ocena i bezpieczeństwo
- Pliki w paczce
- 4
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 10.11.2026, bez odwołań do wycofanych modeli i API.
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. 选方案
- 3. 写 design.md
- 4. 前置验证
- 5. 测试计划
- 6. 拆任务
- 7. 工程评审
- 8. 机器关口 B
- 不要做的事
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · lflish/devflow | 100 | MIT |
| pi-ixel/awesome-agent-workflow | 100 | MIT |
| tejitpabari99/tejit-plugin | 100 | MIT |
| FOURTEEN1416/academic-agent-toolkit | 96 | CC-BY-4.0 |
| codeaholicguy/ai-devkit | 90 | Apache-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.