agentic-flow-kit 0.2.0 → 0.3.0

package/templates/wiki//345/274/200/345/217/221/346/226/271/346/241/210/README.md

@@ -0,0 +1,3 @@
+# 开发方案 — 技术方案与设计文档
+
+架构设计、接口方案、关键取舍与评审记录归此。落码前的方案定稿入位，过程讨论归 `../drafts-archive/`。

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

@@ -0,0 +1,3 @@
+# 数据维护 — schema 变更与数据修复台账
+
+顶层放汇总文档；变更/修复按子目录 `<批次>/` 组织，批内 README.md 记账（引擎特例：本主题子目录不参与 INDEX 文件级登记，见 gen-wiki-board.mjs）。

package/templates/wiki//346/265/213/350/257/225/346/212/245/345/221/212/README.md

@@ -0,0 +1,3 @@
+# 测试报告 — 测试报告与验收记录
+
+按 `<日期>-<主题>` 命名（如 `2026-09-24-采购入库回归.md`）；关门单的验收证据链接 workflow/ 闭环文档，不重复粘贴。

package/templates/wiki//347/224/250/346/210/267/345/212/237/350/203/275/README.md

@@ -0,0 +1,3 @@
+# 用户功能 — 功能清单与操作说明
+
+按功能视角组织：功能清单、页面/角色操作说明、成套截图文档。与「产品需求」的分工：那里记"为什么做"，这里记"怎么用、有哪些"。

package/templates/wiki//351/241/271/347/233/256/350/247/204/350/214/203/README.md

@@ -0,0 +1,3 @@
+# 项目规范 — 编码 / 流程 / 协作规范
+
+编码规范、分支与提交约定、目录级 AGENTS 补充等团队契约归此；只放现行有效版本，历史版本走 `../drafts-archive/`。

package/templates/wiki//351/241/271/347/233/256/350/256/241/345/210/222/README.md

@@ -0,0 +1,3 @@
+# 项目计划 — 计划、里程碑与会议纪要
+
+排期计划、里程碑、复盘纪要归此；按日期命名（如 `2026-Q4-排期.md`）。

package/templates/workflow/README.md

@@ -24,9 +24,9 @@
 ## 使用方式
 
 - **发起新任务**：执行 `.agents/commands/new-task.md` 定义的流程（6 阶段总入口）
-- **看板**：任务入口幂等拉起 .agents/scripts/ensure-board.ps1（探活 / 旧代码自动重启 / 全新启动弹浏览器），服务只起不关，实时只读 http://127.0.0.1:{{BOARD_PORT}}；**预警层，非门禁；告警口径对齐 check-loop 硬断档**。端口被占用时先探活 `/api/board`——响应不含 `cards` 即判为他人进程，打印 pid / 进程名并退出，不 kill
+- **看板（可选，默认不拉起）**：需要时手动跑 .agents/scripts/ensure-board.ps1（幂等：探活 / 旧代码自动重启 / 全新启动弹浏览器），实时只读 http://127.0.0.1:{{BOARD_PORT}}；**预警层，非门禁；告警口径对齐 check-loop 硬断档**。端口被占用时先探活 `/api/board`——响应不含 `cards` 即判为他人进程，打印 pid / 进程名并退出，不 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` 显式全量）
-- **验证**：`.agents/commands/test.md`（静态门 + 实测；项目自有验证脚本/门禁如有，见 `.agents/hooks/local-pre-commit` 与 test.md 项目适配区）
+- **验证**：`.agents/commands/test.md`（静态门 + 实测；项目自有验证脚本/门禁如有，见 `.agents/hooks/local-pre-commit` 与根 `AGENTS.md`「项目适配区」）
 - **评审**：`.agents/commands/review.md`（按 P0 / P1 / P2 分级：机器兜底 + AI 自查出清单，用户决策定性与合入）
 - **上线**：`.agents/commands/deploy.md`（上线前必跑清单）
 - **量化**：委派/自做结果记 `delegations.md`，聚合跑 `node .agents/scripts/agg-delegations.cjs`（**并发扩容门槛见该文件——数字达标前不扩并发**）；语料与常驻面体积的**月度快照**跑 `node .agents/scripts/gen-workflow-metrics.mjs`（每月一行落 `metrics.md`，同月重跑即更新；明细看 stdout）

package/templates/workflow/intents/_TEMPLATE.md

