Skip to content

v1.14.0

Latest
Latest

Choose a tag to compare

View all tags
@WoJiSama WoJiSama released this 09 May 09:48
· 24 commits to main since this release
v1.14.0
0679e1a

v1.14.0

English | 中文

Highlights

  • Content conformance check — templates/skill/conformance.yaml + check-version-conformance.sh ensure downstream skills carry every mandatory section the upstream template promises. A self-hosting parity manifest validates the upstream's own canon.
  • Three-axis skill profile (structure / execution / topology) for project profiling. Plus optional executable-skill architecture and scenario-testing references.
  • skill-asset CLI — AAR-time consolidation helper (where / related / group).
  • Upstream change-note guard — scripts/check-upstream-changes.sh blocks downstream-facing edits without a same-diff UPSTREAM-CHANGES.md entry.
  • Routing manifests + agent-led upstream refresh — routing.yaml is the source of truth for Always Read / Common Tasks / shell bootstraps. update-upstream.md lets the agent run the refresh end-to-end.
  • ~1500-line bloat reduction across templates, references, examples, and READMEs.

New

  • templates/skill/conformance.yaml, check-version-conformance.sh, _parse_conformance.py
  • references/self-hosting-conformance.yaml, references/per-tool-shells.md, references/progressive-rigor.md
  • references/executable-skill-architecture.md, references/scenario-testing.md
  • workflows/full-migration.md, workflows/upgrade-downstream.md (split out of WORKFLOW.md)
  • scripts/skill-asset (Node CLI), scripts/check-upstream-changes.sh, scripts/check-all.sh
  • templates/hooks/workflow-state (long-task state injection)
  • UPSTREAM-CHANGES-archive.md

