A2-A7 全部补齐到验收线;顺手把几处「门拦住却不给路」的坑填了

活动:A2 选型 / A3 寻源 / A4 定价 / A6 议价 / A7 归档五件各补成真活动包 ——
契约宽进(input.required 空,归一在活动内)、台账必填声明(含行级 requiredWhen)、
入场哨兵与 L1/L2 判据一律读基座数、两份件(在办可编辑 + 办结静态快照)、
三案例常备、包内自测。e2e 各三案例 released、行动被拒 0、发口正确、提交闸每单真拦。

基座(共享面,改一处影响所有活动,故每处都带回归):
· 重发判断走在站上场之前 —— 人答完那步常已收掉,readyToWork 先抛「不能再往它上面挂活」,
  于是「重发已答过的卡 = 无事发生」这条唯一活路在最需要时够不着,A1 基线当场熔断;
· 决策卡补幂等兜底(与执行工单同一把尺):头两次无事发生,第三次起才算被拒;
· 输出没成形先就地重问一次,原话进工作日志、不再摆上卡面;
· 工具调用读数 tool_<名>_calls —— 「机检只读基座数」这条纪律第一次覆盖到工具;
· 执行卡 steps/standard 补进出参 schema(从前能到卡面全靠厂商 JSON 模式宽松);
· 件的就地更新改逐节点 morph,保存先把新值镜像进只读那份 —— 不闪、不等回声。

A1(基线,全程守住):措辞三档对齐(必填/建议/选填)、禁止拿历史价当客户目标价、
卡骨架从步骤剧本搬进说明书(压成一拍连做时剧本没摊开,会发出没有指导书的裸卡)。

契约两处**新增可选字段**(非破坏):FieldDeclaration.requiredWhen、工单 finalHtml;
api-report 同批更新。docs/adr 与 docs/archive 的 13 份文件在工作树里不见了,
本次予以恢复而非提交删除。

门禁:typecheck / lint / depcruise / test(1366)全绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

.claude/skills/html-one-pager/references/block-catalog.md

