agentic-flow-kit 1.8.7 → 2.1.0

package/templates/profiles/node/.agents/notes/runtime-env.md

@@ -0,0 +1,44 @@
+# Runtime & Environment Facts
+
+> 本文件是环境事实的单源登记处。新装户按项目实际替换端口、启动命令与工具解析结果；不要把绝对路径写入本文件（本机事实登记在 `runtime-env.local.md`，模板 `runtime-env.local.example.md`）。
+
+## 1. 端口
+
+| 服务 | 端口 | 槽位偏移 | 协议 | 启动命令 |
+|---|---|---|---|---|
+| API | {{apiPort}} | `+slot×10` | HTTP | `<API 启动命令>` |
+| 前端 dev | {{webPort}} | `+slot×10` | HTTP | `<前端启动命令>` |
+| 流程看板 | {{boardPort}} | `+slot×10` | HTTP | `node .agents/scripts/ensure-board.mjs` |
+
+## 2. 本地 Clone 必做
+
+```bash
+git config core.hooksPath .githooks
+git config merge.ours.driver true
+git config merge.jsonl-union.driver "node .agents/scripts/git-merge-jsonl.mjs %O %A %B"
+node .agents/scripts/check-local-gates.mjs --fix
+```
+
+## 3. 可执行文件解析
+
+解析顺序：① 环境变量（浏览器仅 `CHROME_PATH`）→ ② `runtime-env.local.md` 工具表登记 → ③ 标准安装位置探测 → ④ 按名回退。
+
+| 工具 | 用途 |
+|---|---|
+| `node` | 引擎脚本与 git 钩子（要求 ≥ 22） |
+| `git` | 门禁与台账 |
+| `browser` | UI 实测（仅 `verify-ui` / E2E 需要） |
+
+## 4. 门禁与钩子
+
+| 钩子 | 职责 |
+|---|---|
+| `pre-commit` | 静态门与引擎检查 |
+| `commit-msg` | Conventional Commits 与 plan 引用 |
+| `pre-merge-commit` | merge 提交转发 `pre-commit --full --merge` |
+| `pre-push` | 闭环扫描、构建、范围门、宿主接线对账 |
+| `post-commit` | 缓存回收与积压提醒 |
+
+## 5. 已知环境缺陷
+
+按项目实际补充；每条写「症状 / 判据 / 修法」。

package/templates/profiles/node/AGENTS.md

@@ -0,0 +1,52 @@
+# Repository Guidelines
+
+{{projectName}}。{{stackDescription}}。
+
+## 1. 运行时联通 (Runtime Connectivity)
+前端 dev {{webPort}} 连 API `http://localhost:{{apiPort}}`；API 须监听 {{apiPort}} 才联通。端口/工具缺陷/可执行文件解析机理等环境事实见 `.agents/notes/runtime-env.md` §6；各机绝对路径与版本自登记 `.agents/notes/runtime-env.local.md`。
+
+## 2. 本地 Clone 必做 (Local Setup)
+> 漏配则门禁静默失效，详见 `.agents/notes/runtime-env.md` §7。
+- `git config core.hooksPath .githooks` 挂仓库自带钩子。
+- `git config merge.ours.driver true` 启用声明为 `merge=ours` 的合并保护。
+- `git config merge.jsonl-union.driver "node .agents/scripts/git-merge-jsonl.mjs %O %A %B"` 启用 `.agents/*.jsonl` 并集合并策略。
+- **禁令**：commit / merge / push 三处一律禁 `--no-verify`。
+- **自检**：`node .agents/scripts/check-local-gates.mjs --fix`
+
+## 3. 全局红线 (Universal Laws)
+- **安全/隐私**：不提交密钥、令牌、`.env` 或真实用户数据；发现敏感信息立即停止扩散。
+- **不可逆操作**：默认不执行生产部署、远程推送、数据删除等操作 → 须用户明确要求且不得绕过门禁。
+- **最小改动**：优先做满足需求的最小改动，禁止顺手重构无关代码、修改格式或修复无关 Lint 警告。
+- **单源纪律**：路径 / 版本 / 缺陷等环境事实只登记于 `.agents/notes/runtime-env.md` §6，别处禁止复制原文。
+- **上下文纪律**：批量取数、长日志、大 diff、全仓盘点交子代理，主线只收结论摘要与 `file:line`；子代理回报写结论与证据路径，禁把原始输出整段搬回主线。
+- **提交规范**：Conventional Commits，类型限 `feat/fix/docs/style/refactor/perf/chore`。
+
+## 4. 阶段路由表 (Workflow Routing)
+按任务类型跳转对应指令文件：
+
+| 任务类型 | 指令文件 | 核心职责 |
+|---|---|---|
+| **L0 极简道** | `.agents/commands/new-task.md` | 全机器可判的极小改动，与 L1 同走快速道：改码 → `verify --face`/`--scope` → 单笔 commit |
+| **L1 快速道** | `.agents/commands/new-task.md` | 定级、实现、`verify --scope`、单笔关单（仅独立关单场景开技能）。不打开 `stages.md` |
+| **新需求 / 功能** | `.agents/commands/new-task.md` | L1 走快速道；L2/L3 才进 `stages.md` |
+| **L2/L3 阶段流** | `.agents/commands/stages.md` | 四章 Plan→Design→Build→Test：立 intent → 起 spec → 起 plan + 实现 → 静态门 → UI 实测 → 独立复核 → 关单 |
+| **修复 / 事故** | `.agents/commands/maintain.md` | L1 非事故只做 §1 立档后回快速道。线上事故与 L2/L3 读全文 |
+| **上线 / 发布** | `.agents/commands/deploy.md` | 静态门 → 回归检查（含 DB 验证）→ 授权 → PR 审查合并 |
+| **合入评审** | `.agents/commands/review.md` | P0/P1/P2 分级评审 → 结论定性 |
+| **自动化驱动** | `.agents/commands/pipeline-run.md` | 实验位保留待用：状态机尚未验证、零 run 记录，启用前须补状态机测试 |
+| **无人值守 / 过夜** | `.agents/skills/autonomous-run/SKILL.md` | 长跑合同：逐单元签收 + 停机条件；门禁与确认门不豁免 |
+| **性能 / 视觉对齐** | `.agents/skills/perf/SKILL.md` · `.agents/skills/visual-parity/SKILL.md` | 先基线后单变量；像素对齐只改样式 |
+
+> **纠偏短名**：任务中途报短名即可，索引 `.agents/config/principles.md`。
+
+> **引擎面豁免**：改 AI-Native 治理引擎自身，**豁免工作流三件套**——不生成 intents/specs/plans、不走确认门，Conventional Commits 直接变更。引擎面 = `.agents/` 全部、`.githooks/`、`azure-pipelines.yml`、workflow/ 模板与台账、根 `package.json`、宿主适配目录；其中本机私有宿主目录不入库。**wiki 豁免**：调整 `wiki/` 知识文档内容（含 INDEX 与看板）同享上述豁免。**边界**：git 钩子与静态门照常执行；删除 wiki 文件仍须用户单独指令；数据维护 SQL 的**执行**不豁免。
+
+## 5. 目录级规则 (Directory-level Rules)
+**禁止回填本文档**。具体实现细节请查阅对应目录的 `AGENTS.md`：
+- **后端**: `backend/AGENTS.md`
+- **前端**: `frontend/AGENTS.md`
+- **成对文档同步**：按 `wiki/INDEX.md` 登记的成对文档，修改任一份须同步另一份，并同步更新 `wiki/INDEX.md` 与 `wiki/知识沉淀总览.html`。
+
+## 6. 项目适配区 (Project Adaptations)
+- **构建/测试/类型检查**: 命令清单单源 `.agents/hooks/commit-check.config.json`。
+- **冒烟探活**: 脚本路径与端点判定事实见 `.agents/notes/runtime-env.md` §6.1。

