SuperAPI AI 工具集

leanspec-sdd

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:LeanSpec SDD 技能用于指导 AI 智能体在 LeanSpec 项目中按规格驱动开发(SDD)流程工作,所有操作通过 lean-spec CLI 完成。

核心原则:上下文经济(规格尽量控制在 2000 token 内,过大则拆分);发现优先(创建新规格前先运行 board/search);意图先于实现;不手动编辑 frontmatter,用工具更新状态、标签与依赖;对照真实代码库、提交与变更验证,而非只看规格状态。

生命周期:1)发现——运行 lean-spec board 查看项目状态,用 lean-spec search "关键词" 查找相关规格,相似则扩展或建立依赖。2)创建——lean-spec create "spec-name",一次传入标题、内容、优先级、标签等已知字段,命名用 kebab-case,内容含概述、需求清单、非目标、技术说明、验收标准;创建后建立关系并运行 validate、检查 token 数。3)细化——实现前研究代码库,验证文件/API 是否存在、接口是否兼容,补充具体路径与函数名,完成就绪清单。4)实现——先 lean-spec view <spec>,再 lean-spec update <spec> --status in-progress,按清单顺序实现;完成前必须通过 pnpm typecheck、pnpm test、pnpm lint 与 lean-spec validate,然后设为 complete。5)检查进度——用 git log 与代码阅读逐项核实,不轻信状态。

管理:内容更新直接编辑规格文件,元数据用 lean-spec update 与 lean-spec rel add 等命令;范围蔓延应拆分为新规格并建立链接。整理时先用 board、board --group-by、stats 调查,再按模式处理(3 个以上相关规格建 umbrella、加 depends_on、修正过期状态、归档低价值规格、拆分超 2000 token 规格)。状态含 planned、in-progress、complete、archived;优先级含 critical、high、medium、low。

关系选择:父/子用于大型计划分解,子规格脱离父上下文无意义;depends_on 用于技术阻塞,两者独立;同一对规格不可同时使用。

限制:资料未提供安装方式、收费、价格与平台支持信息。