@@ -0,0 +1,66 @@
+# 组件名录 —— 点菜用
+
+**用法:打开出处文件抄结构,别凭记忆写。** 行号会漂移,漂了就按名字 grep;
+名录与仓内源冲突时,以源为准。两种基调:文件件(A1)与 slide 件(A2),按件的性格选。
+原型的原始形态(带脚本演示页)在 `~/coding/JCAI_PRD/docs/活动执行页/`——
+版面节奏与演示脚本怎么配合,整件读它最直观。
+
+## 基调一 · 文件件(A1,`activities/quote-intake/src/views/report.ts`)
+
+纸面、章节头、逐段读下去 —— 执行页/验收页/归档页的默认基调。
+
+| 组件 | 出处(report.ts) | 是什么 · 何时用 |
+|---|---|---|
+| `doc()` 外壳三层 | `:265-289` | `<style>`+精灵+`.proto-root>.app-shell>.jc-stage>article.jc-report`+题头/正文/落款。骨架已内置同构,读它是为了懂结构 |
+| `part()` 章节头 | `:292` | `<b>标签</b><i class="ln">细线</i><em>右端小签</em>`——每个区块一条;编辑区的右端小签挂「可就地修订」 |
+| `sign()` 落款 | `:296` | 头像+署名(`case:owner`)+右端 `jc-done-tag` 流位签。签写「这份件在流里的位置」,不写状态 |
+| `ico()` 图标 | `:258` | `<use href="#i-名">` 引精灵 symbol |
+| `LETTER` 来源信件 | `:309` | `jc-letter`:收件签+归属 chip+正文 pre-wrap 原样照录+附件行(`data-rows="attachments"`) |
+| `four()` 要素四卡 | `:330` | `jc-four > jc-fcard ×4`;含 `jc-logo/jc-face` 方圆标(方=组织、圆=人,里面放图标)、`jc-count` 大数、`jc-segmeter` 一格一条料的刻度条 |
+| `listTable()` 可编辑表 | `:385` | `jc-tbl-wrap > table.jc-tbl-in`;`cell()` 工厂出 `req/opt/dimempty` 三态格;序号格 `jc-rn` 一列两用(读=行号,编辑=撤行 ×) |
+| `gapBar` 缺项红带 | `:438` | 「还差 N 格必填没补——差在哪」;挂 `data-class-of`,`v-0` 那档样式表隐藏 |
+| `editGate()` 编辑闸 | `:457` | 锁定说明+编辑/取消/保存三钮+`jc-editbar` 怎么改提示带 |
+| `addRowBar()` 加一行 | `:475` | 表尾虚线条;文案讲清「主键填了才存得下」 |
+| `DIST` 分布条 | `:501` | `jc-dist`:三段按条数分宽(`data-class-of` 投影 v-N 走宽度梯子)+图例 |
+| `dmnRow()/G2` 判定表 | `:598-628` | `jc-dmn` 按序求值三行+`jc-verdict` 去向横幅;命中行由壳上 `v-r1/r2/r3` 上色,「命中/未命中」两句都写在模版里、哪句现身由 class 定 |
+| `jc-acts` 落地动作 | `:679-693` | 「这一签下去会发生什么」三条;验收页收尾用 |
+| 说明带 | `:526-541` | `jc-derive`(这些数从哪来)/`jc-drop`(填报口径与边界);还有 `jc-callout/jc-hintline/jc-lockhint` 见 prd-style.ts |
+| 三张成品 | `:516 / :548 / :630` | INTAKE_OVERVIEW 执行页 / INTAKE_CLASSIFIED 中间态 / INTAKE_RELEASE 验收归档一张顶两身份——整件抄版面节奏最快的路 |
+
+**区块顺序的家族习惯**(INTAKE_RELEASE 是最全样本):来源 → 要素卡 → 分布/图形 →
+清单表(编辑区)→ 判定与去向 → 落地动作 → 落款。执行页砍掉判定/落地,多说明带。
+
+## 基调二 · slide 件(A2,`activities/quote-alternative/src/views/report.ts`)
+
+一页一屏、深空 hero、强视觉 —— 汇报页/对比页用。规范 §8.5 是它的成文版。
+
+| 组件 | 出处 | 是什么 |
+|---|---|---|
+| `ALT_WORKSHEET` | `:450` | 替代选型工作底稿(slide 语言成品) |
+| `ALT_ROSTER` | `:516` | 名册页成品 |
+| `data-page` 翻页 | `:335` | 多页件的页标记(`article.jc-duelrow` 一页一段),宿主按可见段分页 |
+
+hero 规矩:深底允许局部自备色组,但须与家族蓝紫呼应;`danger/ok/warn` 三色
+不得挪作气氛渲染(它们承载判定语义)。
+
+## 修饰类速查(prd-style.ts 全量定义,这里只列常用)
+
+- 排版:`.mono`(等宽)`.num`(数值,**左对齐**,与表头同侧)`.dim` `.sp` `.ln`
+- 语义色:`.ok .warn .bad` · 卡面色调 `t-teal / t-ok / t-warn / t-mute`
+- 格三态:`req`(必填,空了红胶囊)`opt`(选填,空了灰胶囊)`dimempty`(归档,空=「—」)
+- 投影后缀:`v-a/v-b/v-c`(类三色)`v-0..v-20`(计数:开关与宽度梯子)`v-r1/r2/r3`(判定命中)
+
+## 精灵 19 枚(`prd-style.ts` PRD_SPRITE)
+
+`alert arrow-right boxes building check copy file-check file-text git-branch history
+info lock mail-open pen plus sheet shield-check user x`
+
+缺图标怎么办:照 lucide 线稿风格(24×24 viewBox、stroke currentColor、round 线帽)
+**新增 symbol 进本件的精灵**,命名 `i-<名>`;平移时提醒活动开发 agent 给该活动的
+prd-style 补同名 symbol。不引图标库、不用 emoji。
+
+## 概念图形
+
+内联线稿 SVG(stroke currentColor、1.5-2 px 线宽)是报告的第一语言:流程走位、
+门前门后、数据流向,能画就画。图形也遵守不算不判——形状写死在模版里,
+只有上色/显隐可走 `data-class-of` 投影。