package/templates/profiles/rust/AGENTS.md

@@ -0,0 +1,52 @@
+# Repository Guidelines
+
+{{projectName}}。{{stackDescription}}。
+
+## 1. 运行时联通 (Runtime Connectivity)
+前端 dev {{webPort}} 连 API `http://localhost:{{apiPort}}`；API 须监听 {{apiPort}} 才联通。端口/工具缺陷/可执行文件解析机理等环境事实见 `.agents/notes/runtime-env.md` §6；各机绝对路径与版本自登记 `.agents/notes/runtime-env.local.md`。
+
+## 2. 本地 Clone 必做 (Local Setup)
+> 漏配则门禁静默失效，详见 `.agents/notes/runtime-env.md` §7。
+- `git config core.hooksPath .githooks` 挂仓库自带钩子。
+- `git config merge.ours.driver true` 启用声明为 `merge=ours` 的合并保护。
+- `git config merge.jsonl-union.driver "node .agents/scripts/git-merge-jsonl.mjs %O %A %B"` 启用 `.agents/*.jsonl` 并集合并策略。
+- **禁令**：commit / merge / push 三处一律禁 `--no-verify`。
+- **自检**：`node .agents/scripts/check-local-gates.mjs --fix`
+
+## 3. 全局红线 (Universal Laws)
+- **安全/隐私**：不提交密钥、令牌、`.env` 或真实用户数据；发现敏感信息立即停止扩散。
+- **不可逆操作**：默认不执行生产部署、远程推送、数据删除等操作 → 须用户明确要求且不得绕过门禁。
+- **最小改动**：优先做满足需求的最小改动，禁止顺手重构无关代码、修改格式或修复无关 Lint 警告。
+- **单源纪律**：路径 / 版本 / 缺陷等环境事实只登记于 `.agents/notes/runtime-env.md` §6，别处禁止复制原文。
+- **上下文纪律**：批量取数、长日志、大 diff、全仓盘点交子代理，主线只收结论摘要与 `file:line`；子代理回报写结论与证据路径，禁把原始输出整段搬回主线。
+- **提交规范**：Conventional Commits，类型限 `feat/fix/docs/style/refactor/perf/chore`。
+
+## 4. 阶段路由表 (Workflow Routing)
+按任务类型跳转对应指令文件：
+
+| 任务类型 | 指令文件 | 核心职责 |
+|---|---|---|
+| **L0 极简道** | `.agents/commands/new-task.md` | 全机器可判的极小改动，与 L1 同走快速道：改码 → `verify --face`/`--scope` → 单笔 commit |
+| **L1 快速道** | `.agents/commands/new-task.md` | 定级、实现、`verify --scope`、单笔关单（仅独立关单场景开技能）。不打开 `stages.md` |
+| **新需求 / 功能** | `.agents/commands/new-task.md` | L1 走快速道；L2/L3 才进 `stages.md` |
+| **L2/L3 阶段流** | `.agents/commands/stages.md` | 四章 Plan→Design→Build→Test：立 intent → 起 spec → 起 plan + 实现 → 静态门 → UI 实测 → 独立复核 → 关单 |
+| **修复 / 事故** | `.agents/commands/maintain.md` | L1 非事故只做 §1 立档后回快速道。线上事故与 L2/L3 读全文 |
+| **上线 / 发布** | `.agents/commands/deploy.md` | 静态门 → 回归检查（含 DB 验证）→ 授权 → PR 审查合并 |
+| **合入评审** | `.agents/commands/review.md` | P0/P1/P2 分级评审 → 结论定性 |
+| **自动化驱动** | `.agents/commands/pipeline-run.md` | 实验位保留待用：状态机尚未验证、零 run 记录，启用前须补状态机测试 |
+| **无人值守 / 过夜** | `.agents/skills/autonomous-run/SKILL.md` | 长跑合同：逐单元签收 + 停机条件；门禁与确认门不豁免 |
+| **性能 / 视觉对齐** | `.agents/skills/perf/SKILL.md` · `.agents/skills/visual-parity/SKILL.md` | 先基线后单变量；像素对齐只改样式 |
+
+> **纠偏短名**：任务中途报短名即可，索引 `.agents/config/principles.md`。
+
+> **引擎面豁免**：改 AI-Native 治理引擎自身，**豁免工作流三件套**——不生成 intents/specs/plans、不走确认门，Conventional Commits 直接变更。引擎面 = `.agents/` 全部、`.githooks/`、`azure-pipelines.yml`、workflow/ 模板与台账、根 `package.json`、宿主适配目录；其中本机私有宿主目录不入库。**wiki 豁免**：调整 `wiki/` 知识文档内容（含 INDEX 与看板）同享上述豁免。**边界**：git 钩子与静态门照常执行；删除 wiki 文件仍须用户单独指令；数据维护 SQL 的**执行**不豁免。
+
+## 5. 目录级规则 (Directory-level Rules)
+**禁止回填本文档**。具体实现细节请查阅对应目录的 `AGENTS.md`：
+- **后端**: `backend/AGENTS.md`
+- **前端**: `frontend/AGENTS.md`
+- **成对文档同步**：按 `wiki/INDEX.md` 登记的成对文档，修改任一份须同步另一份，并同步更新 `wiki/INDEX.md` 与 `wiki/知识沉淀总览.html`。
+
+## 6. 项目适配区 (Project Adaptations)
+- **构建/测试/类型检查**: 命令清单单源 `.agents/hooks/commit-check.config.json`。
+- **冒烟探活**: 脚本路径与端点判定事实见 `.agents/notes/runtime-env.md` §6.1。

