用途:把对话、笔记和记忆中仍未决定的决策(而非话题)汇总为一份 HTML 问卷,用户离线自行填写,答案再作为对齐依据返回,用于记录已定决策。
主要能力:已确定的点写入 intro 的“当前理解”摘要,并加一个前置文本问题询问其中哪里不对,而不是逐条重问。问卷用 questions.json 定义,构建命令为 python3 scripts/build.py questions.json -o alignment.html。生成页面含“Generate answers”按钮,输出 markdown,用户粘贴回来或下载为 .md。答案按 id 键解析,不按题号或措辞;把无答案的“开放”视为仍未决定,不要自行填写;已裁定决策带引用记录到项目存放处(设计文档、ADR、记忆)。
问题组成:一问一决策,题干含“and”则拆分。选项互斥,detail 写选择后果而非复述;标注推荐项,并保留“Other / needs discussion”出口。why 说明答案影响哪些下游工作,ref 指向证明框架的文件或行。showIf 仅用于真实依赖,被跳过的题仍出现在答案中并标记 skipped。决策对齐控制在约 15 题以内;大规模征集可用 section 分组、把非必需项标 optional,并告知用户可分次填写,草稿自动保存。
questions.json 字段:title、intro、outro、questions;每题有 id、label、section、question、why、ref、type、options、note、optional、showIf。type 为 single(默认)| multi | text;选择类需至少 2 个选项(可为纯字符串),text 渲染 textarea;note: true 在选项下加可选自由文本字段;optional: true 不计入已答数;section 变化时渲染标题;showIf 支持 is 或 not,针对前面某题的选项值。
限制与隐私:HTML 无依赖、离线运行,严格 CSP、无网络、草稿存 localStorage。存储键包含题目 id 列表,因此题目变更后重新生成会启动干净草稿而非恢复旧答案。内容涉及个人(财务、健康)时应说明:答案在用户交回前不会离开其机器。构建输出会显示类似 alignment.html 的题数与条件确认数,并做解析与校验;出错列出失败的 questions[i] 并非零退出。远程或 claude.ai 会话中可改为发布为 Artifact。