.claude/skills/html-one-pager/references/standalone-conventions.md

@@ -0,0 +1,50 @@
+# 目标件约定 —— 设计答案怎么交,平移才接得住
+
+目标件是**带脚本演示页**(照仓里 PRD 方法论):第一身份是给人看、给人认可的设计答案,
+第二身份是活动开发者平移的底稿。权威契约在 `docs/HTML报告生成规范.md`,本文只讲
+目标件这一侧的交付约定。
+
+## 1. 平移边界(骨架已标好)
+
+| 段 | 平移时 |
+|---|---|
+| doctype / head / 包装层 CSS(`⇩ standalone 包装层` 标记段) | 丢弃 |
+| PRD_CSS / BIND_CSS(assemble.py 抽来的) | 丢弃 —— 真模版从活动自己的 `views/` import |
+| ONE_CSS(本件自有补丁段) | **随模版走**,补在 BIND_CSS 之后;纪律与 BIND_CSS 同:只补不改 |
+| `⇩⇩ 模版片段` 到 `⇧⇧` 之间的标记 | 就是要平移的正文 |
+| 所有 `<script>` 标签 | **整段剥掉**(所以演示行为别写成内联 `on*=`,散在标记里剥不净) |
+| 尾部「平移指引」注释 | 给活动开发者读,不平移 |
+
+`<html class="editable">` 是给编辑态样式(闸/红带)显形用的;生产里由宿主挂,不进模版。
+
+## 2. 演示脚本的三条规矩
+
+1. **集中**:全部写在文尾的 `<script>` 标签里,标记面零内联事件(check.py 会拦);
+2. **初始画面自足**:脚本删掉后页面内容仍然完整正确 —— 脚本只做演示交互
+   (开编辑、改数重算、切状态),不负责造内容;
+3. **不引外部**:无 CDN、无外链(check.py 会拦)。
+
+## 3. 设计上行与建模欠账
+
+版面服务业务,不服务现有台账:来源标签、档位、命中留痕、数轴 —— 业务需要就摆,
+数字按人读形态(9.2% 不是 0.092)。代价是一笔账要记清:**平移指引的「建模欠账」清单**,
+逐条点名本件摆了、现有台账还没有的列与口径(该加哪张表哪一列、哪些该 required、
+存储口径要不要改人读形态)。欠账不记,平移的人分不清哪些是真数据哪些是设计愿望。
+
+能映射现有台账的格子,顺手预埋真钩子(`data-slot`/`data-col`/`data-edit`,键名逐字抄
+目标活动 `manifest.ts` 的 `declarations.ledger`)—— 省平移的事,但不为它牺牲版面。
+
+## 4. 示例数据真实感
+
+- PN 像 PN(`SS8050`、`TL072CDR`),价格量级对(阻容几分几毛、IC 几块几十),
+  年用量千/万级;业务素材见 `docs/MVP示例工作流.html`;
+- 人名/公司名用中文;报告上不摆系统内英文名(状态/表/列/口),表头一律人读名;
+- 演示的数自己要对得上账(偏离度 = (拟报−基准)÷基准 这类,逐行可复算);
+- 不编造没有来源的数据画面:真系统里没有写入方的数据,如实空着并写明为什么。
+
+## 5. 自检与走查
+
+- `python3 scripts/check.py 目标件.html` 13 条底线全绿(它不判设计);
+- 浏览器走查:整页读一遍(版面像不像家族、信息层次立不立得住)→ 点一遍演示交互
+  (编辑开不开、改数重算对不对)→ 拉窄窗口看响应式 → 尾部平移指引读一遍
+  (欠账清单是否把编的列全点到了)。