package/templates/profiles/typescript/AGENTS.md

@@ -0,0 +1,52 @@
+# Repository Guidelines
+
+{{projectName}}。{{stackDescription}}。
+
+## 1. 运行时联通 (Runtime Connectivity)
+前端 dev {{webPort}} 连 API `http://localhost:{{apiPort}}`；API 须监听 {{apiPort}} 才联通。端口/工具缺陷/可执行文件解析机理等环境事实见 `.agents/notes/runtime-env.md` §6；各机绝对路径与版本自登记 `.agents/notes/runtime-env.local.md`。
+
+## 2. 本地 Clone 必做 (Local Setup)
+> 漏配则门禁静默失效，详见 `.agents/notes/runtime-env.md` §7。
+- `git config core.hooksPath .githooks` 挂仓库自带钩子。
+- `git config merge.ours.driver true` 启用声明为 `merge=ours` 的合并保护。
+- `git config merge.jsonl-union.driver "node .agents/scripts/git-merge-jsonl.mjs %O %A %B"` 启用 `.agents/*.jsonl` 并集合并策略。
+- **禁令**：commit / merge / push 三处一律禁 `--no-verify`。
+- **自检**：`node .agents/scripts/check-local-gates.mjs --fix`
+
+## 3. 全局红线 (Universal Laws)
+- **安全/隐私**：不提交密钥、令牌、`.env` 或真实用户数据；发现敏感信息立即停止扩散。
+- **不可逆操作**：默认不执行生产部署、远程推送、数据删除等操作 → 须用户明确要求且不得绕过门禁。
+- **最小改动**：优先做满足需求的最小改动，禁止顺手重构无关代码、修改格式或修复无关 Lint 警告。
+- **单源纪律**：路径 / 版本 / 缺陷等环境事实只登记于 `.agents/notes/runtime-env.md` §6，别处禁止复制原文。
+- **上下文纪律**：批量取数、长日志、大 diff、全仓盘点交子代理，主线只收结论摘要与 `file:line`；子代理回报写结论与证据路径，禁把原始输出整段搬回主线。
+- **提交规范**：Conventional Commits，类型限 `feat/fix/docs/style/refactor/perf/chore`。
+
+## 4. 阶段路由表 (Workflow Routing)
+按任务类型跳转对应指令文件：
+
+| 任务类型 | 指令文件 | 核心职责 |
+|---|---|---|
+| **L0 极简道** | `.agents/commands/new-task.md` | 全机器可判的极小改动，与 L1 同走快速道：改码 → `verify --face`/`--scope` → 单笔 commit |
+| **L1 快速道** | `.agents/commands/new-task.md` | 定级、实现、`verify --scope`、单笔关单（仅独立关单场景开技能）。不打开 `stages.md` |
+| **新需求 / 功能** | `.agents/commands/new-task.md` | L1 走快速道；L2/L3 才进 `stages.md` |
+| **L2/L3 阶段流** | `.agents/commands/stages.md` | 四章 Plan→Design→Build→Test：立 intent → 起 spec → 起 plan + 实现 → 静态门 → UI 实测 → 独立复核 → 关单 |
+| **修复 / 事故** | `.agents/commands/maintain.md` | L1 非事故只做 §1 立档后回快速道。线上事故与 L2/L3 读全文 |
+| **上线 / 发布** | `.agents/commands/deploy.md` | 静态门 → 回归检查（含 DB 验证）→ 授权 → PR 审查合并 |
+| **合入评审** | `.agents/commands/review.md` | P0/P1/P2 分级评审 → 结论定性 |
+| **自动化驱动** | `.agents/commands/pipeline-run.md` | 实验位保留待用：状态机尚未验证、零 run 记录，启用前须补状态机测试 |
+| **无人值守 / 过夜** | `.agents/skills/autonomous-run/SKILL.md` | 长跑合同：逐单元签收 + 停机条件；门禁与确认门不豁免 |
+| **性能 / 视觉对齐** | `.agents/skills/perf/SKILL.md` · `.agents/skills/visual-parity/SKILL.md` | 先基线后单变量；像素对齐只改样式 |
+
+> **纠偏短名**：任务中途报短名即可，索引 `.agents/config/principles.md`。
+
+> **引擎面豁免**：改 AI-Native 治理引擎自身，**豁免工作流三件套**——不生成 intents/specs/plans、不走确认门，Conventional Commits 直接变更。引擎面 = `.agents/` 全部、`.githooks/`、`azure-pipelines.yml`、workflow/ 模板与台账、根 `package.json`、宿主适配目录；其中本机私有宿主目录不入库。**wiki 豁免**：调整 `wiki/` 知识文档内容（含 INDEX 与看板）同享上述豁免。**边界**：git 钩子与静态门照常执行；删除 wiki 文件仍须用户单独指令；数据维护 SQL 的**执行**不豁免。
+
+## 5. 目录级规则 (Directory-level Rules)
+**禁止回填本文档**。具体实现细节请查阅对应目录的 `AGENTS.md`：
+- **后端**: `backend/AGENTS.md`
+- **前端**: `frontend/AGENTS.md`
+- **成对文档同步**：按 `wiki/INDEX.md` 登记的成对文档，修改任一份须同步另一份，并同步更新 `wiki/INDEX.md` 与 `wiki/知识沉淀总览.html`。
+
+## 6. 项目适配区 (Project Adaptations)
+- **构建/测试/类型检查**: 命令清单单源 `.agents/hooks/commit-check.config.json`。
+- **冒烟探活**: 脚本路径与端点判定事实见 `.agents/notes/runtime-env.md` §6.1。

