jnMetaCode/superpowers-zh / skills/subagent-driven-development
subagent-driven-development
Verified当在当前会话中执行包含独立任务的实现计划时使用
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.7 KB |
| implementer-prompt.md | markdown | 6.0 KB |
| re-review-prompt.md | markdown | 5.0 KB |
| references/example-workflow.md | markdown | 2.5 KB |
| references/final-review.md | markdown | 1.6 KB |
| references/finishing.md | markdown | 868 B |
| references/fix-loop.md | markdown | 4.3 KB |
| references/preflight-and-resuming.md | markdown | 3.8 KB |
| references/report-handling.md | markdown | 1.6 KB |
| scripts/review-packageexecutable | script | 2.4 KB |
| scripts/sdd-repoexecutable | script | 2.3 KB |
| scripts/sdd-workspaceexecutable | script | 4.7 KB |
| scripts/task-briefexecutable | script | 4.6 KB |
| task-reviewer-prompt.md | markdown | 9.0 KB |
references/preflight-and-resuming.md
View on GitHub## 准备
本技能中的 `scripts/...` 指技能安装目录内的脚本。执行时保持用户项目工作树为当前目录,使用脚本的绝对路径(路径含空格时加引号);不要为调用脚本而切换到技能安装目录,否则 git 和计划路径会指向错误的仓库。
确保工作发生在一个隔离的工作区里:用 using-git-worktrees 创建一个,或者核实已有的那个。没有你人类伙伴的明确同意,绝不在 main/master 分支上开始实现。
会话记忆无法在上下文压缩(compaction)中存活。在真实会话里,丢失了位置的控制者曾重新分派整段已经完成的任务序列——这是观察到的最昂贵的失败。把进度记在一个账本文件里,而不只是记在待办里。
- **每个计划拥有自己的工作区:** 技能启动时,运行本技能的 `bash scripts/sdd-workspace PLAN_FILE`(从正在执行的项目工作树中,用脚本的绝对路径运行)——它会打印这个计划专属的、被 git 忽略的目录(位于 `<repo-root>/.superpowers/sdd/` 之下),**本计划**的一切产物都放在那里:账本、简报、报告、审查包。别的计划的目录不属于你,不读也不写。
- 到 `<工作区>/progress.md` 查本计划的账本。如果它的第一行点名的是你的计划文件,那么带有 `Task <N>: complete` 行的任务就是**已完成**——不要重新分派它们;从第一个没有该行的任务处继续。如果某个任务的最后一行是一轮修复,说明它正卡在修复循环中:从下一轮继续。如果账本第一行点名的是**另一个**计划文件——或者你在旧的扁平路径 `.superpowers/sdd/progress.md` 发现了一个游离的账本——那是别人的进度:原地别动,另起你自己的新账本。
- 创建账本时,把它的身份写在第一行:`# SDD ledger — plan: <计划文件路径>`。
- 这个账本是你的恢复地图:它点名的那些提交,即使你的上下文已经不记得创建过它们,也确实存在于 git 中。压缩之后,相信账本和 `git log`,而不是你自己的记忆。
- `git clean -fdx` 会毁掉这个工作区(它是被 git 忽略的临时文件);万一发生了,就从 `git log` 恢复。
把计划**读一遍**,记下它的上下文和全局约束,并为每个任务建一条待办。如果计划点名了一份规格(Spec),把规格也读了:规格是计划据以论证的权威,计划内部的冲突要拿它来裁。计划里找不到可达的规格,就在账本里记一条说明——没有规格作出的裁决都是临时的。
在分派任务 1 之前,把计划通扫一遍找冲突,边查边把你查过的东西写下来:
- 互相矛盾的任务,或与计划的"全局约束"矛盾的任务
- 计划明确要求、但审查标准会判为缺陷的东西(比如一个什么都不断言的测试、一整块逻辑的逐字复制)
这次扫描的产出是一张**表**,不是一句结论。每一对共用文件或接口的任务占一行:这两个任务、一个产出的东西对上另一个消费的东西、以及你发现了什么。每个任务再占一行:它自己的文本是否自洽——它规定的测试对上它规定的代码,它创建的文件对上它后面又要碰的文件。没有这些行的"扫描是干净的",不算你真扫过。
把这张表写进账本。在执行开始之前就对你找到的每一条作出裁决——每条发现都并列上要求它的那段计划原文——并把每条裁决记进账本。如果扫描是干净的,就不要多说,直接开始。对它翻出的每个冲突作出裁决——规格是有约束力的权威,计划是它的论证——把裁决记在那一行旁边,然后分派任务 1。审查循环仍然是那些只有在实现中才浮现的冲突的兜底网。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |