SuperAPI AI 工具集

spec

编程与开发

查看项目

更新于 10-23 23:08

技能介绍

用途

本技能用于执行 CocoBrew 生命周期的第 1 阶段(共 6 阶段)——Spec 阶段,目标是通过结构化对话完整捕获项目需求,为后续计划、实现与验证阶段提供唯一事实来源。

主要能力

  • 检查 .cocoplus/ 目录与 lifecycle/meta.json,根据当前阶段决定是否允许进入或强制重入。
  • 读取 bloom.md 作为核心能力锚点;若缺失则提示可先运行 $bloom。
  • 依据初始任务描述自动判定 Quick Flow 或 Full Flow,并记录 flow_type。
  • 依次提出 6 个问题(目标、成功标准、范围外、现有 Snowflake 对象、目标用户、时间线),每题等待回答后再继续。
  • 要求并校验 Outcome Statement,格式为“当此功能正常工作时,[具体角色]看到[可观察结果]”,拒绝实现描述式或泛化角色的表述。
  • 生成 .cocoplus/lifecycle/shape.md,包含可观察验收标准、发布/回滚决策、开发测试梯级与检查面。
  • 对六项回答执行确定性模糊语言检测,按类别扣分并要求开发者决定是否修改。
  • 写出 .cocoplus/lifecycle/spec.md,包含 Outcome Statement、Goal、Success Criteria、Out of Scope、Existing Snowflake Objects、Target Users、Timeline 七个部分,并生成 spec-YYYYMMDD-NNN 格式的阶段 ID。
  • 更新 .cocoplus/AGENTS.md 与 lifecycle/meta.json,并创建 Git 提交。

使用方式

在已初始化 CocoPlus 的项目目录中调用 $spec 进入 Spec 阶段。若当前阶段为 build、test、review 或 shipped,需加 --force 才能强制重入;若当前阶段为 plan,会询问是否继续。可用 --quick 或 --full 强制流程类型。

适用场景

适用于使用 Snowflake 与 CocoBrew 生命周期管理、需要在编码前明确需求与可观察结果的开发项目。

限制

需先通过 $pod init 初始化 .cocoplus/ 目录,否则技能会提示未初始化并停止。若未找到 bloom.md 且未标记 bloom_waived,会提示先运行 $bloom。强制重入 Spec 会使下游产物与 CocoHarvest 的 git worktree 失效,需手动清理。仅 L4 验证路径被视为计划缺陷,除非开发者明确接受风险。