SuperAPI AI 工具集

sdd-derive

办公与效率

查看项目

更新于 10-15 20:12

技能介绍

用途:从现有代码推导 SDD 规格,或将已实现行为追溯记录为基线规格。触发语包括“derive specs”“generate specs from code”“retrofit specs”“document this code in SDD”。不适用于跨工具格式转换(用 sdd-translate)、无代码可锚定的场景(用 sdd-propose)或先探索问题(用 sdd-explore)。

主要能力:编排器跨阶段持有上下文,按需派发子代理做隔离工作。流程分六阶段:理解意图、发现(并行探索器加综合器生成能力菜单)、预检同意、按能力推导(观察器加提升器)、校验、生成输出。输出类型分两种:变更目录(.specs/changes/<name>/,含 proposal.md、delta 格式 spec.md、tasks.md)与基线规格(.specs/specs/<capability>/spec.md,无价值层)。

使用方式:SPECS_ROOT 由 sdd router 解析。子代理须先写盘再返回,路径需展开 $TMPDIR 等变量,写后运行 ls -la <path> 并报告字节数。校验命令为 uv run --quiet <skill_root>/references/validate.py --single <observations.yaml> <spec.md>,聚合校验为 uv run --quiet <skill_root>/references/validate.py <observations_dir> <specs_dir>。可选工具 code-review-graph 安装命令为 uv tool install code-review-graph。

限制:基线规格仅在代码锚定时生成,绿地场景须用变更目录的 ADDED-only 增量规格;变更目录不含 design.md;推导出的跨切面用户故事需用户批准;能力过大须在派发前拆分,不得静默截断。具体收费、平台与效果资料暂未提供。