@gong-ym/ai-spec-auto 0.2.13 → 0.2.15

package/.agents/flows/common/bugfix-to-verification.md

@@ -1,95 +1,95 @@
----
-id: bugfix-to-verification
-version: 1
-name: 缺陷修复到验证
-status: active
-type: flow-template
-owner: task-orchestrator
-description: 面向全新、低风险、小范围 bug 修复或样式/文案/小交互调整的轻量协作模板。默认不进入 OpenSpec change 目录，而是在 .ai-spec/history/<run-id>/ 下保留最小留痕。
-triggers:
-  - bugfix-routing
-  - small-change
-  - style-adjustment
-required_roles:
-  - frontend-implementer
-  - code-guardian
-optional_roles:
-  - unit-test-specialist
-  - verification-reviewer
-  - performance-auditor
-approval_gates: []
-artifacts:
-  - code
-  - .ai-spec/history/<run-id>/bugfix.md
-  - .ai-spec/history/<run-id>/implementation-notes.md
-  - .ai-spec/history/<run-id>/checklist.md
-  - .ai-spec/history/<run-id>/iterations.md
-visibility: internal
-domains:
-  - engineering
-  - testing
----
-
-# bugfix-to-verification
-
-## 模板定位
-
-这条模板服务于“小而明确”的修复型需求，不替代 `prd-to-delivery`，也不把小修正偷偷升级成完整需求流程。
-
-它适用于：
-
-- 单页面、单组件、单模块的 bug 修复
-- 样式微调、文案调整、小交互修正
-- 风险等级低、无需长期 OpenSpec 规范沉淀的修正
-
-## 不适用场景
-
-以下情况应升级回 `prd-to-delivery`：
-
-- 新增真实 API、路由或全局状态
-- 影响需求范围、验收边界或方案决策
-- 涉及权限、支付、风控、合规等高风险逻辑
-- 需要长期归档、评审或显式 spec 留痕
-
-## 基础骨架
-
-本模板固定骨架为：
-
-1. `frontend-implementer`
-2. `code-guardian`
-
-默认不进入 `requirement-analyst`，也不经过 `archive-change`。
-
-## 可选专家插入规则
-
-| 条件 | 建议插入专家 | 作用 |
-| --- | --- | --- |
-| 修复涉及复杂逻辑、store、明显回归风险 | `unit-test-specialist` | 补关键测试策略 |
-| 需要更强验收证据或复核 | `verification-reviewer` | 补强验证结论 |
-| 修复指向性能问题 | `performance-auditor` | 给出性能风险判断 |
-
-## 主要产物
-
-至少要沉淀以下内容：
-
-- 与本次修复相关的代码实现
-- `.ai-spec/history/<run-id>/bugfix.md`
-- `.ai-spec/history/<run-id>/implementation-notes.md`
-- `.ai-spec/history/<run-id>/checklist.md`
-- `.ai-spec/history/<run-id>/iterations.md`
-
-## 完成标准
-
-当满足以下条件时，本模板可视为完成：
-
-- 修复范围仍然限定在低风险小需求边界内
-- `bugfix.md` 说明了问题、影响范围、复现和限制
-- `implementation-notes.md` 说明了修复动作、验证结果和残留风险
-- `checklist.md` 给出通过 / 未通过 / 阻断项 / 证据 / 是否放行
-- `iterations.md` 记录问题、修正动作、残留风险和后续提醒
-
-## 说明
-
-这条模板的目标是“更轻”，不是“更随意”。
-
-一旦守护阶段发现范围已经越出小修正边界，应立即阻断并升级到 `prd-to-delivery`。
+---
+id: bugfix-to-verification
+version: 1
+name: 缺陷修复到验证
+status: active
+type: flow-template
+owner: task-orchestrator
+description: 面向全新、低风险、小范围 bug 修复或样式/文案/小交互调整的轻量协作模板。默认不进入 OpenSpec change 目录，而是在 .ai-spec/history/<run-id>/ 下保留最小留痕。
+triggers:
+  - bugfix-routing
+  - small-change
+  - style-adjustment
+required_roles:
+  - frontend-implementer
+  - code-guardian
+optional_roles:
+  - unit-test-specialist
+  - verification-reviewer
+  - performance-auditor
+approval_gates: []
+artifacts:
+  - code
+  - .ai-spec/history/<run-id>/bugfix.md
+  - .ai-spec/history/<run-id>/implementation-notes.md
+  - .ai-spec/history/<run-id>/checklist.md
+  - .ai-spec/history/<run-id>/iterations.md
+visibility: internal
+domains:
+  - engineering
+  - testing
+---
+
+# bugfix-to-verification
+
+## 模板定位
+
+这条模板服务于“小而明确”的修复型需求，不替代 `prd-to-delivery`，也不把小修正偷偷升级成完整需求流程。
+
+它适用于：
+
+- 单页面、单组件、单模块的 bug 修复
+- 样式微调、文案调整、小交互修正
+- 风险等级低、无需长期 OpenSpec 规范沉淀的修正
+
+## 不适用场景
+
+以下情况应升级回 `prd-to-delivery`：
+
+- 新增真实 API、路由或全局状态
+- 影响需求范围、验收边界或方案决策
+- 涉及权限、支付、风控、合规等高风险逻辑
+- 需要长期归档、评审或显式 spec 留痕
+
+## 基础骨架
+
+本模板固定骨架为：
+
+1. `frontend-implementer`
+2. `code-guardian`
+
+默认不进入 `requirement-analyst`，也不经过 `archive-change`。
+
+## 可选专家插入规则
+
+| 条件 | 建议插入专家 | 作用 |
+| --- | --- | --- |
+| 修复涉及复杂逻辑、store、明显回归风险 | `unit-test-specialist` | 补关键测试策略 |
+| 需要更强验收证据或复核 | `verification-reviewer` | 补强验证结论 |
+| 修复指向性能问题 | `performance-auditor` | 给出性能风险判断 |
+
+## 主要产物
+
+至少要沉淀以下内容：
+
+- 与本次修复相关的代码实现
+- `.ai-spec/history/<run-id>/bugfix.md`
+- `.ai-spec/history/<run-id>/implementation-notes.md`
+- `.ai-spec/history/<run-id>/checklist.md`
+- `.ai-spec/history/<run-id>/iterations.md`
+
+## 完成标准
+
+当满足以下条件时，本模板可视为完成：
+
+- 修复范围仍然限定在低风险小需求边界内
+- `bugfix.md` 说明了问题、影响范围、复现和限制
+- `implementation-notes.md` 说明了修复动作、验证结果和残留风险
+- `checklist.md` 给出通过 / 未通过 / 阻断项 / 证据 / 是否放行
+- `iterations.md` 记录问题、修正动作、残留风险和后续提醒
+
+## 说明
+
+这条模板的目标是“更轻”，不是“更随意”。
+
+一旦守护阶段发现范围已经越出小修正边界，应立即阻断并升级到 `prd-to-delivery`。

