用途
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 会被跳过。
- 关于具体收费、价格、平台支持范围等事实,资料暂未提供。