Human Alignment 把一个 product-context.yaml 渲染成人类回归项目时最关心的三件事:我们在哪、什么在等人、现实在哪里偏离了意图。数字由代码推导,文字由人撰写,两者分别标注,独立审计会拒绝发布模糊了这条界线的页面。相关决策见 docs/decisions/human-alignment.md。
用途与输出分为三个时钟不同的产物:一是事实平面(derive.mjs 输出 facts JSON),随每次计划文件提交更新,只有数据没有文字;二是脉搏(pulse.mjs),随时可查询,事件在读取时计算、从不写下来;三是定位文档(brief),按层生成而非按调用生成,含审慎措辞。默认推荐先运行脉搏,它回答人们真正想问的问题,耗时几秒且不会断言错误:node scripts/pulse.mjs --repo . [--since <commit>] [--json]。只有明确要求“生成可供入职阅读的文档”时才走简报流程,且需先向使用者说明其文字经过两次独立评估仍未通过、审计通过不代表其主张已核实。
简报流程分阶段,每阶段有可验证的后置条件:预检确认 product-context.yaml 存在并读取 manifest.json 基线;派生阶段运行 census.mjs 与 derive.mjs,facts JSON 是唯一合法数字来源,须通过 scripts/facts.schema.json 校验;架构扫描阶段运行 scan-workspace.mjs、arch-rules.mjs 与 receipt-consumer.mjs,缺少工作区清单或 archify CLI 时架构视图降级并在页面标明,不阻塞流程;撰写阶段复制 assets/template.html 并填充槽位,须遵守 references/guideline.md 的规则,例如每节先给结论句、数字必须绑定 data-fact、每个断言块须引用来源;审计阶段运行 audit.mjs,失败返回结构化回执,最多按所列修复重试两次;交付阶段运行 assemble.mjs,写入带时间与提交短哈希的 HTML,更新 manifest.json 并只保留最新三份。限制:不负责规划(/aep-envision)、任务分解(/aep-map)或设计理论(/aep-design-lens);控制平面缺陷由 scripts/coherence.mjs 负责,本技能只渲染其结果;手工编写的漂移被禁止,推导不出时该行保持沉默而非编造。