SuperAPI AI 工具集

atelier-spec-methodology

智能体与模型

查看项目

更新于 10-16 00:06

技能介绍

用途:该插件提供一套规格驱动开发(Spec-Driven Development)方法论,围绕三个组件展开:AgentOS 上下文分层与委派、OpenSpec 活规格、Beads 依赖跟踪。核心目的是在写任何代码前,让人类与 AI 就构建内容达成一致。

主要能力:三层上下文模型按需提供信息,避免一次性塞入全部知识。Standards 层含编码规范与架构模式,位于 docs/standards/;Product 层含使命、用户与路线图,位于 docs/product/;Specs 层含需求、设计与任务,位于 docs/spec/<feature>/。智能体只加载当前任务所需的层。

编排式委派通过命令把任务交给受控上下文的子智能体:clerk 使用 haiku,负责快速取回上下文与文件脚手架;oracle 使用 opus,负责需求访谈与策略分析;architect 使用 opus,负责技术设计与任务拆解。

OpenSpec 活规格以 SHALL/MUST 语言写需求,以场景作为验收标准,层级为需求嵌套场景。目录中 docs/spec/<feature>/spec.md 为事实来源,docs/changes/<feature>/<change>/ 存放提案、增量与任务。增量格式支持 ADDED、MODIFIED、REMOVED 三类需求,用于棕地变更。活规格循环为:起草变更提案、评审至共识、实现任务、归档并把增量合并回规格。

Beads 通过依赖强制实现顺序,bd ready 显示下一个未被阻塞的任务,依赖推动自底向上实现(Entity → Repository → Service → Router),并以 .beads/beads.jsonl 做 Git 持久化。命令包括 /spec:create 与 /spec:work,前者会自动创建带技术依赖排序任务的 Beads 史诗。

适用场景:需要以规格驱动方式管理特性开发、变更提案与任务依赖的项目;限制:资料未提供价格、平台支持范围或效果数据,暂未提供。