关于 ds-blueprint
ds-blueprint 是一种编码技能，强调先确定代码结构再实现。它引导开发者和编码 Agent 比较设计草图、编译验证、征求确认，并逐步实现。
主要功能
- 01先阅读受影响的模块
- 02创建两个结构不同的设计草图
- 03比较接口范围与仓库适配性
- 04实现前编译验证草图
- 05逐个实现存根并测试
- 06实现不符预期时修订设计
适用场景
- 01规划涉及多个模块的改动
- 02实现前获取设计确认
- 03通过编译和测试验证设计
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/ds-blueprint确认已加载。
详细介绍
ds-blueprint
先确定代码的结构，再编写具体实现，让模型按计划填充代码，而不是边写边构思。
步骤
- 先熟悉代码。阅读新代码会涉及的每个模块。如果你无法解释它们如何协同工作，请先运行 /ds-explain。只有在代码没有相关系统时才跳过这一步。
- 至少编写两份结构不同的草案。每份草案都要包含实际文件、类型、签名、模块边界和会抛出 "not implemented" 的桩函数体，以及简短的伪代码。设计影响较大时，使用 /ds-best-of-n 并行生成草案。
- 比较这些草案。优先选择公开接口更小、封装更多内容的方案。优先选择从单个文件看起来合理的改动，在整个代码仓库中也同样合理的方案。说明你否决了哪些方案以及原因。
- 对选定的草案运行类型检查器或编译器。粘贴输出。桩函数必须能够通过编译。
- 向用户展示选定的草案，并等待确认后再填充具体实现。无人值守运行时，改用 /ds-ledger 记录选择。
- 一次实现一个桩函数。每完成一个，就运行类型检查器和相关测试。如果发现草案有误，请停止并修改草案，而不是只修改函数体。
- 删除遗留桩函数、无用草案和未使用类型。通过搜索 "not implemented" 来证明它们已全部清除。
停止条件
- 所有桩函数均已实现，类型检查器和测试均通过，并已展示输出。
- 或者实现过程中草案需要修改三次。此时停止并与用户重新设计。
规则
- 只能通过第 6 步中的修改流程更改签名，不得擅自更改。
- 每份草案文件都应小到可以一遍读完。
- 证据是编译器和测试的输出，而不是「应该能行」。
评论
支持 Markdown