scartill-sdd-lite

命令

• Save Spec - 保存持久化规范（提示词：sc.save.spec.md）
• Split Tasks - 创建独立任务（提示词：sc.split.tasks.md）
• Implement - 执行实现（提示词：sc.implement.tasks.md）
• Finalize - 实现后的操作：更新文档，将延期事项记录到 docs/feedback/，并在有条件时将产品经理指导意见发布到 PR（提示词：sc.finalize.md）
• Critique - 评审规范（提示词：sc.critique.spec.md，要评审的文件作为参数）
• Code Review - 评审实现（提示词：sc.code.review.md）
• Archive - 归档较早的项目文档（提示词：sc.archive.md）
• Brainstorm - 扩展式头脑风暴（提示词：sc.brainstorm.md，要探讨的问题作为参数）
• Seed - 将最终头脑风暴结果转换为种子规范（提示词：sc.brainstorm.to.seed.md）
• Gate Input - 清理原始输入，提取简洁的种子规范，并生成 PM 反馈报告（提示词：sc.gate.input.md，输入文档路径作为参数）

高级命令（依赖 Orca）

这些命令需要 /orchestration 技能和可用的对抗式 Agent。

• Handoff Critique - 将评审任务交给在新的 Orca 终端中运行的对抗式 Agent（Antigravity），然后应用评审结果（提示词：sc.handoff.critique.md，允许的参数：--auto）
• Handoff Code Review - 将代码评审任务交给在新的 Orca 终端中运行的对抗式 Agent（Antigravity），然后根据评审结果采取行动（提示词：sc.handoff.code.review.md，允许的参数：--auto）
• Autoflow - 以多态方式自主驱动完整端到端流程：从最早的可用产物开始——等待第 3–4 阶段处理的已填写头脑风暴、尚无种子的已完成头脑风暴、种子（一个或多个）或完整规范——完成头脑风暴和/或在需要时生成种子，规划完整规范，然后执行交接评审（--auto）、拆分任务、实现、交接代码评审（--auto）并最终收尾，每个阶段都进行提交（提示词：sc.autoflow.md，参数：用户以自由形式补充的说明）

所有提示词都位于 <skill-dir>/prompts/。

激活后，请记住这些命令，但在用户明确提出请求前不要运行。

指南

规范工作流：种子规范与完整规范

本项目采用两阶段规范流程。两者都位于 docs/ 下。

种子规范（docs/seed/）

种子规范是简洁、由人工编写的意图文档。它记录：

• 用户想要什么（功能意图、预期行为）
• 关键示例和预期输出格式
• 高层级 CLI 接口或配置结构
• 后续任务（修改 README、添加示例等）

种子规范较为非正式，以用户的口吻撰写，可能包含拼写错误或简写。它不包含：

• 详细的实现指导
• 内部数据模型或代码结构
• 带有测试要求的明确任务拆分
• Mermaid 图或架构决策
• 现有代码库内部结构的背景信息

种子规范是设计阶段的输入。

完整规范（docs/specs/）

完整规范是根据种子规范制定的详细实现蓝图。它包括：

• 问题陈述：对需求的准确重述
• 需求：完整的验收标准列表
• 背景：相关代码库内部信息（现有模式、模块、数据结构）
• 拟议解决方案：包含 Mermaid 图、数据模型和代码示例的架构
• 任务拆分：编号的实现任务，每项包含：
  • 目标
  • 实现指导（涉及哪些文件、应遵循哪些模式）
  • 测试要求（要断言什么、使用哪些测试夹具）
  • 用于验证的演示命令

完整规范面向实现者（人工或 AI），使其无需进一步澄清即可执行。

工作流

1. 用户在 docs/seed/ 中编写种子规格，以记录意图。
2. 在 docs/specs/ 中编写完整规格（由用户完成或借助 AI 完成），将种子扩展为可执行的计划。
3. 按照完整规格中的任务拆分进行实现。

当收到实现功能的请求时，查找种子规格（了解意图）和完整规格（了解实现细节）。如果只有种子规格，则先提出编写完整规格。