SuperAPI AI 工具集

spec-init

通用与其它

查看项目

更新于 10-16 09:47

技能介绍

用途:spec-init 用于在开发流程早期把模糊需求转化为结构化规格文档,覆盖功能、缺陷、杂务、重构和文档五类任务,并作为后续计划生成(plan-generator)的前置步骤。

主要能力:一是意图类型检测,依据描述自动归类为 feature、bug、chore、refactor 或 docs,其示例映射为“Build X”归功能、“Fix X”归缺陷、“Update X”归杂务、“Reorganize X”归重构、“Document X”归文档。二是渐进式需求收集,调用 context-compressor 的 progressive disclosure 模式,通过 AdaptiveQuestioner 与 ContextAccumulator 自适应提问,通常 5 至 7 个问题,可提前停止,避免固定 10 至 12 问。三是规格模板生成,自动填充概览、问题陈述、方案、实施阶段、成功指标、工作量估算、依赖与验收标准等章节。四是校验,检查必需章节是否齐全、验收标准是否至少 3 条、估算是否以天为单位。五是建议后续动作,询问是否交由 planner 生成计划,若同意则展示 Skill({ skill: "plan-generator", args: { specPath: "..." } })。

使用方式:属于 agent-studio 内的技能流程,遵守其铁律:提问不超过 7 个;先检测意图类型;未校验全部必需章节不得生成规格;必须保存到 .claude/context/artifacts/specs/ 目录,命名形如 [feature-name]-spec-YYYYMMDD.md;必须写入 trackId、type、status、created_at 等 track metadata。流程还要求开始前读取 .claude/context/memory/learnings.md,完成后按新模式、问题、决策分别写入 learnings.md、issues.md、decisions.md。

适用场景:需要快速为功能或缺陷等任务产出规范化规格,并衔接计划生成的开发场景。

限制:资料未提供独立的安装命令、计费、价格、运行平台或效果数据,这些事实暂未提供;实际可用性取决于 agent-studio 环境及所依赖的上下文压缩与计划生成技能是否就绪。