package/.agents/flows/common/change-to-architecture-review.md

@@ -1,89 +1,89 @@
----
-id: change-to-architecture-review
-version: 1
-name: 变更到架构评审
-status: active
-type: flow-template
-owner: task-orchestrator
-description: 面向跨模块改动、依赖调整和结构性演进的架构评审模板。用于在实现前或实现中期补一轮边界与影响分析。
-triggers:
-  - architecture-review
-  - module-boundary-design
-  - dependency-audit
-required_roles:
-  - architecture-advisor
-  - dependency-governor
-optional_roles:
-  - requirement-analyst
-  - code-guardian
-approval_gates: []
-artifacts:
-  - architecture-notes
-  - module-boundary-suggestions
-  - dependency-audit-notes
-  - upgrade-plan
-visibility: internal
-domains:
-  - engineering
-  - governance
----
-
-# change-to-architecture-review
-
-## 模板定位
-
-这条模板服务于“改动已经超出单点实现，需要先看结构和影响面”的场景。
-
-它重点处理：
-
-- 模块边界是否清楚
-- 依赖引入或升级是否值得
-- 结构性改动会影响谁
-- 后续实现应如何拆分和回滚
-
-## 适用场景
-
-- 涉及多个模块或多个包的改动
-- 需要新增、升级或替换关键依赖
-- 目录边界、职责拆分或架构走向存在争议
-
-## 不适用场景
-
-- 纯样式或文案微调
-- 已经明确是低风险小修正
-- 仅需执行既定 tasks，不再涉及结构判断
-
-## 基础骨架
-
-本模板的默认骨架如下：
-
-1. `architecture-advisor`
-2. `dependency-governor`
-
-## 可选专家插入规则
-
-| 条件 | 建议插入专家 | 作用 |
-| --- | --- | --- |
-| 需求边界仍需再收敛 | `requirement-analyst` | 补需求和实现范围约束 |
-| 需要形成阻断项与放行结论 | `code-guardian` | 输出规范一致性检查 |
-
-## 主要产物
-
-至少要沉淀以下内容：
-
-- `architecture-notes`
-- `module-boundary-suggestions`
-- `dependency-audit-notes`
-- `upgrade-plan`
-
-## 完成标准
-
-当满足以下条件时，本模板可视为完成：
-
-- 结构性风险已经被识别并记录
-- 依赖引入、升级或移除的影响面已经清楚
-- 后续实现拆分、验证路径和回滚关注点已经明确
-
-## 说明
-
-这条模板关注“先把结构问题看清”，不是替代最终实现。
+---
+id: change-to-architecture-review
+version: 1
+name: 变更到架构评审
+status: active
+type: flow-template
+owner: task-orchestrator
+description: 面向跨模块改动、依赖调整和结构性演进的架构评审模板。用于在实现前或实现中期补一轮边界与影响分析。
+triggers:
+  - architecture-review
+  - module-boundary-design
+  - dependency-audit
+required_roles:
+  - architecture-advisor
+  - dependency-governor
+optional_roles:
+  - requirement-analyst
+  - code-guardian
+approval_gates: []
+artifacts:
+  - architecture-notes
+  - module-boundary-suggestions
+  - dependency-audit-notes
+  - upgrade-plan
+visibility: internal
+domains:
+  - engineering
+  - governance
+---
+
+# change-to-architecture-review
+
+## 模板定位
+
+这条模板服务于“改动已经超出单点实现，需要先看结构和影响面”的场景。
+
+它重点处理：
+
+- 模块边界是否清楚
+- 依赖引入或升级是否值得
+- 结构性改动会影响谁
+- 后续实现应如何拆分和回滚
+
+## 适用场景
+
+- 涉及多个模块或多个包的改动
+- 需要新增、升级或替换关键依赖
+- 目录边界、职责拆分或架构走向存在争议
+
+## 不适用场景
+
+- 纯样式或文案微调
+- 已经明确是低风险小修正
+- 仅需执行既定 tasks，不再涉及结构判断
+
+## 基础骨架
+
+本模板的默认骨架如下：
+
+1. `architecture-advisor`
+2. `dependency-governor`
+
+## 可选专家插入规则
+
+| 条件 | 建议插入专家 | 作用 |
+| --- | --- | --- |
+| 需求边界仍需再收敛 | `requirement-analyst` | 补需求和实现范围约束 |
+| 需要形成阻断项与放行结论 | `code-guardian` | 输出规范一致性检查 |
+
+## 主要产物
+
+至少要沉淀以下内容：
+
+- `architecture-notes`
+- `module-boundary-suggestions`
+- `dependency-audit-notes`
+- `upgrade-plan`
+
+## 完成标准
+
+当满足以下条件时，本模板可视为完成：
+
+- 结构性风险已经被识别并记录
+- 依赖引入、升级或移除的影响面已经清楚
+- 后续实现拆分、验证路径和回滚关注点已经明确
+
+## 说明
+
+这条模板关注“先把结构问题看清”，不是替代最终实现。

