agentic-flow-kit 1.8.7 → 2.1.0

package/templates/workflow/specs/_TEMPLATE.md

@@ -1,80 +0,0 @@
----
-状态: 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 强制校验） -->
-<!-- 待澄清标记（2026-10-12 needs-clarification）：起草时**不确定的地方照实写一行** `- 待澄清：<你卡在哪>`，
-     不要猜一个填上去——「我不知道」是负责，猜是失职（与检查 2 的模板占位符语义相反：占位符是忘了填）。
-     起草门不拦（不阻塞你继续写）；但 draft→approved 确认时仍挂着未澄清项会被 confirm-doc 拒绝落账——
-     确认即「认可这份文档」，文档里写着「这里我不知道」就没法确认。
-     解决后把行首改成 `- 已澄清：…`（**保留该行**，留痕曾不清楚过，便于事后对质）或直接删行。
-     判据单源：stage-gates.mjs#openClarifications / clarifyGateFor（confirm-doc 消费）。 -->
-
-对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）
-
-## 功能行为
-<讲清功能怎么工作；分小节列用户 / 系统行为，必要时附状态机 / 时序图说明>
-
-## 验收场景（可选）
-<结构化验收用例，GIVEN/WHEN/THEN 三行写法。每条带场景 ID（S1、S2…），同名 intent 的「验收标准」
-按 ID 逐条引用——check-loop 检查 8 会校验场景覆盖（缺引用 = warning，灰度第一档）。
-THEN 行是机器对账断言：声明了场景却缺「- THEN <可观测结果>」行 = 空壳场景，check-loop 出
-[WARN 场景无断言]（advisory，灰度第一档）。
-**本节可选**：不写时检查 8 走原「逐条勾验」判据，行为零变化；写了则 intent 的验收标准应覆盖全部场景 ID。>
-
-### S1 <场景名>
-- GIVEN <前置条件>
-- WHEN <触发动作>
-- THEN <可观测的结果断言>
-
-### S2 <场景名>
-- GIVEN <前置条件>
-- WHEN <触发动作>
-- THEN <可观测的结果断言>
-
-## 数据流
-<数据从哪里来 → 经过哪些处理 → 落到哪里；含字段映射、接口契约、上下游依赖>
-
-## 系统改动清单
-- 后端：模块 / 文件 / 接口契约
-- 数据库：无 / <表名 + 字段 + 迁移 SQL 路径>
-- 前端：路由 / 组件 / store / api
-
-## 约束遵守映射（对照 AGENTS.md 触达红线）
-| 红线 / 工程原则（按本项目 AGENTS.md 红线与「工程原则」节实际行逐行填，没有的行删除） | 本 spec 如何满足 |
-|------|------------------|
-| <示例：分层依赖约束 / 编码权威归属 / 数据迁移方式> | <通过 XXX，不引入 YYY；是否触及（触及即 L2 定级依据）> |
-| <示例：schema / 迁移路径约束> | <涉及路径与处理方式> |
-| <示例：前端或客户端约定（如有）> | <本 spec 涉及哪些约定> |
-
-## 验收判据
-<!-- 判据级收敛对账的机器输入（check-loop 验收判据对账段，2026-10-13 自 Shipyard 回灌；B6b 落地后编号以 check-loop.mjs 头部清单为准）：
-     每行一条判据，「证据」须机器可解析。路径：文件必须存在。机器不读正文，不判断它和判据是否相关（那一步留给新会话复核）。
-     命令：只认全量门跑过的 `npm test` / `node .agents/scripts/verify.mjs`（kit 全量门 = verify.mjs 七门编排；
-     装户项目测试命令各异，verify.mjs `--test-cmd` 注入的算 npm test 面）。
-     还须 workflow/verify-evidence.md 有一行时间不早于本 spec「日期」的全绿凭证；没有这行 = 未覆盖。
-     日期口径：frontmatter「日期」与全绿行时间同为 UTC（fill-spec 默认即此）；手写勿用本地时区日期——
-     UTC+8 凌晨 0–8 点落的全绿行日期为前一日，会对不上（硬拦，08:00 后重跑门即解）。
-     不在全量门里的检查（UI 实测 / 回归冒烟等）改记证据文件路径。
-     「状态」写「覆盖」而证据无效仍判未覆盖。人工走查状态写「人工」，证据列留空（仅「人工+空证据」豁免机器对账；
-     截图等图片不在路径白名单，需留痕改存 .md 报告后引路径）。
-     无本节或表为空 → WARN；证据无效的 WARN / HARD-BLOCK 分档与生效锚随 B6b 对账段落地。 -->
-| 判据（可观察行为） | 证据（测试文件 / 命令 / 证据文件） | 状态 |
-|---|---|---|
-| <行为 1> | <路径或命令> | <覆盖 / 未覆盖 / 人工> |
-
-## 风险评估
-- <风险点 1> ｜ 应对：<测试 / hook / 评审>
-- <风险点 2> ｜ 应对：…
-
-## 确认与复核
-> 个人工作流：确认 = 用户在对话内一句话通过；无第二审批人，追溯靠 git（commit 记录确认时点）。
-> 确认结果 / 确认时间写在文件头 frontmatter（L3 由 check-loop 强制校验）；本节只留叙述性复核记录。
-
-- 独立复核：<L3 强制：另开新会话由 AI 复核本 spec，记录复核会话与结论；L1 / L2 无则删除本行。复核行须落「复核上下文：<会话/子代理 id>」——隔离前提的机器事实，advisory>
-- 复核结论：<无则删除本行>
-- 返修意见：<无则删除本行>
-- 确认通过后，方可起草 ../plans/YYYY-MM-DD-<主题>.md