ds-blueprint 是一个用于 AI 辅助编程的技能,核心思路是在写函数体之前先固定代码的结构,让模型按既定计划填充实现,而不是边写边临时发明结构。
用途:适用于非平凡、直接编码容易出问题的任务。当新代码需要与现有模块协作时,先用该技能确定类型、函数签名和模块布局,达成一致后再实现。
主要能力与流程:
-
建立上下文:阅读新代码会触及的每个模块。如果无法解释它们如何组合,先运行 /ds-explain。只有代码没有周边系统时才可跳过。
-
写至少两个结构不同的草图:每个草图是真实文件,包含类型、签名、模块边界、抛出“not implemented”的桩函数体,以及简短伪代码。设计重要时可用 /ds-best-of-n 并行生成。
-
比较草图:优先选择公共接口更小、隐藏更多内部细节的方案;优先选择从单个文件看正确的改动在整个仓库中也正确的方案。记录拒绝了什么及原因。
-
对选定草图运行类型检查器或编译器并粘贴输出,桩代码必须能编译。
-
向用户展示选定草图,等待同意后再填充函数体。无人值守运行时,用 /ds-ledger 记录选择。
-
逐个实现桩函数,每次之后运行类型检查器和相关测试。如果草图被证明有误,停下修改草图,而不只是改函数体。
-
清理:删除残留桩、废弃草图和未使用类型,用 grep 搜索“not implemented”证明没有残留。
停止条件:所有桩实现完成、类型检查通过、测试通过并展示输出;或者草图在实现过程中需要三次修订,此时停下与用户重新设计。
规则:签名只能通过第 6 步的修订路径变更,不得静默修改;每个草图文件应小到可一次读完;证据是编译器与测试输出,而不是“应该能工作”。
适用场景:需要与现有系统集成的非平凡编码任务、设计决策影响面较大的改动、多人或人机需要先对齐代码结构的协作场景。
限制:资料未提供具体支持的编程语言、平台、安装方式、收费信息或性能数据;该技能依赖类型检查器和测试环境,且需要用户参与确认草图(无人值守时依赖 /ds-ledger)。