关于 scartill-sdd-lite
一组规范驱动开发技能,引导工作从头脑风暴和种子规格推进到实现与审查。适合需要分阶段编写规格、拆分任务并管理项目文档流程的开发者或团队。
主要功能
- 01创建并评审规格
- 02将规格拆分为独立任务
- 03指导实现与收尾工作
- 04审查代码并归档文档
- 05将头脑风暴结果转为种子规格
适用场景
- 01将初步构想扩展为实现规格
- 02把功能规格拆分为可执行任务
- 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.mdsc.brainstorm.mdsc.brainstorm.to.seed.mdsc.code.review.mdsc.critique.spec.mdsc.finalize.mdsc.gate.input.mdsc.implement.tasks.mdsc.save.spec.mdsc.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),使其能够在无需进一步澄清的情况下执行。
工作流
- 用户在
docs/seed/中编写种子规格,以记录意图。 - 在
docs/specs/中生成完整规格(由用户或借助 AI 完成),将种子扩展为可执行计划。 - 按照完整规格中的任务拆分进行实现。
收到功能实现请求时,请查找种子规格和完整规格(前者了解意图,后者了解实现细节)。如果只有种子规格,请先提出生成完整规格。
评论
支持 Markdown