package/templates/scaffold/wiki/INDEX.md

@@ -0,0 +1,33 @@
+# Wiki 索引
+
+> 本目录为项目知识沉淀，按主题归位。看板：`知识沉淀总览.html`（同级目录，三列映射表格）。
+>
+> 新装户从零开始：把文档放进对应主题目录后跑 `node .agents/scripts/gen-wiki-board.mjs`，本索引与看板自动重生成。
+
+## 主题目录速览
+
+| 主题 | 文件数 | 用途 |
+|---|---|---|
+| 产品需求 | 0 | 新需求原型包（logic.md + app.html） |
+| 开发方案 | 0 | 数据字典、接口定义、业务模块全景 |
+| 数据维护 | 0 | schema 变更 / 数据修复 / 导入 / 查询 / 备份 SQL 台账 |
+| 项目规范 | 0 | 开发规范与硬约束 |
+| 用户功能 | 0 | 模块功能说明、验证手册、数据流分册 |
+| 测试报告 | 0 | 测试与审查报告归档 |
+| drafts-archive | — | 原文档备份（按 日期-主题 分目录） |
+
+合计：**0 份**知识文档，**6 个主题**
+
+---
+
+## 文件 → 主题 → 归属目录 映射表
+
+（由 `node .agents/scripts/gen-wiki-board.mjs` 生成，勿手改。）
+
+---
+
+## 命名规则
+
+- 新文档按 `<日期>-<主题>/` 或 `<主题>-<名称>.md` 命名。
+- 成对文档（html/md）须同步维护。
+- 生成区（速览表数据行、映射表、看板 DATA）勿手改。

package/templates/scaffold/wiki/drafts-archive/README.md

@@ -0,0 +1,7 @@
+# drafts-archive（草稿归档 · 已退役）
+
+> **2026-10-30 用户指令整体退役**：本目录原为 wiki 整理前的原文档备份区（按 `YYYY-MM-DD_主题` 组织，最多时 112 份 git 跟踪件）。全部归档内容已删除，**git 历史是唯一溯源途径**（`git log --follow -- wiki/drafts-archive/<路径>` 或按提交 `b89f5fac`、本轮删除提交检索）。
+>
+> 目录本体保留：本目录是 wiki 协议结构目录（`verify-wiki-consistency.mjs` 硬校验其存在），且 git 不跟踪空目录——删空后须留本说明，否则其他 clone 检出后一致性校验必红。
+>
+> 同批退役的活文档（测试日报 ×27、总纲 PRD v3.3、出库申请/出库单 PRD、买用对比 ×2、列表页样式规范、项目计划 v3.3、残留台账 v2）同以上口径。

package/templates/scaffold/wiki//346/225/260/346/215/256/347/273/264/346/212/244/README.md

@@ -0,0 +1,22 @@
+# 数据维护台账
+
+本目录登记全项目数据维护 SQL 与执行状态，按阶段分类：
+
+| 目录 | 用途 |
+|---|---|
+| `schema变更/` | 表结构变更（DDL），每个批次一个 `日期-主题/` 子目录 |
+| `数据修复/` | 存量数据修复（DML），须写明影响行数与回滚口径 |
+| `数据导入/` | 外部数据导入脚本与映射说明 |
+| `查询/` | 只读排查 SQL |
+| `备份/` | 备份与恢复脚本 |
+
+## 硬约束
+
+- 新增 SQL 必须登记执行状态与授权来源。
+- 禁止无 `WHERE` 的全表 `DELETE` / `UPDATE`。
+- 执行生产 SQL 属不可逆操作，须用户明确授权，且按项目数据维护台账与 DB 验证口径走。
+- 脚本与台账示例见 `_TEMPLATE.md`（若存在）。
+
+## 生成物
+
+`README.md` 由本目录协议维护；具体批次清单以子目录与 git 历史为准。

package/templates/scaffold/wiki//347/237/245/350/257/206/346/262/211/346/267/200/346/200/273/350/247/210.html

