治理
预发布闸门登记册——必填十五项检查
强制性十五关卡合规检查,于发出具有实质范围的工件之前运行,附带失败与行动的映射以及闸门结果模式。
十五关卡预发布闸门的规范登记册。 本文档承载完整的十五关卡闸门表格与闸门结果模式 YAML 块;实质性的表格与模式存放于此,并由
src/apothem/rules/pre-emission-gate.md操作化。
在发出任何有实质范围的工件之前(依据 site/content/docs/governance/outward-conformity-registry.mdx §1 中琐碎与非琐碎的阈值),运行十五关卡预发布闸门。可能时通过 PreToolUse 钩子实现机械化(由 src/apothem/conformity/gate.py 编排的、位于 src/apothem/conformity/*-grep.py 的机械 grep);无法机械化之处则通过推理完成。任一关卡失败即阻止发出;修订直至每道关卡都通过;发出时记录闸门结果。
| # | 关卡 | 检查种类 | 失败 → 行动 |
|---|---|---|---|
| 1 | M1 宿主无关性 | 推理判断 | 修订以匹配宿主约定 |
| 2 | M2 编辑披露 | 推理判断 | 添加披露账本 |
| 3 | M3 十项维度 | 混合(机械 + 推理判断) | 针对未通过的维度修订 |
| 4 | M4 自我应用 | 推理判断(存在验证块) | 记录验证块 |
| 5 | M5 权威 | 机械(<USER-CONFIRM:…> 占位符 grep) | 重新路由至询问表面 |
| 6 | M6 专业知识 | 推理判断(存在已揭示缺口章节) | 揭示缺口;引用 |
| 7 | M7 选项标注 | 机械(选项集带有推荐标记) | 添加标注 |
| 8 | M8 确定性 | 机械(含糊措辞词汇 grep) | 将含糊措辞提升为条件句 |
| 9 | M9 视觉杠杆 | 混合(机械:图示验证日期;推理判断:结构性之处存在图示) | 编写 / 刷新图示 |
| 10 | M10 双向绑定 | 机械(绑定互惠 grep) | 闭合半边 |
| 11 | M11 敏捷冲刺 | 推理判断(冲刺装置已实例化) | 重构为冲刺 |
| 12 | M12 阶段报告与布局 | 机械(孤儿输出 grep)+ 推理判断 | 编写汇总;重新定位 |
| 13 | M13 代码工艺 | 机械(lint / 格式化 / 类型检查;裸 except、魔法数字、注释掉代码 grep) | 修订 |
| 14 | M14 系统性 | 混合(机械:生产者来源;推理判断:声明上游 / 下游 / 同级 / 执行者) | 声明;编入索引 |
| 15 | M15 生产就绪 | 机械(production-ready-pr grep)+ 推理判断 | 添加测试 / 文档 / CHANGELOG |
1. 闸门结果模式
每次闸门运行都将结果记录在制品的工作轨迹中(隐藏注释、元数据块、独立的发射日志文件——以宿主惯例所允许者为准):
conformity-attestation:
artifact: <path-or-identifier>
ecosystem-version: <git-commit-sha-or-equivalent ratifying the rule set in force>
bars:
M1-host-agnosticism: pass | n/a (with reason)
M2-editorial-disclosure: pass | n/a
M3-ten-dimensions: pass | n/a
M4-self-application: pass
M5-authority: pass
M6-expertise: pass | n/a
M7-option-annotation: pass | n/a (no option set)
M8-definitiveness: pass
M9-visual-leverage: pass | n/a (subject not structural)
M10-bidirectional-binding: pass
M11-agile-sprints: pass | n/a (trivial work)
M12-phase-layout: pass | n/a
M13-code-craft: pass | n/a (not code)
M14-systemicity: pass
M15-production-ready: pass | n/a (no host-public-surface change)
surfaced-gaps: []
unresolved-inquiries: []
amendments-disclosed: []
date: <ISO-8601>n/a 标记是显式且经推理给出的——绝非静默跳过。ecosystem-version 字段将闸门结果锚定到用户范围生态系统的一个可复现状态(即闸门运行时处于活动状态的 Apothem 源码树 git 提交——例如 Claude Code 适配器的 ~/.claude/ 检出),以便未来的审计能够依据相同的规则正文重放该闸门。