package/.agents/flows/common/change-to-release.md

@@ -1,94 +1,94 @@
----
-id: change-to-release
-version: 1
-name: 变更到发布
-status: active
-type: flow-template
-owner: task-orchestrator
-description: 面向构建、回归验证、流水线与部署上线准备的发布型协作模板。用于把“代码已改完”继续推进到“可上线、可回滚、可复验”。
-triggers:
-  - release-readiness
-  - ci-release
-  - deployment-change
-required_roles:
-  - build-specialist
-  - pipeline-specialist
-  - deployment-specialist
-optional_roles:
-  - e2e-test-specialist
-  - code-guardian
-approval_gates: []
-artifacts:
-  - code
-  - build-analysis
-  - pipeline-plan
-  - deployment-plan
-  - release-checklist
-visibility: internal
-domains:
-  - engineering
-  - testing
-  - delivery
----
-
-# change-to-release
-
-## 模板定位
-
-这条模板服务于“实现已经基本完成，但发布链还没收口”的场景。
-
-它不替代 `prd-to-delivery`，而是聚焦：
-
-- 构建入口是否稳定
-- 回归验证是否足够
-- 流水线是否可复用
-- 部署与回滚风险是否清楚
-
-## 适用场景
-
-- 新增或调整构建脚本、产物结构、发布流水线
-- 上线链路依赖人工步骤较多，需要收口
-- 需要把回归验证、部署配置和发布策略统一整理
-
-## 不适用场景
-
-- 纯业务需求分析
-- 只涉及页面或接口实现、尚未进入发布准备
-- 纯线上故障排查且不涉及发布链路调整
-
-## 基础骨架
-
-本模板的默认骨架如下：
-
-1. `build-specialist`
-2. `pipeline-specialist`
-3. `deployment-specialist`
-
-## 可选专家插入规则
-
-| 条件 | 建议插入专家 | 作用 |
-| --- | --- | --- |
-| 需要更强的端到端回归证据 | `e2e-test-specialist` | 补关键发布前验证路径 |
-| 需要统一阻断项和放行结论 | `code-guardian` | 输出发布前检查结论 |
-
-## 主要产物
-
-至少要沉淀以下内容：
-
-- `build-analysis`
-- `pipeline-plan`
-- `deployment-plan`
-- `release-checklist`
-
-## 完成标准
-
-当满足以下条件时，本模板可视为完成：
-
-- 构建入口、产物和校验步骤已经清楚
-- 流水线中的自动化步骤、人工步骤与失败处理路径已经收口
-- 部署差异、环境依赖和回滚关注点已经明确
-- 若启用验证专家，关键回归路径已有可执行证据
-
-## 说明
-
-这条模板关注的是“怎么稳定发布”，不是重新定义业务范围。
+---
+id: change-to-release
+version: 1
+name: 变更到发布
+status: active
+type: flow-template
+owner: task-orchestrator
+description: 面向构建、回归验证、流水线与部署上线准备的发布型协作模板。用于把“代码已改完”继续推进到“可上线、可回滚、可复验”。
+triggers:
+  - release-readiness
+  - ci-release
+  - deployment-change
+required_roles:
+  - build-specialist
+  - pipeline-specialist
+  - deployment-specialist
+optional_roles:
+  - e2e-test-specialist
+  - code-guardian
+approval_gates: []
+artifacts:
+  - code
+  - build-analysis
+  - pipeline-plan
+  - deployment-plan
+  - release-checklist
+visibility: internal
+domains:
+  - engineering
+  - testing
+  - delivery
+---
+
+# change-to-release
+
+## 模板定位
+
+这条模板服务于“实现已经基本完成，但发布链还没收口”的场景。
+
+它不替代 `prd-to-delivery`，而是聚焦：
+
+- 构建入口是否稳定
+- 回归验证是否足够
+- 流水线是否可复用
+- 部署与回滚风险是否清楚
+
+## 适用场景
+
+- 新增或调整构建脚本、产物结构、发布流水线
+- 上线链路依赖人工步骤较多，需要收口
+- 需要把回归验证、部署配置和发布策略统一整理
+
+## 不适用场景
+
+- 纯业务需求分析
+- 只涉及页面或接口实现、尚未进入发布准备
+- 纯线上故障排查且不涉及发布链路调整
+
+## 基础骨架
+
+本模板的默认骨架如下：
+
+1. `build-specialist`
+2. `pipeline-specialist`
+3. `deployment-specialist`
+
+## 可选专家插入规则
+
+| 条件 | 建议插入专家 | 作用 |
+| --- | --- | --- |
+| 需要更强的端到端回归证据 | `e2e-test-specialist` | 补关键发布前验证路径 |
+| 需要统一阻断项和放行结论 | `code-guardian` | 输出发布前检查结论 |
+
+## 主要产物
+
+至少要沉淀以下内容：
+
+- `build-analysis`
+- `pipeline-plan`
+- `deployment-plan`
+- `release-checklist`
+
+## 完成标准
+
+当满足以下条件时，本模板可视为完成：
+
+- 构建入口、产物和校验步骤已经清楚
+- 流水线中的自动化步骤、人工步骤与失败处理路径已经收口
+- 部署差异、环境依赖和回滚关注点已经明确
+- 若启用验证专家，关键回归路径已有可执行证据
+
+## 说明
+
+这条模板关注的是“怎么稳定发布”，不是重新定义业务范围。