有 Markdown 开发计划且可显式触发…

适用于有明确 Markdown 开发计划、需要通过显式 super-swarm-spark 命令并行调度最多 12 个 Sparky 子代理持续实现、校验并最终集成的场景。

适用场景

解决思路

1. 仅由显式 super-swarm-spark 命令触发。
2. 作为子代理编排器（Orchestrator）解析计划文件并并行委派任务；使用滚动池，原文标题和调度策略要求最多 12 个并发 Sparky 子代理，原文开头提到 up to 15，但后文明确 Max concurrent 12，执行时以 12 为上限。
3. 主要编排目标：持续推动项目；忽略依赖图；只要有待处理工作就保持最多 12 个代理运行；为每个子代理提供最大路径/文件上下文；防止并行任务间文件名/文件夹名漂移；检查每个子代理结果；任务完成时更新计划文件；所有任务执行后做最终集成修复；添加/调整测试，运行测试并修复失败。
4. Step 1 解析请求：从用户请求提取计划文件；提取可选任务子集（特定任务 ID）；如果没有提供子集，则运行完整计划。
5. Step 2 读取并解析计划：查找任务小节，例如 ### T1: 或 ### Task 1.1:；对每个任务提取任务 ID 和名称、任务关联元数据（仅作上下文）、完整内容（描述、位置、验收标准、验证）；构建任务列表；如果请求了任务子集，则过滤到这些 ID。
6. Step 3 为每个任务构建上下文包：在启动任务前准备包含以下内容的上下文包：任务必须触及的规范文件路径和文件夹路径；计划新建文件名（精确名，不是建议）；触及相同文件/文件夹的邻近任务；来自计划/仓库的命名约束和约定；任何可能导致冲突的已知跨任务预期。
7. 上下文包规则：不允许子代理为同一意图发明替代文件名；要求每个子代理分配中明确文件目标；如果子代理需要上下文包外的新文件，必须先报告再创建。
8. Step 4 启动子代理（滚动池，最大 12）：运行滚动调度器；状态为 pending、running、completed、failed；立即启动最多 12 个任务（如果待处理任务更少则更少）；每当任何运行任务完成，验证/更新该任务计划，然后立即启动下一个 pending 任务；继续直到没有 pending 或 running 任务。
9. 每次启动任务使用 agent_type: sparky；description: Implement task [ID]: [name]；prompt 使用给定模板。
10. 不要等待分组批次；唯一并发限制是 12 个活跃 Sparky 子代理。
11. 每次启动必须设置 agent_type: sparky；任何其他角色对本技能无效。
12. 任务 prompt 的 Context 部分包含：Plan: [filename]；Goals: [计划中相关概览]；Task relationships: [相关元数据，仅用于知晓，绝不作为阻塞项]；Canonical folders: [要使用的精确文件夹]；Canonical files to edit: [精确路径]；Canonical files to create: [精确路径]；Shared-touch files: [其他并行任务触及的文件]；Naming rules: [仓库/计划命名约束]；Constraints: [计划中的风险]。
13. 任务 prompt 的 Your Task 部分包含：Task [ID]: [Name]；Location: [文件路径]；Description: [完整描述]；Acceptance Criteria: [来自计划的列表]；Validation: [来自计划的测试或验证]。
14. 任务 prompt 的 Instructions：使用 sparky 代理角色，不使用其他角色；编辑前检查计划和所有列出的规范路径；实现所有验收标准；保持工作原子且可提交；对每个文件先读、仔细编辑、保留格式；不要创建替代文件名变体，只使用提供的规范名称；如果需要触及/创建未列出的路径，先停止并报告；如果可行运行验证；ALWAYS 在完成后立即在 *-plan.md 文件中将已完成任务标记为完成，并更新简洁工作日志、修改/创建的文件、遇到的错误或陷阱；提交工作，注意其他代理在并行工作，只 stage 和 commit 自己工作的文件，NEVER PUSH，ONLY COMMIT；在让出前再次确认更新了 *-plan.md 并提交工作；返回摘要：修改/创建的文件（精确路径）、所做更改、如何满足标准、已执行或推迟的验证。
15. 任务 prompt 的 Important：注意路径；严格遵循规范命名；如遇阻碍停止并描述；专注该特定任务。
16. Step 5 验证每个完成：子代理完成时检查输出正确性和完整性；针对该任务预期结果验证；确保计划文件完成状态和日志已正确更新；失败时重试/升级；保持调度器满：验证后如果有空槽立即启动下一个 pending 任务。
17. Step 6 最终编排器集成：所有子代理完成后协调并行工作冲突和跨任务破坏；解决重复/变体文件名并收敛到规范路径；确保计划完全准确更新；添加或调整测试以覆盖集成/回归缺口；运行所需测试；修复失败；重新运行测试直到通过（或报告明确阻碍及证据）。
18. 完成标准：所有计划任务标记完成并有日志；集成代码库按计划预期构建/测试；并行执行未引入未解决的路径/名称分歧。
19. 调度策略：最大并发子代理 12；如果有 pending 任务且 running 数低于 12，立即启动更多；不要因关系元数据暂停；继续直到完整计划（或请求子集）完成并集成。
20. 错误处理：任务子集未找到时列出可用任务 ID；解析失败时显示尝试过什么并请求澄清；跨任务路径歧义时选一个规范路径、宣告它，并在所有任务 prompt 中强制执行。
21. 示例用法：'Implement the plan using super-swarm'；/super-swarm-spark plan.md；/super-swarm-spark ./plans/auth-plan.md T1 T2 T4；/super-swarm-spark user-profile-plan.md --tasks T3 T7。
22. 按 Execution Summary Template 输出执行摘要，字段包括：Tasks Assigned: [N]；Concurrency: Max workers: 12，Scheduling mode: rolling pool (continuous refill)；Completed: Task [ID]: [Name] - [Brief summary]；Issues: Task [ID]: [Name]，Issue，Resolution；Blocked: Task [ID]: [Name]，Blocker，Next Steps；Integration Fixes: [Conflict or regression]: [Fix]；Tests Added/Updated: [Test file]: [Coverage added]；Validation Run: [Command]: [Pass/Fail + key output]；Overall Status；Files Modified；Next Steps。

适用边界 · 注意事项

• 未通过显式 super-swarm-spark 命令触发时不要使用。
• 没有可解析的 Markdown 计划文件或任务小节（如 ### T1:）时不要使用。
• 无法使用 sparky 子代理角色、禁止并行提交或必须严格遵守依赖图顺序时不要使用。