mcpField
S
scartill-sdd-lite

scartill-sdd-lite

github.com/scartill开发036 次安装2 周前更新
代码仓库

关于 scartill-sdd-lite

一组规范驱动开发技能,引导工作从头脑风暴和种子规格推进到实现与审查。适合需要分阶段编写规格、拆分任务并管理项目文档流程的开发者或团队。

主要功能

  1. 01创建并评审规格
  2. 02将规格拆分为独立任务
  3. 03指导实现与收尾工作
  4. 04审查代码并归档文档
  5. 05将头脑风暴结果转为种子规格

适用场景

  1. 01将初步构想扩展为实现规格
  2. 02把功能规格拆分为可执行任务
  3. 03审查完成的代码并归档旧文档

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/scartill/scartill-sdd-lite --skill scartill-sdd-lite

安装后在 Claude Code 中输入/scartill-sdd-lite确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

prompts/
sc.archive.md
sc.brainstorm.md
sc.brainstorm.to.seed.md
sc.code.review.md
sc.critique.spec.md
sc.finalize.md
sc.gate.input.md
sc.implement.tasks.md
sc.save.spec.md
sc.split.tasks.md

详细介绍

命令

  • Save Spec - 保存持久化规格(提示词:sc.save.spec.md)
  • Split Tasks - 创建独立任务(提示词:sc.split.tasks.md)
  • Implement - 执行实现(提示词:sc.implement.tasks.md)
  • Finalize - 执行实现后的操作(提示词: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,输入文档路径作为参数)

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

激活后,请记住这些命令,但在收到明确的用户请求前不要运行。

指南

规格工作流:种子规格与完整规格

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

种子规格(docs/seed/)

种子规格是简洁、由人工撰写的意图文档。它记录:

  • 用户的需求(功能意图、期望行为)
  • 关键示例和预期输出格式
  • 高层级的 CLI 接口或配置结构
  • 后续任务(修改 README、添加示例等)

种子规格采用非正式的语气,以用户的口吻撰写,可能包含错别字或简写。它不包括:

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

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

完整规格(docs/specs/)

完整规格是根据种子规格编写的详细实现蓝图。它包括:

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

完整规格面向实现者(人工或 AI),使其能够在无需进一步澄清的情况下执行。

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

收到功能实现请求时,请查找种子规格和完整规格(前者了解意图,后者了解实现细节)。如果只有种子规格,请先提出生成完整规格。

评论

支持 Markdown