@@ -1,40 +1,40 @@
----
-状态: draft
-级别: L1
-日期: YYYY-MM-DD
-模块: <词表之一，见 .agents/workflow-modules.txt>
-备注: <可选：附注自由文本，check-loop 不解析>
----
-# INTENT — <主题>
-<!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写；plans/ 下同名文件与本文件配对 -->
-<!-- frontmatter 受限子集（2026-09-13）：每行 `键: 值`；状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；check-loop 只扫 frontmatter 取机器字段，正文不再写状态/级别行 -->
-
-## 背景与问题
-<为什么做；写明需求来源（工单 / 沟通记录 / 待办事项）>
-
-## 目标
-- <可验证的目标>
-
-## 非目标（L1 微改动无实质内容可删本节，不硬填）
-- <明确不做的，防止范围蔓延>
-
-## 约束（L1 微改动无实质内容可删本节，不硬填）
-- <复用什么、不许动什么>
-
-## 影响面
-- 模块：<词表之一，见 .agents/workflow-modules.txt>
-- 数据库：无 / <表名>（涉及 schema 变更 → L3；无 schema 的运行时 / 管线结构面亦为 L3，判据见 `.agents/commands/new-task.md` §级别判断）
-- 前端页面：<路由或组件，无则删本行>
-
-## 触达红线（对照 AGENTS.md，勾选仅标记触及范围；具体如何满足在同名 spec 中说明）
-- [ ] <按本项目 AGENTS.md 红线逐行补；无则删本行>
-- [ ] 规则 / 契约变更（编码权威 / 共享契约 / 接口签名 / 既有参数语义 / 全局口径）→ 级别至少 L2
-- [ ] schema / 迁移 SQL / DI 链 / 认证与中间件管线 → 级别 L3
-
-> 触及任一红线即为 L2 / L3，必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足，方可起草 plan。
-
-## 验收标准（可测试）
-- [ ] <逐条可测试；写不出可测试判据 = 还没想清楚>
-
-> **闭环对账**：关单在 test 阶段（不依赖 deploy）。intent 置 done 前逐条勾验，每条勾选项后补证据——`- [x] <判据>（证据：<commit SHA / 测试用例名 / 冒烟脚本输出>）`。
-> done 状态仍有未勾项会被 check-loop 拦截（2026-09-12 起新建 intent 为 hard-block，存量 intent 仅 warning 提示）；勾选但缺「证据：」为 warning。
+---
+状态: draft
+级别: L1
+日期: YYYY-MM-DD
+模块: <词表之一，见 .agents/workflow-modules.txt>
+备注: <可选：附注自由文本，check-loop 不解析>
+---
+# INTENT — <主题>
+<!-- 复制本模板为 YYYY-MM-DD-<主题>.md 后填写；plans/ 下同名文件与本文件配对 -->
+<!-- frontmatter 受限子集（2026-09-13）：每行 `键: 值`；状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；check-loop 只扫 frontmatter 取机器字段，正文不再写状态/级别行 -->
+
+## 背景与问题
+<为什么做；写明需求来源（工单 / 沟通记录 / 待办事项）>
+
+## 目标
+- <可验证的目标>
+
+## 非目标（L1 微改动无实质内容可删本节，不硬填）
+- <明确不做的，防止范围蔓延>
+
+## 约束（L1 微改动无实质内容可删本节，不硬填）
+- <复用什么、不许动什么>
+
+## 影响面
+- 模块：<词表之一，见 .agents/workflow-modules.txt>
+- 数据库：无 / <表名>（涉及 schema 变更 → L3；无 schema 的运行时 / 管线结构面亦为 L3，判据见 `.agents/commands/new-task.md` §级别判断）
+- 前端页面：<路由或组件，无则删本行>
+
+## 触达红线（对照 AGENTS.md，勾选仅标记触及范围；具体如何满足在同名 spec 中说明）
+- [ ] <按本项目 AGENTS.md 红线逐行补；无则删本行>
+- [ ] 规则 / 契约变更（编码权威 / 共享契约 / 接口签名 / 既有参数语义 / 全局口径）→ 级别至少 L2
+- [ ] schema / 迁移 SQL / DI 链 / 认证与中间件管线 → 级别 L3
+
+> 触及任一红线即为 L2 / L3，必须立 ../specs/YYYY-MM-DD-<主题>.md 写明如何满足，方可起草 plan。
+
+## 验收标准（可测试）
+- [ ] <逐条可测试；写不出可测试判据 = 还没想清楚>
+
+> **闭环对账**：关单在 test 阶段（不依赖 deploy）。intent 置 done 前逐条勾验，每条勾选项后补证据——`- [x] <判据>（证据：<commit SHA / 测试用例名 / 冒烟脚本输出>）`。
+> done 状态仍有未勾项会被 check-loop 拦截（2026-09-12 起新建 intent 为 hard-block，存量 intent 仅 warning 提示）；勾选但缺「证据：」为 warning。

package/templates/workflow/specs/_TEMPLATE.md

