SuperAPI AI 工具集

specs

编程与开发

查看项目

更新于 10-16 01:34

技能介绍

用途:当工作必须遵循明确的规格产物、严格顺序、硬门禁与机器可读状态时使用该技能。不适合临时性、低风险、过小的工作,或需求多变、需要快速探索、仓库未采用所需 specs/ 产物结构的情况。

主要能力:SDD 分四个有序阶段——Specify(定义需求、故事、约束与成功标准)、Plan(映射架构与代码库)、Task(拆解为原子可执行任务)、Implement(执行并对照需求验证)。默认继续前进:门禁通过即推进,不在成功步骤间要求人工确认;仅在存在未解决的 questions 文件或硬阻塞时停止。

必要用法:命令式调用(如 /specs continue、/specs run、/specs advance)为执行命令,须立即尝试确定性运行循环并更新产物,而非仅作解释。仓库根目录需有 specs/ 与 AGENTS.md;每个规格文件夹命名为 specs/01_feature_name/ 形式,内含 status.yaml、specification.md、technical-plan.md、tasks/、implementation.md。跨规格编排由 specs/status.yaml(active_specs、active_tasks、updated_at)承担;任务运行状态以 tasks/index.yaml 为权威,并配 audit.log。阶段推进须满足:当前阶段产物存在且在 status.yaml 标记完成、无 questions 文件、完成证据已记录。

限制:任何阶段或任务在无完成证据时不得转为完成/完成态;缺失证据须硬拒绝并置 blocked。任务状态须遵循合法转换,非法转换须硬拒绝。每个规格文件夹同一时间仅允许一个 in_progress 任务,跨规格并行仅通过 specs/status.yaml 的 active_tasks 进行。多智能体并发写入共享编排文件时需通过 lock 租约串行化。具体性能、收费或集成信息暂未提供。