六个活动的汇报界面与技能补齐;skill-engine 接上装配面

汇报界面(AM 07):
  · 视图外壳与卡片件提到 `@sdk`(viewShell / kvCard / tableCard / stagesCard / noteCard)——
    六个活动共用一套面貌,不各自发明;样式内联自带(沙箱页面不继承工作台 CSS)。
  · flow 四活动按**步序位置**挂模版:
    A1 事态全景 / 打标判据 / 成果预览;A4 取价基准 / 定价与门禁 / 草案待放行;
    A6 正式报价单 / 放行即发出;A7 结果登记 / 闭环待放行。
  · loop 两活动按**阶段与里程碑**组织:案例全景一屏,画阶段生命周期态、当下可为、目标缺口 ——
    素材全部来自语义引擎,零 LLM 即可成屏;模型只决定下一步做什么,不负责画面。
    为此给 loop-engine 补了视图端口,与 flow 共用同一个网关。
  · 每张模版都把「这一屏在说什么 / 放行意味着什么」写在数据旁边 ——
    人要在数据上作判断,判据就得摆在手边。

技能(AM 08):
  · 六个活动各写了 1–2 条真技能:适用描述 + 方法正文 + 结晶片段脚本。
    正文写的是**方法经验**而非流程复述(如「原文没写的不要补」「该等还是该问」
    「无基准不是异常,是一种基准」)。
  · 资源声明放**技能 ID**(权力面),资产放**定义本体**(方法面),两处分清。
  · **skill-engine 从来没有被构造过** —— 模块实现完整却无人调用,这是它一直没被用上的原因。
    容器里补上:目录与白名单都取自活动清单,装配前查扩权。
  · loop 的叙事面接入**技能目录**(渐进披露:常驻上下文只给「有哪些方法、何时适用」,
    正文等 AI 说要才加载),装配随即**盖戳入任务记忆** —— 回放与归因依赖之。

gates: tsc / eslint / depcruise(334 模块)/ 423 测试 全绿

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m

activities/quote-alternative/src/manifest.ts

@@ -6,6 +6,8 @@
  * `⏱时限过半` → 时间监听(**时限必配**)。
  */
 import type { ActivityManifest, DmnModel } from '@contracts';
+import { ALTERNATIVE_SKILLS } from './skills.ts';
+import { ALTERNATIVE_CASE } from './views/report.ts';
 import { activityIdSchema } from '@contracts';
 import { CMMN_XML, NARRATIVE } from './case-model.ts';
 