Removed

  • templates/migration/ — the migration FSM was over-engineered for a crash scenario that doesn't recur in practice
  • templates/checklists/post-migration.md — duplicate of WORKFLOW Phase 8
  • templates/protocol-blocks/iron-law-header.md — referenced once, inlined
  • templates/shells/.codex/instructions.md and root .codex/ — AGENTS.md is the canonical Codex CLI entry
  • 4 examples/*.md files consolidated into root EXAMPLES.md

Refactors (size before → after)

  • WORKFLOW.md 449 → 136 (split into Quick Start + workflows/full-migration + workflows/upgrade-downstream)
  • TEMPLATES-GUIDE.md 398 → 90 (removed protocol content duplication; references/protocols.md is canonical)
  • references/thin-shells.md 345 → 204 (per-tool moved to per-tool-shells.md)
  • references/layout.md 306 → 173 (Progressive Rigor extracted; positioning kept inline)
  • README.md / README.zh-CN.md combined 612 → 316
  • UPSTREAM-CHANGES.md 277 → 178 (older entries archived)

Backward compatibility for downstream refresh

  • sync-routing.sh keeps .codex/instructions.md in its target list only when the file already exists — old downstream copies keep getting routing block updates; new scaffolds don't reintroduce the file.
  • smoke-test.sh now treats .codex/instructions.md as optional (was required).
  • update-upstream.md adds an explicit step to scan for new mechanism files — downstream agents auto-port additions like the conformance script set.
  • All anchor changes (e.g. WORKFLOW.md#phase-9-... → workflows/full-migration.md#phase-9-...) are documented in UPSTREAM-CHANGES.md for refresh agents.

For downstream maintainers running update-upstream

After upgrading, the agent will:

  1. Scan upstream for new mechanism files → most projects need to copy conformance.yaml, check-version-conformance.sh, _parse_conformance.py.
  2. Run conformance against the upstream's manifest (not the local snapshot) — if any sections are missing from local workflows, port them.
  3. Optionally delete skills/<name>/.codex/instructions.md if your harness doesn't read it.

Full diff

v1.13.0..v1.14.0: 84 files changed, 5876 insertions(+), 3179 deletions(-)

v1.14.0(中文)

English | 中文

重点

  • 内容 conformance 校验 — templates/skill/conformance.yaml + check-version-conformance.sh 保证下游 skill 包含上游 template 承诺的每一段强制内容。新增 self-hosting 对等 manifest,把上游自身的核心文档也纳入同一道内容守卫。
  • 三轴 skill 画像(结构 / 执行 / 拓扑)用于项目 profiling。配套可选的 executable-skill 架构和 scenario-testing 参考。
  • skill-asset CLI — AAR 阶段的合并辅助工具(where / related / group)。
  • 上游变更说明守卫 — scripts/check-upstream-changes.sh 阻止下游可见的改动落地时缺少同 diff 的 UPSTREAM-CHANGES.md 条目。
  • routing manifest + agent 自助上游刷新 — routing.yaml 是 Always Read / Common Tasks / 薄壳 bootstrap 的唯一权威源。update-upstream.md 让 agent 端到端跑完刷新流程。
  • 约 1500 行瘦身 — 跨 templates、references、examples、README。

新增

  • templates/skill/conformance.yaml、check-version-conformance.sh、_parse_conformance.py
  • references/self-hosting-conformance.yaml、references/per-tool-shells.md、references/progressive-rigor.md
  • references/executable-skill-architecture.md、references/scenario-testing.md
  • workflows/full-migration.md、workflows/upgrade-downstream.md(从 WORKFLOW.md 拆出)
  • scripts/skill-asset(Node CLI)、scripts/check-upstream-changes.sh、scripts/check-all.sh
  • templates/hooks/workflow-state(长任务状态注入)
  • UPSTREAM-CHANGES-archive.md

删除

  • templates/migration/ — migration 状态机为一个实际不会重现的崩溃场景过度设计
  • templates/checklists/post-migration.md — WORKFLOW Phase 8 的重复
  • templates/protocol-blocks/iron-law-header.md — 仅 1 处引用,已 inline
  • templates/shells/.codex/instructions.md 与根 .codex/ — AGENTS.md 是 Codex CLI 唯一权威入口
  • examples/*.md 4 个文件合并到根 EXAMPLES.md

重构(行数对比)

  • WORKFLOW.md 449 → 136(拆成 Quick Start + workflows/full-migration + workflows/upgrade-downstream)
  • TEMPLATES-GUIDE.md 398 → 90(删除与 references/protocols.md 重复的协议正文)
  • references/thin-shells.md 345 → 204(per-tool 部分移到 per-tool-shells.md)
  • references/layout.md 306 → 173(Progressive Rigor 拆出;positioning 保留在内)
  • README.md / README.zh-CN.md 合计 612 → 316
  • UPSTREAM-CHANGES.md 277 → 178(较早条目归档到 archive 文件)

下游刷新的向后兼容

  • sync-routing.sh 仅在 .codex/instructions.md 已经存在时才把它保留在目标清单 —— 老下游继续收到 routing block 同步,新 scaffold 不会再引入该文件。
  • smoke-test.sh 把 .codex/instructions.md 视为可选(原为必需)。
  • update-upstream.md 新增一步:扫描上游的新 mechanism 文件 —— 下游 agent 自动 port 这次新增的 conformance 脚本集。
  • 所有 anchor 迁移(例如 WORKFLOW.md#phase-9-... → workflows/full-migration.md#phase-9-...)都在 UPSTREAM-CHANGES.md 中给刷新 agent 留了说明。

下游维护者跑 update-upstream 须知

升级后,agent 会:

  1. 扫描上游新增 mechanism 文件 → 多数项目需要复制 conformance.yaml、check-version-conformance.sh、_parse_conformance.py。
  2. 用上游 manifest(不是本地 snapshot)跑 conformance —— 本地 workflow 里缺哪段就把上游对应段 port 过来。
  3. 如果你的 harness 不读 .codex/instructions.md,可以选择删掉 skills/<name>/.codex/instructions.md。

完整 diff

v1.13.0..v1.14.0:84 个文件改动,5876 行新增、3179 行删除。

Assets 2
Loading