SuperAPI AI 工具集

levelup-publish

智能体与模型

查看项目

更新于 10-16 02:19

技能介绍

用途

levelup-publish 是 CDR(Context Decision Record,上下文决策记录)生命周期中的实现与发布阶段。它把已经通过 /levelup-clarify 接受(Accepted)的 CDR,从本地草稿编译为 team-ai-directives 团队 AI 指令仓库中的实际产物,并创建一个草稿 PR 供团队评审。它不是发现模式(那由 /levelup-init 或 /levelup-specify 负责),也不是评审 CDR(由 /levelup-clarify 负责)。

主要能力

  • 对接受的 CDR 执行信号门(signal gate)校验,通过四条标准筛选:团队范围适用性、证据质量、唯一性、高价值;不合格的 CDR 会被跳过并保留在本地草稿中。
  • 在发布前检测跨 CDR 冲突,包括重复目标模块、同一关注点不同实现、未标记为 Resolved 的 Inconsistency 类型 CDR。
  • 生成 context module 文件,包括规则(rules)、人设(personas)、示例(examples)和章程(constitution),并写入 OKF v0.2 的 YAML frontmatter。
  • 为 eval 类型的 CDR 生成评测黄金集:goldset.md(人类可读)和 goldset.json(grader 可消费的机器可读版本),包含 pass、fail 和 adversarial 三类用例。
  • 生成技能产物:skills/{name}/SKILL.md 和 .skills-entry.json,并注册到 .skills.json 清单中,同时更新 AGENTS.md 的 Skills 部分。
  • 更新各目录的 index.md 和 log.md(OKF §8 列表格式与 §9 日期分组审计记录)。
  • 执行 Git 操作:在 team-ai-directives 中创建分支、提交、推送并创建草稿 PR;若仓库非 Git 或没有 remote,会提供替代方案。

使用方式

该技能在 CDR 被接受后运行,可带参数:

  • 空输入:将所有接受的 CDR 实现为草稿 PR。
  • --ready:创建就绪 PR 而非草稿。
  • --skip-skills:跳过 skill 类型的 CDR。
  • --context-only:仅构建上下文模块,跳过所有技能生成。
  • --skill <name|CDR-id>:仅从指定的已接受 skill CDR 构建一个技能。
  • CDR-001 CDR-003:仅实现指定的 CDR。

执行流程分为十一个阶段:环境准备(Phase 0)、前置检查(Phase 1)、信号门校验(Phase 2)、跨 CDR 冲突检查(Phase 3)、分支准备(Phase 4)、上下文模块生成(Phase 5)、评测黄金集生成(Phase 6)、技能生成(Phase 7)、log.md 更新(Phase 8)、AGENTS.md 检查(Phase 9)、提交与 PR(Phase 10)、汇总(Phase 11)。

Phase 0 通过 setup-levelup-publish.sh 解析 REPO_ROOT、TEAM_AI_DIRECTIVES、CDR_DRAFTS_DIR、ACCEPTED_CDRS 等变量;脚本不可用时按回退规则手动解析。Phase 1 校验团队指令仓库已配置、工作区干净、存在已接受的 CDR。Phase 2 按四条标准过滤 CDR,跳过的保留在本地草稿。Phase 3 检测冲突,若有冲突则要求先通过 /levelup-clarify 解决。Phase 4 在 team-ai-directives 中创建分支(若 TD_IS_GIT=false 则跳过,由 Phase 10 处理)。Phase 5 生成上下文模块文件并追加 index.md 条目。Phase 6 在 evals/ 下生成黄金集文件。Phase 7 生成技能产物并注册。Phase 8 追加 log.md 记录。Phase 9 缺失 AGENTS.md 时从模板创建。Phase 10 按 Git 决策树提交并创建 PR。Phase 11 输出实现汇总。

合并 PR 后需运行 /team-repair 重新索引和校验,重新派生 CDR.md 扁平表。

适用场景

  • 已通过 /levelup-clarify 接受的 CDR 需要发布时。
  • 单个技能构建:使用 --skill <name|CDR-id> 构建一个技能。
  • 仅需上下文模块:使用 --context-only 跳过技能生成。

限制

  • 没有已接受的 CDR 时不能使用,需先运行 /levelup-clarify。
  • team-ai-directives 存在未提交变更时不能使用,需先清理工作区。
  • 发现模式应使用 /levelup-init 或 /levelup-specify;评审 CDR 应使用 /levelup-clarify。
  • 若团队指令仓库未配置为 Git 仓库,分支/提交/PR 阶段无法运行,只能直接写入文件或先 git init。
  • 该技能要求 CDR 状态必须为 Accepted,Discovered/Proposed/Rejected 的 CDR 会被跳过。
  • 关于具体收费、价格、平台支持范围等事实,资料暂未提供。