Governance Docs Codex Review
Documentsgovernance-docs-codex-reviewGovernance Docs Codex Review is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
【WHEN】当需要对“治理层文档”进行 Codex 审阅并输出 vN-review.md 时调用。 【WHEN NOT】不用于提案生成；不用于落地修改；不用于业务/代码设计。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/governance-docs-codex-review/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/governance-docs-codex-review, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Codex 治理层文档审阅（可拔插）
目标
- 只输出“打分制简报”到：docs/dev_notes/governance-docs-revision/v{N}-review.md
- 评分只包含两项：
- 问题解决（针对用户诉求/不满点/新增内容需求）
- 规则遵守（是否破坏 @governance-docs-standard）
输入（由调用方提供）
- 本次审阅对应的版本号：v{N}
- 治理层文档清单：
- README.md: {README_PATH}
- CLAUDE.md: {CLAUDE_PATH}
- 其他治理层文档: {GOVERNANCE_DOCS_LIST}
- 用户诉求摘要（可直接引用 v{N}.md 的“背景”段）
Step 0：同步 AGENTS.md（仅在 Codex 审阅时自动做）
- 通过 git 判断 {CLAUDE_PATH} 是否相对上一次提交发生变化：
- 若变化：将 {CLAUDE_PATH} 的内容完整复制覆盖到 AGENTS.md
- 若无变化：不处理
目的：让 Codex 默认加载的 AGENTS.md 与 CLAUDE.md 保持一致，仅在审阅时自动同步，节省日常上下文成本。
Step 1：调用 Codex 进行审阅
- 让 Codex 按“治理层文档清单”逐一检查，并以 @governance-docs-standard 为唯一规范依据。
- 检查重点（不扩展成更多维度）：
- 问题解决：用户诉求是否被有效覆盖
- 规则遵守：术语一致/去重引用/边界清晰/CLAUDE 是否被污染
Step 2：生成 v{N}-review.md（固定格式）
- 复审对象：治理层文档清单
- 评分（0-5）：
- 问题解决：扣分点 + 证据位置 + 修复建议（若有）
- 规则遵守：扣分点 + 证据位置 + 修复建议（若有）
- 总结：一句话结论 + 最关键的 1-3 个修复建议（若有）
证据位置书写约定（建议）
- 统一使用：{文件路径}#章节标题（或按项目约定使用行号范围）