agentic-flow-kit 0.2.0 → 0.2.1

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