@@ -1,41 +1,41 @@
----
-状态: draft
-级别: L1
-模块: <词表之一，见 .agents/workflow-modules.txt>
----
-# SPEC — <与入口文档同名主题>
-<!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2 / L3 必须先有 spec 确认通过方可起草 plan；L1 可省略 -->
-<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled（done=关单、superseded=曾确认后放弃、cancelled=未完成即取消）；L3 确认通过后在 frontmatter 追加两行：`确认结果: approved` 与 `确认时间: YYYY-MM-DD`（check-loop 对 L3 强制校验） -->
-
-对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）
-
-## 功能行为
-<讲清功能怎么工作；分小节列用户 / 系统行为，必要时附状态机 / 时序图说明>
-
-## 数据流
-<数据从哪里来 → 经过哪些处理 → 落到哪里；含字段映射、接口契约、上下游依赖>
-
-## 系统改动清单
-- 后端：模块 / 文件 / 接口契约
-- 数据库：无 / <表名 + 字段 + 迁移 SQL 路径>
-- 前端：路由 / 组件 / store / api
-
-## 约束遵守映射（对照 AGENTS.md 触达红线）
-| 红线（按本项目 AGENTS.md 实际红线逐行填，没有的行删除） | 本 spec 如何满足 |
-|------|------------------|
-| <示例：分层依赖约束 / 编码权威归属 / 数据迁移方式> | <通过 XXX，不引入 YYY；是否触及（触及即 L2 定级依据）> |
-| <示例：schema / 迁移路径约束> | <涉及路径与处理方式> |
-| <示例：前端或客户端约定（如有）> | <本 spec 涉及哪些约定> |
-
-## 风险评估
-- <风险点 1> ｜ 应对：<测试 / hook / 评审>
-- <风险点 2> ｜ 应对：…
-
-## 确认与复核
-> 个人工作流：确认 = 用户在对话内一句话通过；无第二审批人，追溯靠 git（commit 记录确认时点）。
-> 确认结果 / 确认时间写在文件头 frontmatter（L3 由 check-loop 强制校验）；本节只留叙述性复核记录。
-
-- 独立复核：<L3 强制：另开新会话由 AI 复核本 spec，记录复核会话与结论；L1 / L2 无则删除本行>
-- 复核结论：<无则删除本行>
-- 返修意见：<无则删除本行>
-- 确认通过后，方可起草 ../plans/YYYY-MM-DD-<主题>.md
+---
+状态: draft
+级别: L1
+模块: <词表之一，见 .agents/workflow-modules.txt>
+---
+# SPEC — <与入口文档同名主题>
+<!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2 / L3 必须先有 spec 确认通过方可起草 plan；L1 可省略 -->
+<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled（done=关单、superseded=曾确认后放弃、cancelled=未完成即取消）；L3 确认通过后在 frontmatter 追加两行：`确认结果: approved` 与 `确认时间: YYYY-MM-DD`（check-loop 对 L3 强制校验） -->
+
+对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）
+
+## 功能行为
+<讲清功能怎么工作；分小节列用户 / 系统行为，必要时附状态机 / 时序图说明>
+
+## 数据流
+<数据从哪里来 → 经过哪些处理 → 落到哪里；含字段映射、接口契约、上下游依赖>
+
+## 系统改动清单
+- 后端：模块 / 文件 / 接口契约
+- 数据库：无 / <表名 + 字段 + 迁移 SQL 路径>
+- 前端：路由 / 组件 / store / api
+
+## 约束遵守映射（对照 AGENTS.md 触达红线）
+| 红线（按本项目 AGENTS.md 实际红线逐行填，没有的行删除） | 本 spec 如何满足 |
+|------|------------------|
+| <示例：分层依赖约束 / 编码权威归属 / 数据迁移方式> | <通过 XXX，不引入 YYY；是否触及（触及即 L2 定级依据）> |
+| <示例：schema / 迁移路径约束> | <涉及路径与处理方式> |
+| <示例：前端或客户端约定（如有）> | <本 spec 涉及哪些约定> |
+
+## 风险评估
+- <风险点 1> ｜ 应对：<测试 / hook / 评审>
+- <风险点 2> ｜ 应对：…
+
+## 确认与复核
+> 个人工作流：确认 = 用户在对话内一句话通过；无第二审批人，追溯靠 git（commit 记录确认时点）。
+> 确认结果 / 确认时间写在文件头 frontmatter（L3 由 check-loop 强制校验）；本节只留叙述性复核记录。
+
+- 独立复核：<L3 强制：另开新会话由 AI 复核本 spec，记录复核会话与结论；L1 / L2 无则删除本行>
+- 复核结论：<无则删除本行>
+- 返修意见：<无则删除本行>
+- 确认通过后，方可起草 ../plans/YYYY-MM-DD-<主题>.md