SuperAPI AI 工具集

seed-promote

办公与效率

查看项目

更新于 10-23 23:07

技能介绍

seed-promote 用于把已经触发的种子想法(seed idea)纳入规划流程:它把想法写入 lifecycle/spec.md 的“Backlog Items”小节,并把对应种子标记为 promoted。

用途:衔接“种子收集”与“规格规划”两个阶段。种子触发后,开发者用该技能将其转入待办列表,供后续规格周期考虑。

主要能力:

  • 校验 .cocoplus/ 是否已初始化;未初始化时提示先运行 $pod init。
  • 校验种子 ID 对应文件 .cocoplus/seeds/[id].yaml 是否存在。
  • 按种子状态分别处理:pending 提示尚未触发并显示触发条件;promoted 提示已提升及提升日期;discarded 提示已丢弃并说明可用 $seed add 重新添加;仅 triggered 状态允许提升。
  • 从种子 YAML 中读取 idea、trigger、captured_phase、captured_date、triggered_date。
  • 写入 spec.md:若已有 ## Backlog Items 小节则追加条目,否则在文件末尾新建该小节并以该想法作为首条;条目格式包含种子 ID、想法文本,以及捕获阶段、触发条件和触发日期的说明行。
  • 更新种子 YAML,写入 status: promoted 与 promoted_date。
  • 向开发者输出确认信息,包括想法内容、写入位置和后续运行 $spec 的提示。

使用方式:命令为 $seed promote <id>,其中 <id> 为必填的种子 ID,例如 seed-20260505-143200。前置条件包括:.cocoplus/ 已初始化;种子存在且状态为 triggered;lifecycle/spec.md 应存在。若 spec.md 不存在,技能会警告并退出,不执行提升,种子保持 triggered 以便之后再次提升。若写入 spec.md 失败,会输出文件系统错误且不更新种子状态。

适用场景:在 CocoPlus 项目中,当某个种子的触发条件满足、开发者希望把它排入 CocoBrew 规划待办时使用。

限制与边界:不会在提升后自动运行 $spec,这始终需要开发者显式操作;不会删除种子文件,种子保留为 promoted 状态作为记录;不会创建独立的 git 提交,spec.md 的变更随下一次 $spec 调用一并提交。