@@ -0,0 +1,230 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8" />
+<title>知识沉淀总览 · {{projectName}}</title>
+<style>
+  :root {
+    --bg: #f7f8fb;
+    --card: #ffffff;
+    --border: #e6e8ee;
+    --text: #1f2937;
+    --muted: #6b7280;
+    --accent: #2563eb;
+    --accent-soft: #eff4ff;
+    --warn: #d97706;
+    --shadow: 0 1px 2px rgba(0,0,0,.04), 0 4px 16px rgba(0,0,0,.04);
+  }
+  * { box-sizing: border-box; }
+  body {
+    margin: 0;
+    font-family: -apple-system, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
+    background: var(--bg);
+    color: var(--text);
+    line-height: 1.5;
+  }
+  header {
+    padding: 32px 40px 16px;
+    background: linear-gradient(135deg, #1e3a8a 0%, #2563eb 100%);
+    color: #fff;
+  }
+  header h1 { margin: 0 0 4px; font-size: 24px; font-weight: 600; }
+  header .meta { opacity: .85; font-size: 13px; }
+  main { max-width: 1400px; margin: 0 auto; padding: 24px 40px 64px; }
+  .summary {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
+    gap: 12px;
+    margin-bottom: 24px;
+  }
+  .stat {
+    background: var(--card);
+    border: 1px solid var(--border);
+    border-radius: 10px;
+    padding: 14px 16px;
+    box-shadow: var(--shadow);
+  }
+  .stat .num { font-size: 22px; font-weight: 600; color: var(--accent); }
+  .stat .lbl { font-size: 12px; color: var(--muted); margin-top: 2px; }
+  .toolbar {
+    display: flex;
+    gap: 8px;
+    margin-bottom: 12px;
+    flex-wrap: wrap;
+    align-items: center;
+  }
+  .toolbar input {
+    flex: 1 1 280px;
+    max-width: 480px;
+    padding: 8px 12px;
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    font-size: 13px;
+    background: var(--card);
+  }
+  .toolbar select {
+    padding: 8px 12px;
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    font-size: 13px;
+    background: var(--card);
+  }
+  .topic-section {
+    background: var(--card);
+    border: 1px solid var(--border);
+    border-radius: 12px;
+    margin-bottom: 16px;
+    overflow: hidden;
+    box-shadow: var(--shadow);
+  }
+  .topic-header {
+    padding: 12px 16px;
+    background: var(--accent-soft);
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    cursor: pointer;
+    user-select: none;
+  }
+  .topic-header:hover { background: #e0ebff; }
+  .topic-header .name { font-weight: 600; color: var(--accent); font-size: 15px; }
+  .topic-header .count {
+    background: var(--accent);
+    color: #fff;
+    border-radius: 12px;
+    padding: 2px 10px;
+    font-size: 12px;
+    font-weight: 500;
+  }
+  table {
+    width: 100%;
+    border-collapse: collapse;
+    font-size: 13px;
+  }
+  thead th {
+    text-align: left;
+    padding: 10px 16px;
+    background: #fafbfd;
+    border-bottom: 1px solid var(--border);
+    color: var(--muted);
+    font-weight: 500;
+    font-size: 12px;
+    text-transform: uppercase;
+    letter-spacing: .04em;
+  }
+  tbody td {
+    padding: 8px 16px;
+    border-bottom: 1px solid #f0f2f5;
+    vertical-align: top;
+  }
+  tbody tr:last-child td { border-bottom: none; }
+  tbody tr:hover { background: #fafbff; }
+  td.file { font-family: "SF Mono", Consolas, monospace; font-size: 12.5px; color: #111827; }
+  td.file a { color: var(--accent); text-decoration: none; }
+  td.file a:hover { text-decoration: underline; }
+  td.topic-cell { color: var(--muted); }
+  td.dir a {
+    color: var(--accent);
+    text-decoration: none;
+    font-family: "SF Mono", Consolas, monospace;
+    font-size: 12px;
+  }
+  td.dir a:hover { text-decoration: underline; }
+  footer { padding: 24px 40px; color: var(--muted); font-size: 12px; text-align: center; }
+</style>
+</head>
+<body>
+<header>
+  <h1>知识沉淀总览</h1>
+  <div class="meta">{{projectName}} · 项目知识沉淀</div>
+</header>
+
+<main>
+  <div class="summary" id="summary"></div>
+
+  <div class="toolbar">
+    <input type="text" id="search" placeholder="🔍 搜索文件名 / 主题 / 归属目录…" />
+    <select id="topicFilter">
+      <option value="">全部主题</option>
+    </select>
+  </div>
+
+  <div id="topics"></div>
+</main>
+
+<footer>看板由 wiki 技能生成 · 原始数据见 wiki/INDEX.md</footer>
+
+<script>
+const DATA = {
+  "summary": { "total": 0, "topics": 0, "files": 0, "archive": 0 },
+  "topics": []
+};
+
+// 顶部统计卡片
+document.getElementById('summary').innerHTML = `
+  <div class="stat"><div class="num">${DATA.summary.topics}</div><div class="lbl">主题数</div></div>
+  <div class="stat"><div class="num">${DATA.summary.files}</div><div class="lbl">知识文档</div></div>
+  <div class="stat"><div class="num">${DATA.summary.archive}</div><div class="lbl">草稿归档</div></div>
+  <div class="stat"><div class="num">${DATA.topics.reduce((s,t)=>s+t.files.length,0)}</div><div class="lbl">合计记录</div></div>
+`;
+
+// 主题过滤器
+const sel = document.getElementById('topicFilter');
+DATA.topics.forEach(t => {
+  const o = document.createElement('option');
+  o.value = t.name; o.textContent = `${t.name} (${t.files.length})`;
+  sel.appendChild(o);
+});
+
+function escapeHtml(s){ return String(s).replace(/[&<>"]/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;'}[c])); }
+
+function render(filterText='', topicFilter='') {
+  const container = document.getElementById('topics');
+  container.innerHTML = '';
+  DATA.topics
+    .filter(t => !topicFilter || t.name === topicFilter)
+    .forEach(t => {
+      const rows = t.files.filter(f =>
+        !filterText ||
+        f.file.toLowerCase().includes(filterText.toLowerCase()) ||
+        f.topic.toLowerCase().includes(filterText.toLowerCase()) ||
+        f.dir.toLowerCase().includes(filterText.toLowerCase())
+      );
+      if (rows.length === 0) return;
+      const section = document.createElement('div');
+      section.className = 'topic-section';
+      section.innerHTML = `
+        <div class="topic-header">
+          <span class="name">📁 ${escapeHtml(t.name)}</span>
+          <span class="count">${rows.length}</span>
+        </div>
+        <table>
+          <thead><tr><th style="width:40%">文件名</th><th style="width:20%">主题</th><th>归属目录</th></tr></thead>
+          <tbody>
+            ${rows.map(f => {
+              const base = f.file.split('/').pop();
+              const fileCell = /\.(html)$/i.test(f.file)
+                ? `<td class="file"><a href="${escapeHtml(f.dir + base)}" target="_blank" title="打开文档">${escapeHtml(f.file)}</a></td>`
+                : `<td class="file">${escapeHtml(f.file)}</td>`;
+              return `
+              <tr>
+                ${fileCell}
+                <td class="topic-cell">${escapeHtml(f.topic)}</td>
+                <td class="dir"><a href="${escapeHtml(f.dir)}" title="打开目录">${escapeHtml(f.dir)}</a></td>
+              </tr>`;
+            }).join('')}
+          </tbody>
+        </table>`;
+      container.appendChild(section);
+    });
+  if (!container.innerHTML) {
+    container.innerHTML = '<div class="topic-section" style="padding:24px;text-align:center;color:var(--muted)">无匹配记录</div>';
+  }
+}
+
+document.getElementById('search').addEventListener('input', e => render(e.target.value, sel.value));
+sel.addEventListener('change', e => render(document.getElementById('search').value, e.target.value));
+render();
+</script>
+</body>
+</html>

package/templates/scaffold/workflow/INDEX.md

@@ -0,0 +1,29 @@
+# workflow 索引（生成物，勿手改）
+
+> 由 `node .agents/scripts/gen-workflow-index.mjs` 从 `workflow/{intents,specs,plans,incidents}/` 重生成。
+> 本文件为新装户占位；首次生成后自动填充活跃层与档案表。
+
+## 活跃（0）
+
+| 类型 | 级别 | 状态 | 日期 | 模块 | 主题 | 进度 |
+|---|---|---|---|---|---|---|
+
+## 档案（只读，不增量）
+
+（历史终态件归档后由生成器列出。）
+
+<!-- GENERATED:BEGIN — gen-workflow-index.mjs 整段重写，手工说明写在本行之前 -->
+
+## 活跃（0）
+
+| 类型 | 级别 | 状态 | 日期 | 模块 | 标题 | 验收 |
+|---|---|---|---|---|---|---|
+
+## 档案计数（0，不进表）
+
+| 类型 | 模块 | 数量 |
+|---|---|---|
+
+终态构成：；查档案用 `node .agents/scripts/kb-search.mjs "<词>" --status all`。
+
+<!-- GENERATED:END -->

package/templates/scaffold/workflow/README.md

@@ -0,0 +1,69 @@
+# workflow — AI 驱动闭环流程（唯一真相源）
+
+本目录是 AI 工作流引擎的唯一载体。L1 新需求以一份 plan 为入口；L2/L3 新需求走 intent → spec → plan；修复走 incident。微观任务层采用「任务责任人（Task Owner）+ AI 结对闭环」，确认在对话内一句话完成（TTY / 委托代录）；宏观主干层支持多人协作协同，主干（main）合并由 TFS PR 分支策略（Peer Review 团队评审 + 与本地脚本同源的 Azure Pipelines CI 门禁）把关，追溯靠 git（commit + PR 记录 + release tag）。
+
+> 闭环新增记录一律写在本目录。
+
+## 目录结构
+
+| 目录 | 放什么 | 命名 |
+|------|--------|------|
+| `intents/` | L2/L3 新需求入口：背景、目标/非目标、验收标准、级别、触达红线。L1 新需求不建 | `YYYY-MM-DD-<主题>.md` |
+| `specs/` | L2/L3 设计规格：功能行为、数据流、系统改动、约束遵守映射。L1 不建 | 与 intent / incident 同名 |
+| `plans/` | L1 新需求入口（来源 / 目标 / 红线 / 改动方案 / 约束与风险 / 验证计划 / 验收标准）。L2/L3 与修复仍与 intent / incident 同名 | `YYYY-MM-DD-<主题>.md` |
+| `incidents/` | 事故复盘：时间线、根因、为什么没拦住、复盘三件套 | `YYYY-MM-DD-<主题>.md` |
+
+**命名一律英文 kebab-case**（如 `2026-09-07-supplier-rating-field.md`），**禁中文文件名**——原 check-loop §9 非 ASCII 文件名 warning 已随 2026-10-28 引擎减重退役，命名约定不变。文档内容（标题/正文）不受此限。
+
+**文档协议（2026-09-13 结构化）**：四类文档头部一律为 YAML frontmatter（受限子集，每行 `键: 值`，附 check-loop 机器字段唯一来源）——`状态`（intent/spec/plan：draft/approved/done/superseded/cancelled；incident：open/fixed/closed，**严格枚举**，附注写 `备注:` 键）、`级别`（L1/L2/L3）、`日期`/`发现`（YYYY-MM-DD）、`模块`（**2026-09-22 起新建文档必填**，取值见 `.agents/config/workflow-modules.txt` 词表，单值取主导模块；存量不回填，AI 触碰时顺手补）、L3 spec 的 `确认结果`/`确认时间`、回填件 `流程: legacy`。**`日期` 兜底口径（2026-10-27 修）**：plan 由 `fill-plan.mjs` 与 `plans/_TEMPLATE.md` 生成，**2026-10-27 起 frontmatter 写入 `日期`**（此前 renderPlan 收了 date 参数却不落盘）——凡以 frontmatter `日期` 为适用前提的门（委派台账在场门；检查 18 已随 2026-10-28 引擎减重退役），日期缺省时仍**回落文件名前缀** `YYYY-MM-DD` 作为第二道保险（沿检查 15 既有口径；检查 19 已退役）；frontmatter 与文件名皆无日期 → 不可判定 → 跳过。旧口径「无日期即整段跳过」曾使委派门对绝大多数 L2/L3 plan 静默失效（实测 52 份锚后 L2/L3 终态件从未被对账）。**`状态` 迁移须经 `approved`**（确认环节的机器可见态，`done` 只在关单出现）：2026-09-23 起新建的 spec/plan 若已 done 而 git 历史中从未出现行首 `状态: approved`，check-loop 报「确认态缺失」warning。check-loop 只扫 frontmatter 取机器字段（`fm_get` 字段断言），正文不再写「状态：/级别：」行；叙述性字段（独立复核/复盘三件套/验收勾验）仍留正文按节锚定。协议变更与存量迁移见 2026-09-13 `docs(workflow)` 提交。**模糊点显式阻断（2026-10-16，NEEDS-CLARIFICATION 标记）**：spec/plan 起草或修订遇无法自行决策的模糊点（多种解释 / 口径缺失 / 依赖外部事实）**禁止脑补**——原地插入 `[NEEDS CLARIFICATION]: <一句话问题>` 向用户求澄清，澄清后删除标记并把决策落为正文；状态推进 approved 前标记须清零（自检纪律；活跃件 grep 该标记即待澄清清单。跨产物断层自动体检延后——与「暂缓加门」取舍的冲突已显式登记，D6 度量补齐后再议）。**承诺面绑定（2026-10-27 新增）**：用户在 approved 那一刻点头的是**承诺面**（判据文本 / 红线 / 目标 / 改动方案 / 约束与风险）——承诺在确认后被改写而未重新点头 = 用户点头的不是关单时兑现的那一份。关单期合法动作（勾验收 + 证据回填、`确认结果`/`确认时间` 回填、复核行改锚）**不改承诺面**，经归一后不误伤；承诺判据被改写则 hard 拦（检查 15）+ 关单时刻拒收（confirm-doc 承诺面绑定门）。改承诺的**唯一出路** = 用户重新点头后跑 `confirm-doc <doc> --reconfirm --delegated "<原话>"` 重录承诺面指纹（不推进状态，状态行仍由 confirm-doc 写，不手改 frontmatter）；存量（上线前确认、台账行无 `commit` 字段）不追溯。**改已关单正文须同笔重录指纹（2026-11-10，incident 2026-10-26-workflow-confirmation-drift-hard-block）**：改已关单（done/superseded/closed/cancelled/fixed）文档正文 = 须同笔重录确认指纹（`confirm-doc` / `--reconfirm`）或走补偿行（`append-compensation.mjs`），否则 check-loop 判「确认内容漂移」；提交期有 `check-doc-body-drift.mjs` advisory 可见性（不合门）。
+
+各子目录内 `_TEMPLATE.md` 为起步模板，复制后填写，不直接改动模板本身。
+
+根目录 `regression-checklist.md` 为**活文档回归清单**：deploy 回归必过条目与 incident 防复发验证的统一落点，随模块上线补充、随 incident 追加。
+
+**三份 append-only 台账已分片**（2026-10-13 ledger-shard-ledgers）：`regression-checklist` / `delegations` / `papercuts` 的数据行按月存 `workflow/<台账>.d/<YYYY-MM>.md`，主台账只留说明、表头与 GENERATED 区——消除「每次追加全量重写整文件」的体积与合并冲突面。读写单源 = `.agents/scripts/ledger-shards.mjs`（读侧自动合并主台账 ∪ 全部分片，既有消费者无需改动）；追加一行用 `node .agents/scripts/ledger-shards.mjs --append <台账> --row "<行>"`。（第四份 `deploy-observations` 已随 deploy 仪式退役删除——2026-10-29 owner 拍板：实际发布不走 tag/24h 观察仪式，合入 = PR 创建→审查→回归→合并→归档，见 `deploy.md` 头注。）confirmations.d 分片始于 2026-10，2026-09 无分片（该月确认仅 git 口径可溯，历史缺口不回补）；jsonl 各台账 schema 代际以字段有无自描述（如 quoteGrounding 自 2026-10-24 起），不设版本字段（2026-11-05 决策）。
+
+**门禁判定月度分片**（2026-10-22 gate-metrics-shard）：`workflow/gate-metrics.d/<YYYY-MM>.jsonl` 每月一行（规则 × WARN/BLOCK），由 `node .agents/scripts/agg-judgments.mjs --emit-month` 生成、随提交入库；pre-push 月检自动补生成上月分片。退役判据（连续 N 月 = 0）读「本地 `.agents/judgments.jsonl` ∪ 分片」取 max——换机/换 worktree 不再归零，多机并集（`.gitattributes` 复用 `jsonl-union`）。
+
+**主张账**（按月追加）：`workflow/claims.d/<YYYY-MM>.jsonl` 记「未来会话可能当真的一句话」及其在仓库里的原文。追加用 `node .agents/scripts/claims.mjs add`；`recheck` 只报告原文还在不在，退出码恒 0，不是门，也不改账里的历史行。合并走 `jsonl-union`。
+
+## 使用方式
+
+- **发起新任务**：执行 `.agents/commands/new-task.md`（定级 + L0 极简道 / L1 快速道总入口）；L2/L3 进 `.agents/commands/stages.md` 四章（Plan → Design → Build → Test，2026-11-08 档 2-F 四并一）
+- **看板（可选，默认不拉起）**：需要时手动跑 `node .agents/scripts/ensure-board.mjs`（幂等：探活 / 旧代码自动重启 / 全新启动弹浏览器），实时只读 http://127.0.0.1:8933；**预警层，非门禁；告警口径对齐 check-loop 硬断档**。「旧代码」＝`board/index.html` 或 `workflow-board-server.mjs` 的 LastWriteTime 晚于看板进程启动 2s（任一更新即重启）；端口被占用时先探活 `/api/board`——响应不含 `cards` 即判为他人进程，不动手不 kill、跳过试下一端口
+- **检索**：活跃流程读 `INDEX.md`（生成物，`node .agents/scripts/gen-workflow-index.mjs` 重生成、`--check` 校验漂移）；跨语料检索 `node .agents/scripts/kb-search.mjs "<词>"`（workflow 按节级定位 + wiki 全文，`--type/--module/--status/-n` 过滤；`--status all` 显式全量）
+- **归档**：关单即归档（2026-10-13 archive-on-close）——`confirm-doc.mjs` 落终态后自动把**本次确认涉及的家族**（同名 intent/spec/plan/incident 整族）`git mv` 进 `workflow/archive/<终态月>/{类型}/`，活跃目录不再累积终态件。**特性分支默认不归档**（2026-10-15 起，防 CI 泳道门拦合法合并）——合并后由 main/develop 关单或 sweep 承接，未满 21 天窗的滞留属正常态。历史积压用 `node .agents/scripts/archive-sweep.mjs [--window 21] [--execute]`（缺省 dry-run）手工批次清理；归档件仍可被 `kb-search` 检索（`archive/<批次>/<type>` 已覆盖），check-loop 配对门与内容绑定只扫四目录直下、对归档件不触发。终态件积压时人工月度跑一轮 archive-sweep（dry-run 先看候选，`--execute` 执行）。
+- **spec 生命周期口径（2026-10-16 owner 拍板，Böckeler 三层分类取 spec-anchored + 长期维护）**：spec 是**持续对照的事实源，交付后不失效**——代码改动触及某 spec 覆盖的行为时须对照该 spec（含归档件）：行为漂移要么改代码回到 spec，要么同一提交回改 spec；有争议立 incident 裁决。**归档是容量治理不是失效**：归档只把终态件移出活跃扫描面（INDEX 活跃行 / check-loop 四目录扫描 / 月度再生），事实源地位与修订权不变——归档 spec 可原地修订，修订不改归档位置。体积治理先观察后设限：spec 行数/验收条数分布由 metrics.md 观察列采集（advisory 上限与「暂缓加门」取舍冲突，显式延后至 D6 度量补齐后再议）。
+- **同功能续作（先查后建，2026-10-22）**：动工前按「模块 + 功能关键词」检索 `workflow/specs/`、`workflow/archive/**/specs/`、`.agents/skills/verify-ui/features/`、`workflow/regression-checklist.md`。命中覆盖同一行为 → 在原件上修订（spec 按上条口径原地改，不新建）；确属新特性才新建。新建任务文档时 topic 带特性键，便于后续检索。
+- **验证**：`.agents/commands/stages.md` Test 章（静态门 + UI 实测）；切库探活与 API 防复发断言跑 `node scripts/verify/business/regression-smoke.mjs`（默认只读；`--writes` 自建自清探针，仅 dev 库）
+- **评审**：`.agents/commands/review.md`（按 P0 / P1 / P2 分级：机器兜底 + AI 自查出清单，用户决策定性与合入）
+- **PR 面板评审**：面板已退役为**手动工具**（2026-11-09 自动门退役）——pre-push / CI / pr-create 不再强制评审台账，需要时按 `.agents/commands/pr-review.md` 手动编排；建 PR 走 `node .agents/scripts/pr-create.mjs ...`（先 gate 再调 `tfs-pr create`）
+- **上线**：`.agents/commands/deploy.md`（上线前必跑清单）
+- **量化**：委派/自做结果记 `delegations.md`，聚合跑 `node .agents/scripts/agg-delegations.mjs`（**并发扩容门槛见该文件——数字达标前不扩并发**）；语料与常驻面体积的**月度快照**跑 `node .agents/scripts/gen-workflow-metrics.mjs`（每月一行落 `metrics.md`，同月重跑即更新；明细看 stdout）
+- **追溯**：git 即审计。两条驱动路径二选一、禁混用——手动阶段路由（确认后的 workflow 文档用 `docs(workflow)` 收成一笔，代码提交另笔；L1 普通需求只有 plan，修复为 incident+plan，L2/L3 为入口+spec+plan）或 `pipeline-run` 状态机（按阶段 `docsCommit` 落同形态提交，驱动协议单源 `.agents/commands/pipeline-run.md`）。上线不走 tag/24h 观察仪式（release tag 与发布观察台账已退役，2026-10-29）。本地开发依靠 Independent Reviewer 做认知隔离自查，主干合并通过 TFS PR 团队评审与 git 历史形成完整审计证据
+- **级别**：L1 实现级（未命中 L2/L3；新需求的入口是 plan）｜ L2 规则 / 契约（编码权威 / 共享契约 / 既有接口语义 / 全局横切口径，触达面闭集见 `.agents/commands/new-task.md`）｜ L3 数据与运行时结构（schema / 迁移 SQL / DI 链 / 认证与中间件管线）。混合改动就高不就低
+
+## 执行模型
+
+- 默认宿主主智能体负责阶段路由、用户确认、关键判断和最终验收，不注册为额外角色。
+- 阶段命令仅在边界明确时委派 `.agents/roles/implementer.md`、`.agents/roles/independent-reviewer.md`、`.agents/roles/ui-verifier.md`。
+- OpenCode、Trae、ZCode 分别通过 `.opencode/agents/`、`.trae/agents/`、`.zcode/agents/` 下的薄 Adapter 注册角色；角色行为只维护在 `.agents/roles/`。
+- PI 通过 `.pi/agents/` 注册 7 篇角色薄壳（契约同 `.agents/roles/`）；`.pi/extensions/` 把 tool_call 接到 `.agents/hooks/` 两门，判据单源不复制。`.pi/` 为本机私有目录（`.gitignore`），不随 clone 传播；阶段命令按根 `AGENTS.md` §4 路由表由主 Agent 直读 `.agents/commands/*.md`（pi 无 wf-* 命令壳），接线实态由 `check-local-gates.mjs` advisory 对账，机理见 `runtime-env.md` §6.4。
+- Cline 通过 `.cline/workflows/`（7 篇指针壳 → `.agents/commands/`）与 `.cline/agents/`（7 篇角色定义，**YAML** → `.agents/roles/`）接入；Cline 原生读 `AGENTS.md` 与 `.agents/skills/`，故规则面与技能面零改动生效。`.cline/` 为本机私有目录（`.gitignore`），不随 clone 传播；**两道门未接线**（Cline hook 协议与仓库 `.agents/hooks/*.cjs` 不兼容，接入需协议适配层），机理见 `runtime-env.md` §6.4。
+- 宿主不支持子智能体时按命令 frontmatter 的 `fallback` 执行；但**独立复核项不设 fallback**——L2 / L3 的 `independent-reviewer` 一律 `required: true`，宿主不支持子智能体时另开新会话，不得回退为原主智能体自查。
+- 子智能体不得跨越用户确认门，也不得自行提交、合入或上线；所有结果由主智能体复核后交用户决策。
+
+## 闭环规则
+
+1. L1 新需求始于已确认的 plan，不另立 intent。L2/L3 新需求始于已确认的 intent。修复始于已确认的 incident；L1 修复再立同名 L1 plan，走 `.agents/commands/new-task.md` §L1 快速道（常态不打开 `stages.md`）
+2. L2/L3 必须先有同名 spec 确认通过（L2/L3 一律强制独立复核，见 `stages.md` Design §3），方可起草 plan。L1 plan 在 `new-task.md` §L1 快速道起草并确认（`stages.md` 只管 L2/L3），节为入口 / 改动方案 / 约束与风险 / 验证计划 / 验收标准
+3. 实现产物必须通过静态门（架构红线 + build + test）
+4. 线上 / 实测缺陷回落到 `incidents/`，复盘三件套（新 intent、防复发验证、规范条目）缺一不可；**根因属「门禁缺位 / 规范未落地 / 系统性问题」时，即使结构性修复已完成也必须立新 intent** 追踪系统性改进，禁止以「修复已完成」为由绕过 intent 回路
+5. 关单在 test，不依赖是否上 prod。L1 勾验 plan「验收标准」并补证据后 plan → done。L2/L3 勾验 intent「验收标准」后 intent → done，同名 plan 一并 done。修复类 incident 走 open → fixed → closed，同名 plan 一并 done。done 仍有未勾项会被 check-loop 拦（2026-09-12 起新建文档 hard-block，存量仅提示不回填）。上 prod 另走 deploy（PR 合入清单，不走 tag/24h 仪式）
+6. 放弃留档：方案曾确认后不做 → `superseded`；未完成即取消 → `cancelled`。二者均为已确认终态，check-loop 不按「状态未确认」拦截；L3 放弃件豁免「确认结果必须为 approved」
+7. 后续回归清单与周检清单也归档本目录
+8. **检查 17（发版草稿门）已于 2026-10-21 退役删码**：本仓根 `package.json` 无 `version` 字段，版本锚条件永不成立（2026-10-06 盘点）；发版不走 tag 仪式（见「追溯」节）。该 hard 门已不存在，勿再按「恒跳过」理解
+
+## 历史归档（只读，不增量）
+
+- 新需求设计文档一律写进 `workflow/specs/` 或 `workflow/plans/`；关键路径提炼进 `workflow/regression-checklist.md`。

package/templates/scaffold/workflow/archive/README.md

@@ -0,0 +1,3 @@
+# 历史归档
+
+> 终态件按年月归档于此，只读不增量。归档协议见 `workflow/README.md`。