.claude/skills/html-one-pager/references/uipm-recipes.md

@@ -0,0 +1,50 @@
+# ui-ux-pro-max 查询菜谱
+
+ui-ux-pro-max 是本机的插件技能:一个 BM25 检索的本地设计库(84 风格 / 192 配色 /
+74 字体对 / 98 UX 守则 / 104 图标 / 25 图表)。**我们只用它的查询脚本拿设计方向,
+不装载它的整套工作流**——它的持久化步骤会往仓库写文件,字体/动效建议也与 JCAI
+契约相抵,见下面的过滤表。
+
+## 定位与调用
+
+```bash
+UIPM=$(ls -d ~/.claude/plugins/cache/ui-ux-pro-max-skill/ui-ux-pro-max/*/.claude/skills/ui-ux-pro-max 2>/dev/null | sort -V | tail -1)
+python3 "$UIPM/scripts/search.py" "<query>" --design-system -p "<件名>" --density 7
+```
+
+**缺席兜底**:`$UIPM` 为空(插件没装/被移除)时不装死——按「A1 版面语言 + 中高密度」
+的默认继续走,并在交付说明里写一句「设计库缺席,走了默认」。
+
+## 查询配方
+
+| 场景 | query 建议 | 旋钮 |
+|---|---|---|
+| 执行页(密表核对) | `enterprise b2b workflow document review data table form` | `--density 7`(仪表密度,信息多) |
+| 验收/归档页(仪式感) | `invoice quotation official document archive certificate` | `--density 5 --variance 4` |
+| 汇报/对比 slide | `executive summary comparison dashboard presentation` | `--density 6 --variance 6` |
+| 单域深挖 UX | `--domain ux` + `form table dense data review` | `-n 5` |
+| 单域深挖版面风格 | `--domain style` + `editorial minimal document swiss` | `-n 5` |
+
+0 结果:换一次关键词;仍空就走默认并明说,不编造「数据库推荐」。
+
+## 三不用(命令行层面)
+
+- `--persist` / `--output-dir`:会往仓库写 `design-system/<slug>/MASTER.md` —— 污染仓库
+- `--motion`:产出 GSAP JS 片段,而目标件零脚本
+- `--stack`:我们不是在选框架,产物是纯 HTML/CSS
+
+## 五不取 · 四要取(结果层面)
+
+| 它给的 | 取舍 | 为什么 |
+|---|---|---|
+| 字体对 + Google Fonts 外链 | **不取** | 目标件零外链;字体族固定 PRD_CSS 系统栈(Inter…PingFang SC) |
+| 配色替换 | **不取** | JCAI 家族令牌零改动(--brand #3370ff 等);`v-*` 语义色承载判定语义 |
+| GSAP/JS 动效 | **不取** | 零脚本。可译成纯 CSS 的意图(时长/缓动)可参考,且已有 reduced-motion 守卫 |
+| 图标库引用 | **不取** | 一律 PRD_SPRITE 内联 symbol(见 block-catalog) |
+| 任何 CDN/外部资源 | **不取** | 安装门与自检都拦 |
+| 版面构图(分栏/bento/层级) | **取** | 这正是要它出的「精美组件布局突出结构」 |
+| 组件形制(卡/带/表头/徽章的形) | **取** | 译成 JCAI 令牌下的 CSS |
+| 密度/留白档 | **取** | 执行页密、归档页缓 |
+| UX 守则(对比度/触达面积/反馈位置) | **取** | 出稿前对照检查 |
+
+**取的东西只进脑子,不落盘**——查询结果不存文件,消化成设计决定写进件里。