@@ -39,7 +41,7 @@ export const manifest: ActivityManifest = {
   identity: {
     activityId: ACTIVITY_ID,
     name: 'A2 · 替代选型',
-    packageVersion: '0.1.0',
+    packageVersion: '0.1.2',
     category: '统一报价',
     paradigm: 'loop',
     sdkVersion: '0.1.0-m5',
@@ -90,7 +92,7 @@ export const manifest: ActivityManifest = {
     },
     resources: {
       tools: [{ name: 'crm.history-price-read' }],
-      skills: [],
+      skills: ALTERNATIVE_SKILLS.map((s) => s.id),
       models: ['quote-extractor'],
       roles: ['FAE'],
       budget: { steps: 100, tokens: 260_000, activeMinutes: 360, humanCalls: 6 },
@@ -162,10 +164,8 @@ export const manifest: ActivityManifest = {
       narrative: NARRATIVE,
       dmn: GRADE_DMN,
     },
-    skills: [],
+    skills: ALTERNATIVE_SKILLS,
-    viewTemplates: [
+    viewTemplates: [{ name: 'case-overview', html: ALTERNATIVE_CASE }],
-      { name: 'alt-board', html: '<div class="jc-card"><h3>替代选型</h3><p data-slot="stage"></p></div>' },
-    ],
     cardSchemas: {},
     distillHooks: [
       { on: 'milestone', milestone: 'M_candidates', prompt: '归纳本轮撒网的有效角度与无效角度。' },

activities/quote-alternative/src/skills.ts

@@ -0,0 +1,45 @@
+/**
+ * A2 技能 —— 替代选型的方法经验(AM 08)。
+ */
+import { skillIdSchema } from '@contracts';
+import type { Skill } from '@contracts';
+
+export const ALTERNATIVE_SKILLS: Skill[] = [
+  {
+    id: skillIdSchema.parse('alternative.screen-candidates'),
+    label: '圈替代候选',
+    applicability: '原型号停产或缺货,要找替代时。',
+    method: [
+      '三层筛,一层比一层贵,所以要按顺序:',
+      '① **参数硬指标**:封装、电压范围、精度、温度等级 —— 不满足直接淘汰,不必往下看。',
+      '② **认证与合规**:车规 / 医疗 / 工业等级不可降级替代,客户没明说也不行。',
+      '③ **供应与价格**:到这一步才比价,前两层没过的便宜也没用。',
+      '',
+      '「Pin-to-pin 兼容」要看数据手册核实,不要信分销商的一句话 —— ',
+      '同封装不等于同引脚定义,这个错误要到打样才暴露。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: ['替代选型判据表'],
+    version: '1.0.0',
+  },
+  {
+    id: skillIdSchema.parse('alternative.ask-customer'),
+    label: '什么时候必须问客户',
+    applicability: '候选已圈定,但存在客户口径不明的项时。',
+    method: [
+      '这几件事**必须问**,不能替客户决定:',
+      '· 是否接受非原厂品牌;',
+      '· 是否接受参数降级(哪怕只降一档温度等级);',
+      '· 是否需要重新打样验证、由谁承担费用。',
+      '',
+      '问的方式是**跨任务征答**:卡以系统消息送到 BD 的消息要素,就地作答。',
+      '它不占对方的任务清单——那是一次性的解答请求,不是把责任转过去。',
+      '',
+      '问之前先把候选与判据整理好一并发过去:让对方**在数据上作判断**,',
+      '而不是回一句「你看着办」。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: [],
+    version: '1.0.0',
+  },
+];

activities/quote-alternative/src/views/report.ts

@@ -0,0 +1,26 @@
+/**
+ * A2 视图模版 —— 案例全景(AM 07:loop 按案例模型的阶段与里程碑组织汇报)。
+ */
+import { kvCard, noteCard, stagesCard, viewShell } from '@sdk';
+
+export const ALTERNATIVE_CASE = viewShell({
+  title: '替代选型 · 案例全景',
+  kicker: 'A2 · 案例活动(loop)',
+  tone: 'case',
+  body:
+    kvCard('本单标的', [
+      ['原型号', 'originalPn', 'mono'],
+      ['芯片类型', 'chipType'],
+      ['当前阶段', 'activeStage', 'tag'],
+      ['当下可为', 'enabledCount'],
+      ['目标缺口', 'gapCount'],
+    ]) +
+    stagesCard('阶段(CMMN)', 'case:stages', '阶段推进到 <b>Enabled</b> 为止;触达世界的计划项须人工启动。') +
+    stagesCard('当下可为', 'case:enabled') +
+    stagesCard('目标缺口', 'case:gaps', '缺口决定下一步是调人还是立监听。') +
+    noteCard(
+      '跨人卡',
+      '选型常要向 BD 补客户口径 —— 那是<b>跨任务征答</b>:卡以系统消息送达对方的消息要素、<b>就地作答</b>,' +
+        '不占对方的任务清单,也不开放本任务的对话流。它是一次性的解答请求,不是责任转移。',
+    ),
+});

activities/quote-archive/src/manifest.ts

@@ -5,7 +5,9 @@
  * 「不成交也留资产:情报、客户画像、落地率」—— 写的是**共享域**,跨活动的沉淀事实。
  */
 import type { ActivityManifest } from '@contracts';
+import { ARCHIVE_SKILLS } from './skills.ts';
 import { activityIdSchema } from '@contracts';
+import { ARCHIVE_LOGGED, ARCHIVE_RELEASE } from './views/report.ts';
 
 const ACTIVITY_ID = activityIdSchema.parse('quote-archive');
 
@@ -13,7 +15,7 @@ export const manifest: ActivityManifest = {
   identity: {
     activityId: ACTIVITY_ID,
     name: 'A7 · 情报归档',
-    packageVersion: '0.1.2',
+    packageVersion: '0.1.4',
     category: '统一报价',
     paradigm: 'flow',
     sdkVersion: '0.1.0-m5',
@@ -59,7 +61,7 @@ export const manifest: ActivityManifest = {
     authorization: { discretion: [], preauthorizedActions: [], humanCallBudget: 2 },
     resources: {
       tools: [],
-      skills: [],
+      skills: ARCHIVE_SKILLS.map((s) => s.id),
       models: ['quote-extractor'],
       roles: ['BD'],
       budget: { steps: 30, tokens: 60_000, activeMinutes: 60, humanCalls: 2 },
@@ -130,6 +132,7 @@ export const manifest: ActivityManifest = {
             type: 'object',
             properties: { lostReason: { type: 'string' }, competitorPrice: { type: 'number' } },
           },
+          view: 'archive-logged',
           failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
         },
         {
@@ -168,14 +171,16 @@ export const manifest: ActivityManifest = {
           workOrder: 'acceptance',
           card: { title: '情报归档请验收', deliverable: 'history-archive' },
           deadline: 'P1D',
+          view: 'archive-release',
           failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
         },
       ],
       parallelGroups: [],
     },
-    skills: [],
+    skills: ARCHIVE_SKILLS,
     viewTemplates: [
-      { name: 'archive-summary', html: '<div class="jc-card"><h3>归档闭环</h3><p data-slot="stats"></p></div>' },
+      { name: 'archive-logged', html: ARCHIVE_LOGGED },
+      { name: 'archive-release', html: ARCHIVE_RELEASE },
     ],
     cardSchemas: {},
     distillHooks: [

activities/quote-archive/src/skills.ts

@@ -0,0 +1,25 @@
+/**
+ * A7 技能 —— 归档的方法经验(AM 08)。
+ */
+import { skillIdSchema } from '@contracts';
+import type { Skill } from '@contracts';
+
+export const ARCHIVE_SKILLS: Skill[] = [
+  {
+    id: skillIdSchema.parse('archive.log-lost-reason'),
+    label: '把拒绝原因写成下一单的判据',
+    applicability: '客户拒绝或超时,要登记结果时。',
+    method: [
+      '「价格高」不是原因,是结论。要写的是**可比对的事实**:',
+      '· 竞对报价多少、差几个百分点;',
+      '· 输在价格、交期、还是资质/认证;',
+      '· 客户是否明说了可接受区间。',
+      '',
+      '判据要能被下一单**机器读取**:P-03 用「距上次报价 / 行情稳定」,P-01 用客户等级。',
+      '写成一段散文,它就只能被人读;写成字段,它才进得了决策表。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: [],
+    version: '1.0.0',
+  },
+];

activities/quote-archive/src/views/report.ts

@@ -0,0 +1,43 @@
+/**
+ * A7 视图模版 —— 归档两屏:结果登记 / 闭环待放行(AM 07)。
+ * 归档是这条流的收尾:它写回的是**下一单的判据**,所以要说清「这次学到了什么」。
+ */
+import { kvCard, noteCard, tableCard, viewShell } from '@sdk';
+
+export const ARCHIVE_LOGGED = viewShell({
+  title: '结果登记',
+  kicker: 'A7 · 情报归档',
+  tone: 'archive',
+  body:
+    kvCard('本单结果', [
+      ['型号 PN', 'pn', 'mono'],
+      ['报价日期', 'quotedAt', 'mono'],
+      ['拒绝原因', 'lostReason'],
+      ['竞对价位', 'competitor_price'],
+    ]) +
+    noteCard('为什么要登记', '拒绝原因与竞对价位是<b>下一单的判据</b>:它们回写历史价格情报,供 P-03 的「距上次报价 / 行情稳定」与 P-01 的客户等级因子取用。这一单的败仗,是下一单的地形图。'),
+});
+
+export const ARCHIVE_RELEASE = viewShell({
+  title: '情报归档 · 闭环待放行',
+  kicker: 'A7 · 成果预览',
+  tone: 'ok',
+  body:
+    tableCard('历史价格情报回写', 'mine:shared.history_price', [
+      ['型号', 'pn', 'mono'],
+      ['报价日期', 'quoted_at', 'mono'],
+      ['拒绝原因', 'lost_reason'],
+    ]) +
+    kvCard('画像与落地率', [
+      ['客户编码', 'customer_code', 'mono'],
+      ['画像标签', 'profile_tags'],
+      ['统计周期', 'period', 'mono'],
+      ['落地率', 'landing_rate'],
+    ]) +
+    noteCard(
+      '闭环的含义',
+      '放行后这条工作流走到<b>终点节点</b>,状态收敛为「已完成」。' +
+        '终态封卷触发<b>蒸馏钩子</b>:从任务记忆归纳出活动记忆的候选条目(带证据链),' +
+        '经回放与人放行才成为下一版业务模型的一部分 —— <b>记忆不载权力</b>。',
+    ),
+});

activities/quote-intake/src/manifest.ts

@@ -7,6 +7,7 @@
  *   SLA(受理<15min、打标<45min)→ Harness 时限与预算。
  */
 import type { ActivityManifest, DmnModel } from '@contracts';
+import { INTAKE_SKILLS } from './skills.ts';
 import { activityIdSchema } from '@contracts';
 import { INTAKE_CLASSIFIED, INTAKE_OVERVIEW, INTAKE_RELEASE } from './views/report.ts';
 
@@ -41,7 +42,7 @@ export const manifest: ActivityManifest = {
   identity: {
     activityId: ACTIVITY_ID,
     name: 'A1 · RFQ 需求分析',
-    packageVersion: '0.1.7',
+    packageVersion: '0.1.8',
     category: '统一报价',
     paradigm: 'flow',
     sdkVersion: '0.1.0-m5',
@@ -102,7 +103,7 @@ export const manifest: ActivityManifest = {
     },
     resources: {
       tools: [{ name: 'crm.history-price-read' }],
-      skills: [],
+      skills: INTAKE_SKILLS.map((s) => s.id),
       models: ['quote-extractor'],
       roles: ['BD'],
       budget: { steps: 40, tokens: 120_000, activeMinutes: 60, humanCalls: 4 },
@@ -289,7 +290,7 @@ export const manifest: ActivityManifest = {
       ],
       parallelGroups: [],
     },
-    skills: [],
+    skills: INTAKE_SKILLS,
     // 三张模版对应三种局面(事态全景 / 进展 / 成果预览),由步序声明按位置推送
     viewTemplates: [
       { name: 'intake-overview', html: INTAKE_OVERVIEW },

activities/quote-intake/src/skills.ts

@@ -0,0 +1,53 @@
+/**
+ * A1 技能 —— 工具用法的方法经验(AM 08)。
+ *
+ * 「白名单回答『能用什么』(权力),技能回答『怎么用好』(方法)——棋子确定,棋谱是资产。」
+ * 每条技能 = 适用描述(何时适用)+ 方法正文(怎么判断、怎么编排工具)
+ *          + 结晶片段脚本(可选:反复出现的确定性子序列)。
+ *
+ * **载方法,不载权力**:这里提到的工具都在本活动白名单内;技能不扩权、不改约。
+ */
+import { skillIdSchema } from '@contracts';
+import type { Skill } from '@contracts';
+
+export const INTAKE_SKILLS: Skill[] = [
+  {
+    id: skillIdSchema.parse('intake.read-rfq'),
+    label: '读懂一封询价',
+    applicability: '收到客户询价原文,需要拆成逐条需求时。正文格式五花八门:表格、纯文本、附件转述都可能。',
+    method: [
+      '先找**锚点**再抄字段:PN 通常是连续的字母数字混排(如 LM358DR),年用量常带「K/片/pcs/年用量/EAU」,',
+      '目标价常带货币符号或「目标价/target」,交期常带「周/weeks/wks/交期/lead」。',
+      '',
+      '三条纪律:',
+      '① **原文没写的不要补**。宁可标 missingKeyFields,也不要按常识填一个「合理值」——',
+      '   受理阶段编出来的数,会一路流到定价和报价单上,越往后越难发现。',
+      '② **单位归一但不换算口径**:12K → 12000 可以;「月用量 1000」不要自作主张乘 12,',
+      '   那是业务判断,该走补全卡问客户。',
+      '③ **一条需求一行**。同一 PN 不同数量档是两行,不是一行的两个值。',
+      '',
+      '拆不动就交人:缺 PN / 数量 / 交期任一,把 missingKeyFields 加一,让 D1 判断把补全卡发出去。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: ['《询价受理规范》'],
+    version: '1.0.0',
+  },
+  {
+    id: skillIdSchema.parse('intake.classify-basis'),
+    label: '打标前先备齐判据',
+    applicability: '要对料号做三分类(P-03)之前,判据不全时。',
+    method: [
+      'P-03 只认三个入参:距上次报价天数、行情是否稳定、生命周期状态。三者齐了,结论是**算出来**的,不是判出来的。',
+      '',
+      '所以打标前唯一该做的事是**把判据取齐**:调历史价情报工具,拿回这三项。',
+      '取不到(新料号无历史)不是错误——工具会回「无历史」,那本身就是判据:',
+      '距上次报价记为极大值 → 命中 B 类「重估后报」,这是对的,新料号本就该重估。',
+      '',
+      '不要绕过决策表自己判。规则表是可回放、可追责的;临场判断不是。',
+    ].join('\n'),
+    // 结晶片段:反复出现的确定性子序列 —— 取历史价这一步每单都一样
+    crystallized: [{ tool: 'crm.history-price-read', input: { pn: 'pn' } }],
+    knowledgeRefs: ['三分类规则 P-03'],
+    version: '1.0.0',
+  },
+];

activities/quote-intake/src/views/report.ts

@@ -1,133 +1,77 @@
 /**
- * A1 视图模版 —— 视图区呈现的 HTML(AM 07)。
+ * A1 视图模版 —— 三种局面:事态全景 / 打标判据 / 成果预览(AM 07)。
- *
+ * 外壳与卡片件来自 `@sdk`:六个活动共用一套面貌,不各自发明。
- * 「模版是**内容**不是代码」:这里没有脚本、没有事件处理器、没有外链;
- * 槽位 `data-slot` 由基座按任务视图填数,行模版 `data-rows` 逐条展开。
- * 容器是沙箱 iframe(无脚本执行权),所以样式必须内联自带 —— 页面不继承工作台的 CSS。
- *
- * 三张模版对应三种局面(事态全景 / 进展 / 成果预览),按步序位置推送。
  */
+import { kvCard, noteCard, tableCard, viewShell } from '@sdk';
 
-/** 共用外壳:一套克制的排版,深浅色都能看 */
+export const INTAKE_OVERVIEW = viewShell({
-const SHELL = (title: string, kicker: string, accent: string, body: string): string => `
+  title: 'RFQ 受理全景',
-<style>
+  kicker: 'A1 · 统一受理',
-  :root { color-scheme: light; }
+  tone: 'brand',
-  * { box-sizing: border-box; }
+  body:
-  body {
+    kvCard('询价来源', [
-    margin: 0; padding: 18px;
+      ['客户编码', 'customer_code', 'mono'],
-    font: 13px/1.6 -apple-system, "PingFang SC", "Noto Sans SC", "Segoe UI", sans-serif;
+      ['询价单号', 'rfqRef', 'mono'],
-    color: #1f2933; background: #f7f8fa;
+      ['主题', 'subject'],
-  }
+    ]) +
-  .wrap { max-width: 720px; margin: 0 auto; }
+    kvCard('归一结果', [
-  .hd { display: flex; align-items: flex-start; gap: 12px; margin-bottom: 14px; }
+      ['型号 PN', 'pn', 'mono'],
-  .hd .bar { width: 4px; align-self: stretch; border-radius: 2px; background: ${accent}; }
+      ['厂牌', 'brand'],
-  .hd .kick { font-size: 11px; letter-spacing: .08em; color: #6a7686; text-transform: uppercase; }
+      ['年用量 EAU', 'eau'],
-  .hd h1 { margin: 2px 0 0; font-size: 17px; font-weight: 650; letter-spacing: .01em; }
+      ['目标价', 'target_price'],
-  .card { background: #fff; border: 1px solid #e6e9ee; border-radius: 10px; padding: 14px 16px; margin-bottom: 12px; }
+      ['交期', 'lead_time'],
-  .card h2 { margin: 0 0 10px; font-size: 12px; font-weight: 600; color: #6a7686; letter-spacing: .04em; }
+      ['缺关键字段', 'missing_key_fields'],
-  .kv { display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 10px 18px; }
+    ]) +
-  .kv div { min-width: 0; }
+    noteCard('这一屏在说什么', '归一由模型从询价原文抽取,逐条落<b>任务级草稿层</b>:本任务可见、正式版不可见、不产生数据事件。放行前的一切都还改得动。'),
-  .kv em { display: block; font-style: normal; font-size: 11px; color: #8b95a3; margin-bottom: 2px; }
+});
-  .kv b { font-size: 14px; font-weight: 600; word-break: break-all; }
-  table { width: 100%; border-collapse: collapse; font-size: 12px; }
-  th { text-align: left; font-weight: 600; color: #6a7686; padding: 6px 8px; border-bottom: 1px solid #e6e9ee; white-space: nowrap; }
-  td { padding: 7px 8px; border-bottom: 1px solid #f0f2f5; }
-  tr:last-child td { border-bottom: 0; }
-  .mono { font-family: "SF Mono", Menlo, Consolas, monospace; font-size: 12px; }
-  .tag { display: inline-block; padding: 1px 8px; border-radius: 999px; font-size: 11px; font-weight: 600;
-         background: ${accent}1a; color: ${accent}; }
-  .note { font-size: 11px; color: #8b95a3; margin-top: 10px; line-height: 1.7; }
-  .empty { color: #a8b0bb; font-size: 12px; padding: 6px 0; }
-</style>
-<div class="wrap">
-  <div class="hd"><span class="bar"></span><div><div class="kick">${kicker}</div><h1>${title}</h1></div></div>
-  ${body}
-</div>`;
 
-/** ① 事态全景:受理刚开始,先把「这一单是什么」摆清楚 */
+export const INTAKE_CLASSIFIED = viewShell({
-export const INTAKE_OVERVIEW = SHELL(
+  title: '料号分类与判据',
-  'RFQ 受理全景',
+  kicker: 'A1 · 三分类 P-03',
-  'A1 · 统一受理',
+  tone: 'ok',
-  '#3370ff',
+  body:
-  `<div class="card">
+    kvCard('分类结论', [
-     <h2>询价来源</h2>
+      ['型号 PN', 'pn', 'mono'],
-     <div class="kv">
+      ['Type 标', 'type_tag', 'tag'],
-       <div><em>客户编码</em><b class="mono" data-slot="customer_code"></b></div>
+      ['分级依据', 'basis'],
-       <div><em>询价单号</em><b class="mono" data-slot="rfqRef"></b></div>
+    ]) +
-       <div><em>主题</em><b data-slot="subject"></b></div>
+    kvCard('打标判据(DMN 入参)', [
-     </div>
+      ['距上次报价', 'history_days'],
-   </div>
+      ['行情稳定', 'market_stable'],
-   <div class="card">
+      ['生命周期', 'lifecycle'],
-     <h2>归一结果</h2>
+      ['历史价命中', 'history_hit'],
-     <div class="kv">
+    ]) +
-       <div><em>型号 PN</em><b class="mono" data-slot="pn"></b></div>
+    noteCard(
-       <div><em>厂牌</em><b data-slot="brand"></b></div>
+      '为什么是确定性的',
-       <div><em>年用量 EAU</em><b data-slot="eau"></b></div>
+      '三分类规则 P-03 是<b>决策表</b>不是模型判断:同样的判据必得同样的结论,零方差零 token,命中的规则行随出参留痕。' +
-       <div><em>目标价</em><b data-slot="target_price"></b></div>
+        'A = 直接快答;B = 重估后报(转寻源);C = 转案处理(转替代选型)。',
-       <div><em>交期</em><b data-slot="lead_time"></b></div>
+    ),
-       <div><em>缺关键字段</em><b data-slot="missing_key_fields"></b></div>
+});
-     </div>
-     <p class="note">归一由模型从询价原文抽取,逐条落任务级草稿层;放行前不入正式版。</p>
-   </div>`,
-);
 
-/** ② 进展:打标之后,把判据摊开 —— 人要在数据上作判断,数据就得摆出来 */
+export const INTAKE_RELEASE = viewShell({
-export const INTAKE_CLASSIFIED = SHELL(
+  title: '统一受理记录 · 待放行',
-  '料号分类与判据',
+  kicker: 'A1 · 成果预览',
-  'A1 · 三分类 P-03',
+  tone: 'case',
-  '#0aa294',
+  body:
-  `<div class="card">
+    tableCard(
-     <h2>分类结论</h2>
+      '本单交付',
-     <div class="kv">
+      'mine:quote_intake.record',
-       <div><em>型号 PN</em><b class="mono" data-slot="pn"></b></div>
+      [
-       <div><em>Type 标</em><b class="tag" data-slot="type_tag"></b></div>
+        ['型号', 'pn', 'mono'],
-       <div><em>分级依据</em><b data-slot="basis"></b></div>
+        ['厂牌', 'brand'],
-     </div>
+        ['年用量', 'eau'],
-   </div>
+        ['目标价', 'target_price'],
-   <div class="card">
+        ['交期', 'lead_time'],
-     <h2>打标判据(DMN 入参)</h2>
+      ],
-     <div class="kv">
+      '只列<b>本单</b>写下的行 —— 别单放行过的记录不混进来。',
-       <div><em>距上次报价</em><b data-slot="history_days"></b></div>
+    ) +
-       <div><em>行情稳定</em><b data-slot="market_stable"></b></div>
+    kvCard('分流去向', [
-       <div><em>生命周期</em><b data-slot="lifecycle"></b></div>
+      ['Type 标', 'type_tag', 'tag'],
-       <div><em>历史价命中</em><b data-slot="history_hit"></b></div>
+      ['依据', 'basis'],
-     </div>
+    ]) +
-     <p class="note">
+    noteCard(
-       三分类规则 P-03 是确定性决策表:同样的判据必得同样的结论,零方差零 token。
+      '放行意味着什么',
-       A = 直接快答;B = 重估后报(转寻源);C = 转案处理(转替代选型)。
+      '放行通过<b>即刻落地</b>:草稿层合并入正式版、数据事件此刻才发射,G2 网关按 Type 分流。' +
-     </p>
+        '放行是草稿态与事实态之间的那道门 —— 门前的都还改得动,门后的都算数了。',
-   </div>`,
+    ),
-);
+});
-
-/** ③ 成果预览:验收放行前的最后一屏 —— 要放行的到底是什么,一眼看全 */
-export const INTAKE_RELEASE = SHELL(
-  '统一受理记录 · 待放行',
-  'A1 · 成果预览',
-  '#7f3bf5',
-  `<div class="card">
-     <h2>本单交付</h2>
-     <table>
-       <thead><tr><th>型号</th><th>厂牌</th><th>年用量</th><th>目标价</th><th>交期</th></tr></thead>
-       <tbody data-rows="mine:quote_intake.record">
-         <tr>
-           <td class="mono" data-slot="pn"></td>
-           <td data-slot="brand"></td>
-           <td data-slot="eau"></td>
-           <td data-slot="target_price"></td>
-           <td data-slot="lead_time"></td>
-         </tr>
-       </tbody>
-     </table>
-   </div>
-   <div class="card">
-     <h2>分流去向</h2>
-     <div class="kv">
-       <div><em>Type 标</em><b class="tag" data-slot="type_tag"></b></div>
-       <div><em>依据</em><b data-slot="basis"></b></div>
-     </div>
-     <p class="note">
-       放行通过即刻落地:草稿层合并入正式版、数据事件此刻才发射,G2 网关按 Type 分流。
-       放行是草稿态与事实态之间的那道门 —— 门前的一切都还改得动,门后的都算数了。
-     </p>
-   </div>`,
-);

activities/quote-negotiate/src/manifest.ts

@@ -6,7 +6,9 @@
  * 放行通过即落地(台账回写 + 出站发送)→ 输出口发射;并建 D+3 跟进监听。
  */
 import type { ActivityManifest } from '@contracts';
+import { NEGOTIATE_SKILLS } from './skills.ts';
 import { activityIdSchema } from '@contracts';
+import { QUOTE_COMPOSED, QUOTE_RELEASE } from './views/report.ts';
 
 const DOMAIN = 'quote_negotiate';
 const ACTIVITY_ID = activityIdSchema.parse('quote-negotiate');
@@ -15,7 +17,7 @@ export const manifest: ActivityManifest = {
   identity: {
     activityId: ACTIVITY_ID,
     name: 'A6 · 报价议价',
-    packageVersion: '0.1.2',
+    packageVersion: '0.1.4',
     category: '统一报价',
     paradigm: 'flow',
     sdkVersion: '0.1.0-m5',
@@ -69,7 +71,7 @@ export const manifest: ActivityManifest = {
     },
     resources: {
       tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
-      skills: [],
+      skills: NEGOTIATE_SKILLS.map((s) => s.id),
       models: ['quote-extractor'],
       roles: ['BD'],
       budget: { steps: 50, tokens: 120_000, activeMinutes: 60, humanCalls: 3 },
@@ -150,6 +152,7 @@ export const manifest: ActivityManifest = {
             required: ['lines'],
             properties: { lines: { type: 'array' }, validityDays: { type: 'integer' } },
           },
+          view: 'quote-composed',
           failure: { retry: { times: 2, backoff: 'PT30S' }, fallback: { kind: 'human', workOrder: 'execution' } },
         },
         {
@@ -168,14 +171,16 @@ export const manifest: ActivityManifest = {
           workOrder: 'acceptance',
           card: { title: '正式报价单请验收 —— 放行即发出', deliverable: 'formal-quote' },
           deadline: 'P1D',
+          view: 'quote-release',
           failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
         },
       ],
       parallelGroups: [],
     },
-    skills: [],
+    skills: NEGOTIATE_SKILLS,
     viewTemplates: [
-      { name: 'quote-preview', html: '<div class="jc-card"><h3>正式报价单</h3><p data-slot="lines"></p></div>' },
+      { name: 'quote-composed', html: QUOTE_COMPOSED },
+      { name: 'quote-release', html: QUOTE_RELEASE },
     ],
     cardSchemas: {},
     distillHooks: [{ on: 'terminal', prompt: '归纳本单议价的经验:客户的还价幅度、成交与否的关键因素。' }],

activities/quote-negotiate/src/skills.ts

@@ -0,0 +1,42 @@
+/**
+ * A6 技能 —— 议价与出单的方法经验(AM 08)。
+ */
+import { skillIdSchema } from '@contracts';
+import type { Skill } from '@contracts';
+
+export const NEGOTIATE_SKILLS: Skill[] = [
+  {
+    id: skillIdSchema.parse('negotiate.compose-quote'),
+    label: '拟一份能发出去的报价单',
+    applicability: '定价已过审批,要生成正式报价单时。',
+    method: [
+      '报价单是**要发给客户**的东西,所以每一项都得能兑现:',
+      '· 单价与交期照审批通过的草案抄,不做任何「顺手优化」——改价要重新过审批点。',
+      '· SPQ / MOQ / 贸易条款 / 有效期缺一不可:缺了客户会追问,追问就是又一轮往返。',
+      '· 有效期按行情波动定,不要一律写「长期有效」——那等于把汇率与料价风险自己扛了。',
+      '',
+      '拿不准的项**宁可空着走补全**,不要填一个看起来合理的值:',
+      '报价单一旦发出就是承诺,发出前的空白是成本,发出后的错误是损失。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: ['报价单模版规范'],
+    version: '1.0.0',
+  },
+  {
+    id: skillIdSchema.parse('negotiate.pick-outcome'),
+    label: '选对议价出口',
+    applicability: '客户回复后,要确认议价结果出口时。',
+    method: [
+      '三个出口对应三种后续,**恰发一口**:',
+      '· 成交 → 转订单履约,这条流走到终点。',
+      '· 有异议 → 回 A4 重开新实例重算 —— 注意是**新实例**,旧的已终、不再入算。',
+      '· 拒绝 / 超时 → 转 A7 情报归档:把拒绝原因与竞对价位登记下来。',
+      '',
+      '「拒绝」不是失败终态。这一单丢了,但拒绝原因回写历史情报后,',
+      '下一单的三分类与利润模型会用上它 —— 这才是归档存在的理由。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: [],
+    version: '1.0.0',
+  },
+];

activities/quote-negotiate/src/views/report.ts

@@ -0,0 +1,50 @@
+/**
+ * A6 视图模版 —— 议价两屏:正式报价单 / 待放行即发出(AM 07)。
+ * 这是**唯一会触达外界**的活动:放行一刻要发信、要回写台账,所以那一屏必须说清后果。
+ */
+import { kvCard, noteCard, tableCard, viewShell } from '@sdk';
+
+export const QUOTE_COMPOSED = viewShell({
+  title: '正式报价单',
+  kicker: 'A6 · 报价议价',
+  tone: 'brand',
+  body:
+    kvCard('报价抬头', [
+      ['报价单号', 'quoteNo', 'mono'],
+      ['客户编码', 'customerCode', 'mono'],
+      ['型号 PN', 'pn', 'mono'],
+    ]) +
+    kvCard('报价条款', [
+      ['单价', 'unit_price'],
+      ['交期', 'lead_time'],
+      ['最小包装量 SPQ', 'spq'],
+      ['最小起订量 MOQ', 'moq'],
+      ['贸易条款', 'trade_terms'],
+      ['有效期', 'valid_until'],
+    ]) +
+    noteCard('这一步还没碰外界', '报价单此刻只是<b>草稿</b>。发出动作是<b>写类</b>的,过程中只登记为「动作意向」——入参冻结、等放行,放行前一封信都不会发出去。'),
+});
+
+export const QUOTE_RELEASE = viewShell({
+  title: '正式报价单 · 放行即发出',
+  kicker: 'A6 · 成果预览',
+  tone: 'danger',
+  body:
+    tableCard(
+      '本单报价',
+      'mine:quote_negotiate.formal_quote',
+      [
+        ['报价单号', 'quote_no', 'mono'],
+        ['型号', 'pn', 'mono'],
+        ['单价', 'unit_price'],
+        ['交期', 'lead_time'],
+      ],
+    ) +
+    noteCard(
+      '按下放行会发生什么',
+      '① <b>落地预检</b>先跑:交付物齐备、动作意向可执行、授权在契约边界内 —— 预检不过不发卡。' +
+        '② 放行通过<b>即刻落地</b>:台账回写 + 出站发送(报价单发给客户),动作附幂等键。' +
+        '③ <b>落地收敛</b>后输出口才发射 —— 下游只见落地完成的任务;已成动作留存<b>不回滚</b>。' +
+        '④ 出口三选一(成交 / 有异议 / 拒绝)<b>恰发一口</b>,随放行一并确认,G4 网关按它分流。',
+    ),
+});

activities/quote-pricing/src/manifest.ts

@@ -6,7 +6,9 @@
  * **全部装进 DMN 决策表确定性求值**;一旦出现「由 AI 决定怎么办」,按 AM 2.1 上升。
  */
 import type { ActivityManifest, DmnModel } from '@contracts';
+import { PRICING_SKILLS } from './skills.ts';
 import { activityIdSchema } from '@contracts';
+import { PRICING_BASIS, PRICING_PRICED, PRICING_RELEASE } from './views/report.ts';
 
 const DOMAIN = 'quote_pricing';
 const ACTIVITY_ID = activityIdSchema.parse('quote-pricing');
@@ -59,7 +61,7 @@ export const manifest: ActivityManifest = {
   identity: {
     activityId: ACTIVITY_ID,
     name: 'A4 · 成本定价',
-    packageVersion: '0.1.3',
+    packageVersion: '0.1.5',
     category: '统一报价',
     paradigm: 'flow',
     sdkVersion: '0.1.0-m5',
@@ -114,7 +116,7 @@ export const manifest: ActivityManifest = {
     },
     resources: {
       tools: [{ name: 'quote-pricing.basis' }, { name: 'crm.history-price-read' }],
-      skills: [],
+      skills: PRICING_SKILLS.map((s) => s.id),
       models: ['quote-extractor'],
       roles: ['BD'],
       budget: { steps: 60, tokens: 150_000, activeMinutes: 120, humanCalls: 3 },
@@ -171,6 +173,7 @@ export const manifest: ActivityManifest = {
           // 取回来的是**基准价**;偏离率要等 S2 定出拟报价才算得出来(见 S2B)
           output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { last_price: 'lastPrice' } },
           tool: 'crm.history-price-read',
+          view: 'pricing-basis',
           failure: { retry: { times: 2, backoff: 'PT1M' }, fallback: { kind: 'human', workOrder: 'execution' } },
         },
         {
@@ -203,6 +206,7 @@ export const manifest: ActivityManifest = {
           input: { deviation: 'deviation' },
           output: { domain: DOMAIN, object: 'draft', key: { pn: 'pn' }, fields: { disposition: 'disposition' } },
           tool: 'quote-pricing.floor-gate',
+          view: 'pricing-priced',
           failure: { retry: { times: 1, backoff: 'PT10S' }, fallback: { kind: 'blocked' } },
         },
         {
@@ -225,17 +229,17 @@ export const manifest: ActivityManifest = {
           workOrder: 'acceptance',
           card: { title: '报价草案(全条目带偏离度)请验收', deliverable: 'quote-draft' },
           deadline: 'P1D',
+          view: 'pricing-release',
           failure: { retry: { times: 0, backoff: 'PT30S' }, fallback: { kind: 'blocked' } },
         },
       ],
       parallelGroups: [],
     },
-    skills: [],
+    skills: PRICING_SKILLS,
     viewTemplates: [
-      {
+      { name: 'pricing-basis', html: PRICING_BASIS },
-        name: 'pricing-summary',
+      { name: 'pricing-priced', html: PRICING_PRICED },
-        html: '<div class="jc-card"><h3>报价草案</h3><p>已定价 <b data-slot="count"></b> 条</p></div>',
+      { name: 'pricing-release', html: PRICING_RELEASE },
-      },
     ],
     cardSchemas: {},
     distillHooks: [

activities/quote-pricing/src/skills.ts

@@ -0,0 +1,41 @@
+/**
+ * A4 技能 —— 定价的方法经验(AM 08)。载方法,不载权力。
+ */
+import { skillIdSchema } from '@contracts';
+import type { Skill } from '@contracts';
+
+export const PRICING_SKILLS: Skill[] = [
+  {
+    id: skillIdSchema.parse('pricing.pick-basis'),
+    label: '选对价格基准',
+    applicability: '定价开始,需要确定「跟谁比」时。',
+    method: [
+      '基准的优先级:① 本客户近期成交价 → ② 同型号他客户成交价 → ③ 供应商底价表 → ④ 无基准。',
+      '越靠前越贴近这一单的真实议价空间;越靠后越要留余量。',
+      '',
+      '**无基准不是异常**,是一种基准:新料号、久未报价的老料号都会落到这里。',
+      '此时偏离率记 0(没有可偏离的对象),由底价门禁按「无基准」放行 —— ',
+      '不要拿一个不相干的价去凑一个偏离率出来,那比没有基准更危险:它看起来像有依据。',
+    ].join('\n'),
+    crystallized: [{ tool: 'crm.history-price-read', input: { pn: 'pn' } }],
+    knowledgeRefs: ['利润模型 P-01'],
+    version: '1.0.0',
+  },
+  {
+    id: skillIdSchema.parse('pricing.read-gate'),
+    label: '读懂底价门禁的处置',
+    applicability: '底价门禁(P-02)给出处置结论,需要决定下一步时。',
+    method: [
+      '门禁不是「拦下」而是**分流**:',
+      '· 直接放行 —— 偏离在容许带内,照常提审。',
+      '· 超限待裁 —— 偏离超 ±20%,交人决断:回调价格,还是注明理由硬报。',
+      '  两条路都合法,但都要留下**理由**:这条留痕将来会成为客户等级与利润模型的迭代素材。',
+      '',
+      '不要为了让门禁「过」而回头改毛利参数 —— 那是把判据改成结论,',
+      '决策表就失去了它唯一的价值:同输入必同结论。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: ['底价门禁 P-02'],
+    version: '1.0.0',
+  },
+];

activities/quote-pricing/src/views/report.ts

@@ -0,0 +1,67 @@
+/**
+ * A4 视图模版 —— 定价的三屏:取价基准 / 定价与门禁 / 报价草案待放行(AM 07)。
+ * 定价这件事最需要「把判据摊开」:人签的不是一个数字,是这个数字的来路。
+ */
+import { kvCard, noteCard, tableCard, viewShell } from '@sdk';
+
+export const PRICING_BASIS = viewShell({
+  title: '取价基准',
+  kicker: 'A4 · 成本定价',
+  tone: 'brand',
+  body:
+    kvCard('本单标的', [
+      ['客户编码', 'customerCode', 'mono'],
+      ['型号 PN', 'pn', 'mono'],
+      ['物料类型', 'materialType', 'tag'],
+    ]) +
+    kvCard('价格基准', [
+      ['上次成交价', 'last_price'],
+      ['客户等级', 'customerGrade'],
+      ['数量档', 'volumeTier'],
+    ]) +
+    noteCard('基准从哪来', '基准价取自历史价情报(CRM)。新料号无历史时基准记 0,由底价门禁按<b>无基准</b>处置 —— 不凭空编一个偏离率出来。'),
+});
+
+export const PRICING_PRICED = viewShell({
+  title: '定价与底价门禁',
+  kicker: 'A4 · DMN 两表',
+  tone: 'ok',
+  body:
+    kvCard('定价结论', [
+      ['拟报单价', 'quoted_price'],
+      ['目标毛利', 'margin'],
+      ['相对基准偏离', 'deviation'],
+      ['门禁处置', 'disposition', 'tag'],
+    ]) +
+    noteCard(
+      '两张决策表各管一段',
+      '<b>利润模型 P-01</b>:客户等级 × 物料类型 × 数量档 → 目标毛利区间。' +
+        '<b>底价门禁 P-02</b>:偏离底价 ±20% 即止 —— 超限的不是「拦下」,而是转人裁断(回调还是注明理由)。' +
+        '两表都是确定性求值,同输入必同结论;命中的规则行随出参留痕,事后可逐条复盘。',
+    ),
+});
+
+export const PRICING_RELEASE = viewShell({
+  title: '报价草案 · 待放行',
+  kicker: 'A4 · 成果预览',
+  tone: 'case',
+  body:
+    tableCard(
+      '本单报价草案',
+      'mine:quote_pricing.draft',
+      [
+        ['型号', 'pn', 'mono'],
+        ['基准价', 'last_price'],
+        ['拟报价', 'quoted_price'],
+        ['毛利', 'margin'],
+        ['偏离', 'deviation'],
+        ['门禁', 'disposition'],
+      ],
+      '逐条列出,便于放行前逐条核对。',
+    ) +
+    noteCard(
+      '放行之后',
+      '放行通过 → 草稿合并入正式版 → 进 <b>AP 定价审批</b>(卡到 PM 工位)。' +
+        '审批驳回按声明走向<b>回 A4 重开新实例</b> —— 新任务 ID、留痕关联,不复活旧任务。',
+    ),
+});

activities/quote-sourcing/src/manifest.ts

@@ -8,6 +8,8 @@
  *   `⏱时限/回价到期` → 时间监听(**时限必配**)。
  */
 import type { ActivityManifest, DmnModel } from '@contracts';
+import { SOURCING_SKILLS } from './skills.ts';
+import { SOURCING_CASE } from './views/report.ts';
 import { activityIdSchema } from '@contracts';
 import { CMMN_XML, NARRATIVE } from './case-model.ts';
 
@@ -43,7 +45,7 @@ export const manifest: ActivityManifest = {
   identity: {
     activityId: ACTIVITY_ID,
     name: 'A3 · 渠道寻源',
-    packageVersion: '0.1.0',
+    packageVersion: '0.1.2',
     category: '统一报价',
     paradigm: 'loop',
     sdkVersion: '0.1.0-m5',
@@ -95,7 +97,7 @@ export const manifest: ActivityManifest = {
     },
     resources: {
       tools: [{ name: 'mail.send' }, { name: 'crm.history-price-read' }],
-      skills: [],
+      skills: SOURCING_SKILLS.map((s) => s.id),
       models: ['quote-extractor'],
       roles: ['PRM'],
       budget: { steps: 120, tokens: 300_000, activeMinutes: 480, humanCalls: 8 },
@@ -168,10 +170,8 @@ export const manifest: ActivityManifest = {
       narrative: NARRATIVE,
       dmn: STRATEGY_DMN,
     },
-    skills: [],
+    skills: SOURCING_SKILLS,
-    viewTemplates: [
+    viewTemplates: [{ name: 'case-overview', html: SOURCING_CASE }],
-      { name: 'sourcing-board', html: '<div class="jc-card"><h3>寻源看板</h3><p data-slot="stage"></p></div>' },
-    ],
     cardSchemas: {},
     distillHooks: [
       { on: 'milestone', milestone: 'M_quotes', prompt: '归纳各渠道的回价节奏与配合度。' },

activities/quote-sourcing/src/skills.ts

@@ -0,0 +1,46 @@
+/**
+ * A3 技能 —— 寻源的方法经验(AM 08)。
+ * loop 里技能由 AI **按适用描述临场装配**:常驻上下文只有目录,按事加载正文。
+ */
+import { skillIdSchema } from '@contracts';
+import type { Skill } from '@contracts';
+
+export const SOURCING_SKILLS: Skill[] = [
+  {
+    id: skillIdSchema.parse('sourcing.pick-channels'),
+    label: '按场景圈渠道',
+    applicability: '拿到料号与场景,要决定向谁发询时。',
+    method: [
+      '渠道不是越多越好:发得越广,回价越慢、口径越乱、对供应商的信用消耗越大。',
+      '',
+      '按场景定档:',
+      '· 常规补货 → 原厂代理 2 家足够,比的是账期与交期。',
+      '· BOM 后期 / 急单 → 加 1–2 家现货商,比的是**能不能拿到货**,价格其次。',
+      '· 停产料 → 直接问现货商与拆解渠道,原厂问了也是白问。',
+      '',
+      '每多发一家,就多一份要等的回价 —— 发询前先想清楚:这一家的回价会改变你的决定吗?',
+      '不会,就别发。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: ['渠道分级台账'],
+    version: '1.0.0',
+  },
+  {
+    id: skillIdSchema.parse('sourcing.wait-or-ask'),
+    label: '该等还是该问',
+    applicability: '当下可为与目标所需交集为空(依赖断点)时。',
+    method: [
+      '断点只有两种解法,选错就是白等或白问:',
+      '· 缺口**在世界侧**(供应商还没回价、样品还在路上)→ 立监听,必配时限。',
+      '  时限到了要有升级动作:催办 → 升级 → 改道,不能无限等。',
+      '· 缺口**只有人知道**(客户能不能接受替代、预算上限多少)→ 调人。',
+      '',
+      '判断标准很简单:**这个信息在系统外会自己到来吗?**',
+      '会 → 等(监听);不会 → 问(调人)。',
+      '把「该问的」等成超时,是寻源里最常见也最贵的错误。',
+    ].join('\n'),
+    crystallized: [],
+    knowledgeRefs: [],
+    version: '1.0.0',
+  },
+];

activities/quote-sourcing/src/views/report.ts

@@ -0,0 +1,25 @@
+/**
+ * A3 视图模版 —— 案例全景(AM 07:loop 按案例模型的**阶段与里程碑**组织汇报)。
+ *
+ * 画面素材全部来自语义引擎:阶段的生命周期态、当下可为(Enabled 集)、目标缺口。
+ * 这些是算出来的确定事实,零 LLM 即可成屏 —— 模型只决定「下一步做什么」,不负责画面。
+ */
+import { kvCard, noteCard, stagesCard, viewShell } from '@sdk';
+
+export const SOURCING_CASE = viewShell({
+  title: '渠道寻源 · 案例全景',
+  kicker: 'A3 · 案例活动(loop)',
+  tone: 'case',
+  body:
+    kvCard('本单标的', [
+      ['型号 PN', 'pn', 'mono'],
+      ['场景', 'scenario'],
+      ['当前阶段', 'activeStage', 'tag'],
+      ['当下可为', 'enabledCount'],
+      ['目标缺口', 'gapCount'],
+    ]) +
+    stagesCard('阶段(CMMN)', 'case:stages', '阶段的生命周期态由语义引擎推进到 <b>Enabled</b> 为止;凡触达世界或产出关键交付的计划项必须人工启动 —— <b>Enabled ≠ Active</b>。') +
+    stagesCard('当下可为', 'case:enabled', 'AI 只能在这个集合里选下一步:<b>可以越谱,不可越权</b>。') +
+    stagesCard('目标缺口', 'case:gaps', '缺口只有人知道 → 调人;缺口在世界侧 → 立监听(必配时限)。当下可为 ∩ 目标所需 = 空,就是<b>依赖断点</b>。') +
+    noteCard('这个活动为什么是 loop', '寻源是<b>一事一议</b>:几家供应商、谁先回、要不要追加一轮,事前排不出谱。调度权交给 AI,系统只保证边框 —— 预算、停滞熔断、放行归人。'),
+});

apps/api/src/app/container.ts

@@ -47,6 +47,7 @@ import { createCardStore, createHumanToolService } from '@modules/human-tool';
 import type { InteractionService } from '@modules/interaction';
 import { createInteractionService, createInteractionStore, templateIsSafe } from '@modules/interaction';
 import type { ActivityRegistryService } from '@modules/activity-registry';
+import { createSkillEngineService } from '@modules/skill-engine';
 import { createRegistryService, createRegistryStore } from '@modules/activity-registry';
 import type { ReleaseService } from '@modules/release';
 import { createIntentStore, createReleaseService } from '@modules/release';
@@ -364,6 +365,30 @@ export async function createContainer(config: AppConfig): Promise<Container> {
     sdkVersion: '0.1.0-m5',
   });
 
+  /*
+   * skill-engine(L4)—— 技能是活动内部的构件格式,由两个范式引擎装配。
+   * 目录与白名单都取自**活动清单**:技能提及的工具不在本活动白名单者不可调,
+   * 装配前查扩权 —— 载方法,不载权力(AM 08)。
+   */
+  const skills = createSkillEngineService({
+    catalog: {
+      skillsOf: async (activityId) => [...(await registry.manifestOf(activityId)).assets.skills],
+      allowlistOf: async (activityId) =>
+        (await registry.manifestOf(activityId)).declarations.tools.map((t) => t.name),
+    },
+    tools: {
+      invoke: (input) => toolInvoker.invoke(input),
+    },
+    memory: {
+      append: async (input) =>
+        void (await memory.append({
+          ...input,
+          stamp: { contractVersion: '1', businessModelVersion: '1', skillVersions: [] },
+        })),
+    },
+    clock: systemClock,
+  });
+
   const release = createReleaseService({
     intents: createIntentStore(db),
     ledger: {
@@ -489,6 +514,7 @@ export async function createContainer(config: AppConfig): Promise<Container> {
     modelGateway,
     registry,
     release,
+    skills,
     schemas,
   });
 

apps/api/src/app/wiring/engines.ts

@@ -16,6 +16,7 @@ import type { MessageService } from '@modules/message';
 import type { OrgService } from '@modules/org';
 import type { LlmService, ModelGateway } from '@modules/llm';
 import type { ActivityRegistryService } from '@modules/activity-registry';
+import type { SkillEngineService } from '@modules/skill-engine';
 import type { ReleaseService } from '@modules/release';
 
 import { createFlowRunner, createFlowStateStore } from '@modules/flow-engine';
@@ -49,6 +50,7 @@ export type EngineWiringDeps = {
   readonly llm: LlmService;
   readonly modelGateway: ModelGateway;
   readonly registry: ActivityRegistryService;
+  readonly skills: SkillEngineService;
   readonly release: ReleaseService;
   readonly schemas: { validate(schema: Record<string, unknown>, value: unknown): { ok: boolean; errors: string[] } };
 };
@@ -115,6 +117,42 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
     },
   };
 
+  /*
+   * 视图流控网关 —— 两个范式共用一份。
+   * 按名取模版 → 填数 → 推给前端。模版取自**该任务装载时的资产版本**(经 registry),
+   * 不是「当前最新」:在途任务按其启动时版本跑完,呈现也该跟着那一版。
+   */
+  const viewGateway = {
+    async push({
+      taskId,
+      activityId,
+      template,
+      scope,
+    }: {
+      taskId: TaskId;
+      activityId: string;
+      template: string;
+      scope: Record<string, unknown>;
+    }): Promise<void> {
+      const manifest = await deps.registry.manifestOf(activityId);
+      const found = manifest.assets.viewTemplates.find((t) => t.name === template);
+      if (found === undefined) return;
+
+      /*
+       * 视图作用域 = 任务视图 + **本单自己写下的行**。
+       * 两者要分得开:任务视图里的 `域.对象` 是正式版 + 我的草稿的合并结果,
+       * 拿它画「本单交付」会把别单放行过的记录一并列出来。
+       * 本单的行放在 `mine:域.对象` 下 —— 整键,取值不歧义。
+       */
+      const own: Record<string, unknown[]> = {};
+      for (const draft of await deps.ledger.taskDrafts(taskId)) {
+        const key = `mine:${draft.domain}.${draft.object}`;
+        (own[key] ??= []).push({ ...draft.key, ...draft.patch });
+      }
+      await deps.interaction.pushViewHtml(taskId, renderView(found.html, { ...scope, ...own }));
+    },
+  };
+
   /* ── 任务数据:引擎读**任务视图** = 正式版 + 本任务草稿层 ───────── */
   const taskData = {
     /**
@@ -286,31 +324,7 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
     data: taskData,
     tools: { ...toolGateway, invoke: (i) => toolGateway.invoke(i) },
     schemas: deps.schemas,
-    views: {
+    views: viewGateway,
-      /*
-       * 按名取模版 → 填数 → 推给前端。
-       * 模版取自**该任务装载时的资产版本**(经 registry),不是「当前最新」——
-       * 在途任务按其启动时版本跑完,呈现也该跟着那一版。
-       */
-      async push({ taskId, activityId, template, scope }) {
-        const manifest = await deps.registry.manifestOf(activityId);
-        const found = manifest.assets.viewTemplates.find((t) => t.name === template);
-        if (found === undefined) return;
-
-        /*
-         * 视图作用域 = 任务视图 + **本单自己写下的行**。
-         * 两者要分得开:任务视图里的 `域.对象` 是正式版 + 我的草稿的合并结果,
-         * 拿它画「本单交付」会把别单放行过的记录一并列出来。
-         * 本单的行放在 `mine:域.对象` 下 —— 整键,取值不歧义。
-         */
-        const own: Record<string, unknown[]> = {};
-        for (const draft of await deps.ledger.taskDrafts(taskId)) {
-          const key = `mine:${draft.domain}.${draft.object}`;
-          (own[key] ??= []).push({ ...draft.key, ...draft.patch });
-        }
-        await deps.interaction.pushViewHtml(taskId, renderView(found.html, { ...scope, ...own }));
-      },
-    },
     llm: {
       async generate(input) {
         // LLM 在 flow 里只以「被调用的工具」出现,不是调度者
@@ -357,6 +371,11 @@ export function wireEngines(deps: EngineWiringDeps): EngineWiring {
     tools: toolGateway,
     cards,
     listeners,
+    views: viewGateway,
+    skills: {
+      index: (activityId) => deps.skills.index(activityId),
+      stamp: (activityId, ids) => deps.skills.stamp(activityId, ids),
+    },
     memory: {
       append: memoryRecorder.append as never,
       loadActivityMemory: async (activityId: string, limit: number) =>

apps/api/src/modules/loop-engine/internal/usecase/turn-runner.ts

@@ -14,6 +14,8 @@ import type {
   ListenerRegistrar,
   LoopStateStore,
   MemoryRecorder,
+  SkillGateway,
+  ViewGateway,
   Sfeel,
   TaskContext,
   TaskDataGateway,
@@ -41,6 +43,8 @@ export type TurnRunnerDeps = {
   readonly cards: CardGateway;
   readonly listeners: ListenerRegistrar;
   readonly memory: MemoryRecorder;
+  readonly views: ViewGateway;
+  readonly skills: SkillGateway;
   readonly tasks: TaskContext;
   readonly clock: Clock;
 };
@@ -232,12 +236,35 @@ export function createTurnRunner(deps: TurnRunnerDeps): LoopEngineService {
         });
       }
 
+      const activityId = (await deps.tasks.of(taskId)).activityId;
+      const catalog = await deps.skills.index(activityId);
+
+      /*
+       * 叙事面 = 案例说明书 + 活动记忆选摘 + **技能目录**。
+       * 渐进披露(AM 08):常驻上下文只给「有哪些方法、何时适用」,
+       * 正文与知识引用等 AI 说要才加载 —— 一次把所有正文塞进去,
+       * 上下文会被方法论淹掉,真正的局面反而看不见。
+       */
       const narrative = [
         model.narrative,
-        ...(await deps.memory.loadActivityMemory((await deps.tasks.of(taskId)).activityId, 20)).map(
+        ...(await deps.memory.loadActivityMemory(activityId, 20)).map((m) => `[${m.layer}] ${m.statement}`),
-          (m) => `[${m.layer}] ${m.statement}`,
+        catalog.length === 0
-        ),
+          ? ''
-      ].join('\n\n');
+          : `【可装配的技能(目录)】\n${catalog.map((s) => `- ${s.id} ${s.label}:${s.applicability}`).join('\n')}`,
+      ]
+        .filter((line) => line !== '')
+        .join('\n\n');
+
+      // 装配入信封:这一回合手上有哪些技能及其版本,记进任务记忆 —— 回放与归因依赖之
+      if (catalog.length > 0) {
+        const stamp = await deps.skills.stamp(activityId, catalog.map((s) => s.id));
+        await deps.memory.append({
+          taskId,
+          kind: 'thought',
+          title: `装配技能:${stamp.map((s) => `${s.id}@${s.version}`).join('、')}`,
+          detail: { skills: [...stamp] },
+        });
+      }
 
       const action = await deps.agent.decide({ taskId, narrative, enabled, scope });
 
@@ -250,6 +277,31 @@ export function createTurnRunner(deps: TurnRunnerDeps): LoopEngineService {
       const applied = await applyAction(taskId, action, runtime);
       await deps.state.save(taskId, model, parsed, applied.runtime);
 
+      /*
+       * 每回合推一次案例全景 —— 呈现是投影,失败只丢这一帧,不影响回路推进。
+       * 画面的素材全部来自语义引擎(阶段态 / 当下可为 / 缺口),零 LLM。
+       */
+      try {
+        await deps.views.push({
+          taskId,
+          activityId: (await deps.tasks.of(taskId)).activityId,
+          template: 'case-overview',
+          scope: {
+            ...scope,
+            'case:stages': parsed.items
+              .filter((i) => i.type === 'stage')
+              .map((i) => ({ name: i.name, state: applied.runtime.items.find((r) => r.id === i.id)?.state ?? '—' })),
+            'case:enabled': enabled.entries.map((e) => ({ name: e.name, state: e.requiresManualStart ? '待启动' : '可进行' })),
+            'case:gaps': enabled.gaps.map((g) => ({ name: g, state: '未满足' })),
+            gapCount: enabled.gaps.length,
+            enabledCount: enabled.entries.length,
+            activeStage: enabled.activeStages.join('、') || '—',
+          },
+        });
+      } catch {
+        // 呈现失败不影响回路:画面丢一帧,事实一件不少
+      }
+
       return {
         runtime: applied.runtime,
         enabled,

apps/api/src/modules/loop-engine/port.ts

@@ -77,6 +77,32 @@ export type ListenerRegistrar = {
   }): Promise<{ id: string }>;
 };
 
+/**
+ * 视图流控 —— app 注入 `interaction`(L3)。
+ * 「loop:AI 按定位与局面临场组织视图流」(AM 07)。MVP 每回合推一次**案例全景**:
+ * 阶段与计划项的生命周期态、当下可为、目标缺口 —— 这些是语义引擎算出来的确定事实,
+ * 零 LLM 即可成屏;模型只决定「下一步做什么」,不负责画面。
+ */
+export type ViewGateway = {
+  push(input: {
+    taskId: TaskId;
+    activityId: string;
+    template: string;
+    scope: Record<string, unknown>;
+  }): Promise<void>;
+};
+
+/**
+ * 技能 —— app 注入 `skill-engine`(L4)。
+ * 「渐进披露:常驻上下文**仅有技能目录**,按事加载正文、按需下钻引用」(AM 08)。
+ */
+export type SkillGateway = {
+  /** 目录:id + 何时适用 —— 只给这些,正文等 AI 说要才加载 */
+  index(activityId: string): Promise<ReadonlyArray<{ id: string; label: string; applicability: string }>>;
+  /** 装配入信封:这一回合装配了哪些技能及其版本,记入任务记忆 */
+  stamp(activityId: string, skillIds: readonly string[]): Promise<ReadonlyArray<{ id: string; version: string }>>;
+};
+
 export type MemoryRecorder = {
   append(input: {
     taskId: TaskId;

packages/activity-sdk/src/index.ts

@@ -27,4 +27,7 @@ export type {
 export type { HostOptions, HostRecording, MockHost } from './host.ts';
 export { createMockHost } from './host.ts';
 
+export type { Tone } from './view.ts';
+export { kvCard, noteCard, stagesCard, tableCard, viewShell } from './view.ts';
+
 export const SDK_VERSION = '0.1.0-m5';

packages/activity-sdk/src/view.ts

@@ -0,0 +1,113 @@
+/**
+ * 视图模版工具箱 —— 活动开发者写「呈现」时看到的世界(AM 07)。
+ *
+ * 模版是**内容不是代码**:这里产出的一律是无脚本、无事件处理器、无外链的静态 HTML;
+ * 数据由基座在推送时填(`data-slot` 取值、`data-rows` 逐条展开)。
+ * 容器是沙箱 iframe(`sandbox=""`),因此**样式必须自带** —— 页面不继承工作台的 CSS。
+ *
+ * 六个活动共用这一套外壳:汇报面貌一致,不是每个活动各自发明一套。
+ */
+
+export type Tone = 'brand' | 'ok' | 'warn' | 'danger' | 'case' | 'archive';
+
+const ACCENT: Readonly<Record<Tone, string>> = {
+  brand: '#3370ff',
+  ok: '#0aa294',
+  warn: '#ff8800',
+  danger: '#e5484d',
+  case: '#7f3bf5',
+  archive: '#46586a',
+};
+
+/** 一套克制的排版;所有尺寸用相对单位,窄栏也不横向溢出 */
+const BASE_CSS = (accent: string): string => `
+  :root { color-scheme: light; }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0; padding: 18px;
+    font: 13px/1.6 -apple-system, "PingFang SC", "Noto Sans SC", "Segoe UI", sans-serif;
+    color: #1f2933; background: #f7f8fa;
+  }
+  .wrap { max-width: 760px; margin: 0 auto; }
+  .hd { display: flex; align-items: stretch; gap: 12px; margin-bottom: 14px; }
+  .hd .bar { width: 4px; border-radius: 2px; background: ${accent}; flex: none; }
+  .hd .kick { font-size: 11px; letter-spacing: .08em; color: #6a7686; }
+  .hd h1 { margin: 2px 0 0; font-size: 17px; font-weight: 650; letter-spacing: .01em; }
+  .card { background: #fff; border: 1px solid #e6e9ee; border-radius: 10px; padding: 14px 16px; margin-bottom: 12px; }
+  .card h2 { margin: 0 0 10px; font-size: 12px; font-weight: 600; color: #6a7686; letter-spacing: .04em; }
+  .kv { display: grid; grid-template-columns: repeat(auto-fit, minmax(150px, 1fr)); gap: 10px 18px; }
+  .kv > div { min-width: 0; }
+  .kv em { display: block; font-style: normal; font-size: 11px; color: #8b95a3; margin-bottom: 2px; }
+  .kv b { font-size: 14px; font-weight: 600; overflow-wrap: anywhere; }
+  .tbl-wrap { overflow-x: auto; }
+  table { width: 100%; border-collapse: collapse; font-size: 12px; }
+  th { text-align: left; font-weight: 600; color: #6a7686; padding: 6px 8px; border-bottom: 1px solid #e6e9ee; white-space: nowrap; }
+  td { padding: 7px 8px; border-bottom: 1px solid #f0f2f5; overflow-wrap: anywhere; }
+  tr:last-child td { border-bottom: 0; }
+  .mono { font-family: "SF Mono", Menlo, Consolas, monospace; }
+  .tag { display: inline-block; padding: 1px 8px; border-radius: 999px; font-size: 11px; font-weight: 600;
+         background: ${accent}1a; color: ${accent}; }
+  .note { font-size: 11px; color: #8b95a3; margin-top: 10px; line-height: 1.75; }
+  .steps { list-style: none; margin: 0; padding: 0; }
+  .steps li { position: relative; padding: 0 0 12px 20px; border-left: 2px solid #e6e9ee; }
+  .steps li:last-child { padding-bottom: 0; border-left-color: transparent; }
+  .steps li::before { content: ""; position: absolute; left: -5px; top: 5px; width: 8px; height: 8px;
+                      border-radius: 50%; background: ${accent}; }
+  .steps .t { font-weight: 600; }
+  .steps .d { color: #8b95a3; font-size: 11.5px; }
+`;
+
+/** 页头 + 卡片区 —— 每张模版都长这样,只换标题与内容 */
+export function viewShell(input: {
+  title: string;
+  kicker: string;
+  tone: Tone;
+  body: string;
+}): string {
+  const accent = ACCENT[input.tone];
+  return `<style>${BASE_CSS(accent)}</style>
+<div class="wrap">
+  <div class="hd"><span class="bar"></span><div><div class="kick">${input.kicker}</div><h1>${input.title}</h1></div></div>
+  ${input.body}
+</div>`;
+}
+
+/** 键值卡:`[标签, 取值路径]`;`mono` 用等宽显示编号类字段 */
+export function kvCard(title: string, items: ReadonlyArray<readonly [string, string, ('mono' | 'tag')?]>): string {
+  const cells = items
+    .map(([label, path, style]) => {
+      const cls = style === undefined ? '' : ` class="${style === 'mono' ? 'mono' : 'tag'}"`;
+      return `<div><em>${label}</em><b${cls} data-slot="${path}"></b></div>`;
+    })
+    .join('');
+  return `<div class="card"><h2>${title}</h2><div class="kv">${cells}</div></div>`;
+}
+
+/** 逐条表:行数不写死,由 `data-rows` 展开 */
+export function tableCard(
+  title: string,
+  rowsPath: string,
+  columns: ReadonlyArray<readonly [string, string, ('mono')?]>,
+  note?: string,
+): string {
+  const head = columns.map(([label]) => `<th>${label}</th>`).join('');
+  const cells = columns
+    .map(([, path, style]) => `<td${style === 'mono' ? ' class="mono"' : ''} data-slot="${path}"></td>`)
+    .join('');
+  return `<div class="card"><h2>${title}</h2><div class="tbl-wrap"><table>
+    <thead><tr>${head}</tr></thead>
+    <tbody data-rows="${rowsPath}"><tr>${cells}</tr></tbody>
+  </table></div>${note === undefined ? '' : `<p class="note">${note}</p>`}</div>`;
+}
+
+/** 说明卡:把「为什么这么做」摆在数据旁边 —— 人要在数据上作判断 */
+export function noteCard(title: string, html: string): string {
+  return `<div class="card"><h2>${title}</h2><p class="note" style="margin-top:0">${html}</p></div>`;
+}
+
+/** 阶段时间线:loop 按案例模型的阶段与里程碑组织汇报(AM 07) */
+export function stagesCard(title: string, rowsPath: string, note?: string): string {
+  return `<div class="card"><h2>${title}</h2><ul class="steps" data-rows="${rowsPath}">
+    <li><span class="t" data-slot="name"></span><span class="d" data-slot="state"></span></li>
+  </ul>${note === undefined ? '' : `<p class="note">${note}</p>`}</div>`;
+}