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

package/openspec/config.yaml.template

@@ -1,52 +1,52 @@
-# OpenSpec 项目配置（由 ai-spec-auto 提供的增强版模板）
-# install.sh / install.ps1 在 L3 安装时会将此模板写入 openspec/config.yaml，
-# 并同步 openspec/schemas/expert-delivery 到目标项目。
-# 详见 https://github.com/Fission-AI/OpenSpec
-
-schema: expert-delivery
-
-context: |
-  本项目接入 ai-spec-auto 专家协同平台：
-  - rules: .agents/rules/
-  - skills: .agents/skills/
-  - roles: .agents/roles/
-  - flows: .agents/flows/
-  - runtime: .ai-spec/
-
-  项目执行时优先遵循：
-  1. 仓库现有代码中的目录、路由、接口、样式、测试约定
-  2. context/PROJECT.md 中的项目背景与仓库事实
-  3. .agents/rules/ 中的团队规范
-  4. .agents/skills/ 中的执行技能
-
-rules:
-  proposal:
-    - "先收敛目标、范围、非目标项、默认假设和风险，再进入实现。"
-    - "能从项目规则和代码推断的内容，优先写入 assumptions，不重复标记为缺失输入。"
-    - "涉及页面、路由、接口、状态、样式时，必须对齐项目既有落点。"
-    - "proposal.md 需要写清业务目标、工程目标、组件复用策略、设计链接和变更入口。"
-  specs:
-    - "需求必须落为可测试的增量规范和场景。"
-    - "涉及 UI 时，验收场景应覆盖关键布局、状态和交互。"
-    - "涉及安装脚本、路径、运行态文件、归档或 IDE 适配时，必须明确 macOS / Linux / Windows 的行为差异与兼容边界。"
-    - "涉及产物生成、同步或删除时，必须明确目标定位依据，优先使用显式清单、注册表或固定映射，不依赖模糊模式匹配。"
-  tasks:
-    - "任务必须可执行、可验证、可交接。"
-    - "实现阶段不得静默扩 scope。"
-    - "涉及 UI 时必须明确验收方式；涉及接口时必须明确封装方式。"
-    - "保持改动最小化，聚焦于请求的变更。"
-    - "涉及安装、路径、runtime、归档或 IDE 适配时，必须包含跨平台验证任务。"
-    - "tasks.md 中每个子任务都必须写明目标、输入、输出、验证点和依赖或前置条件。"
-  design:
-    - "技术方案必须对齐项目目录、路由、API、状态、样式和测试约定。"
-    - "新增能力优先复用现有结构，不因单次变更引入无关重构。"
-    - "涉及路径处理时，必须使用跨平台路径能力，不硬编码路径分隔符。"
-    - "优先复用现有 registry、常量和显式映射，不引入启发式检测、模糊匹配或正则猜测。"
-    - "design.md 需要补齐信息结构、状态管理、组件复用策略和验收路径。"
-  checklist:
-    - "必须明确通过项、未通过项、阻断项和是否建议放行。"
-    - "检查结论必须基于 proposal/tasks、项目规则和实现证据。"
-    - "checklist.md 需要沉淀本地验证、浏览器验证、范围一致性和组件复用检查摘要。"
-  iterations:
-    - "必须记录问题、修正动作、残留风险和下轮提醒。"
-    - "iterations.md 需要记录问题来源、修正动作、残留风险和下轮提醒。"
+# OpenSpec 项目配置（由 ai-spec-auto 提供的增强版模板）
+# install.sh / install.ps1 在 L3 安装时会将此模板写入 openspec/config.yaml，
+# 并同步 openspec/schemas/expert-delivery 到目标项目。
+# 详见 https://github.com/Fission-AI/OpenSpec
+
+schema: expert-delivery
+
+context: |
+  本项目接入 ai-spec-auto 专家协同平台：
+  - rules: .agents/rules/
+  - skills: .agents/skills/
+  - roles: .agents/roles/
+  - flows: .agents/flows/
+  - runtime: .ai-spec/
+
+  项目执行时优先遵循：
+  1. 仓库现有代码中的目录、路由、接口、样式、测试约定
+  2. context/PROJECT.md 中的项目背景与仓库事实
+  3. .agents/rules/ 中的团队规范
+  4. .agents/skills/ 中的执行技能
+
+rules:
+  proposal:
+    - "先收敛目标、范围、非目标项、默认假设和风险，再进入实现。"
+    - "能从项目规则和代码推断的内容，优先写入 assumptions，不重复标记为缺失输入。"
+    - "涉及页面、路由、接口、状态、样式时，必须对齐项目既有落点。"
+    - "proposal.md 需要写清业务目标、工程目标、组件复用策略、设计链接和变更入口。"
+  specs:
+    - "需求必须落为可测试的增量规范和场景。"
+    - "涉及 UI 时，验收场景应覆盖关键布局、状态和交互。"
+    - "涉及安装脚本、路径、运行态文件、归档或 IDE 适配时，必须明确 macOS / Linux / Windows 的行为差异与兼容边界。"
+    - "涉及产物生成、同步或删除时，必须明确目标定位依据，优先使用显式清单、注册表或固定映射，不依赖模糊模式匹配。"
+  tasks:
+    - "任务必须可执行、可验证、可交接。"
+    - "实现阶段不得静默扩 scope。"
+    - "涉及 UI 时必须明确验收方式；涉及接口时必须明确封装方式。"
+    - "保持改动最小化，聚焦于请求的变更。"
+    - "涉及安装、路径、runtime、归档或 IDE 适配时，必须包含跨平台验证任务。"
+    - "tasks.md 中每个子任务都必须写明目标、输入、输出、验证点和依赖或前置条件。"
+  design:
+    - "技术方案必须对齐项目目录、路由、API、状态、样式和测试约定。"
+    - "新增能力优先复用现有结构，不因单次变更引入无关重构。"
+    - "涉及路径处理时，必须使用跨平台路径能力，不硬编码路径分隔符。"
+    - "优先复用现有 registry、常量和显式映射，不引入启发式检测、模糊匹配或正则猜测。"
+    - "design.md 需要补齐信息结构、状态管理、组件复用策略和验收路径。"
+  checklist:
+    - "必须明确通过项、未通过项、阻断项和是否建议放行。"
+    - "检查结论必须基于 proposal/tasks、项目规则和实现证据。"
+    - "checklist.md 需要沉淀本地验证、浏览器验证、范围一致性和组件复用检查摘要。"
+  iterations:
+    - "必须记录问题、修正动作、残留风险和下轮提醒。"
+    - "iterations.md 需要记录问题来源、修正动作、残留风险和下轮提醒。"

package/openspec/schemas/expert-delivery/schema.yaml

@@ -1,68 +1,68 @@
-name: expert-delivery
-version: 1
-description: 基于 spec-driven 扩展的专家协同交付流程，显式包含交付检查与迭代记录产物。
-
-artifacts:
-  - id: proposal
-    generates: proposal.md
-    description: 变更提案与执行边界
-    template: proposal.md
-    instruction: |
-      创建变更提案，说明为什么要做这项变更、当前范围包含什么、不包含什么，
-      以及在进入实现前必须明确的默认假设、约束和风险。
-    requires: []
-
-  - id: specs
-    generates: specs/**/*.md
-    description: 增量需求规范与验收场景
-    template: spec.md
-    instruction: |
-      在 specs/<domain>/spec.md 下创建一个或多个增量规范文件。
-      每份规范都必须定义清晰的需求和可验证场景，并与 proposal 保持一致。
-    requires:
-      - proposal
-
-  - id: design
-    generates: design.md
-    description: 技术设计与实现方案
-    template: design.md
-    instruction: |
-      创建技术设计文档，说明当前仓库中应如何落地这项变更。
-      优先复用现有结构，避免与本次变更无关的重构。
-    requires:
-      - proposal
-
-  - id: tasks
-    generates: tasks.md
-    description: 可执行任务清单
-    template: tasks.md
-    instruction: |
-      创建可交给实现专家执行的任务清单。
-      任务必须具体、可验证，并严格限定在已批准的变更范围内。
-    requires:
-      - specs
-      - design
-
-  - id: checklist
-    generates: checklist.md
-    description: 交付检查清单
-    template: checklist.md
-    instruction: |
-      创建交付检查清单，基于实现结果、tasks、specs 和项目规则记录通过项、
-      未通过项、阻断项以及是否建议继续推进或放行。
-    requires:
-      - tasks
-
-  - id: iterations
-    generates: iterations.md
-    description: 迭代记录与残留风险
-    template: iterations.md
-    instruction: |
-      记录本轮发现的问题、已采取的修正动作、残留风险，以及下一轮或后续跟进建议。
-    requires:
-      - checklist
-
-apply:
-  requires:
-    - tasks
-  tracks: tasks.md
+name: expert-delivery
+version: 1
+description: 基于 spec-driven 扩展的专家协同交付流程，显式包含交付检查与迭代记录产物。
+
+artifacts:
+  - id: proposal
+    generates: proposal.md
+    description: 变更提案与执行边界
+    template: proposal.md
+    instruction: |
+      创建变更提案，说明为什么要做这项变更、当前范围包含什么、不包含什么，
+      以及在进入实现前必须明确的默认假设、约束和风险。
+    requires: []
+
+  - id: specs
+    generates: specs/**/*.md
+    description: 增量需求规范与验收场景
+    template: spec.md
+    instruction: |
+      在 specs/<domain>/spec.md 下创建一个或多个增量规范文件。
+      每份规范都必须定义清晰的需求和可验证场景，并与 proposal 保持一致。
+    requires:
+      - proposal
+
+  - id: design
+    generates: design.md
+    description: 技术设计与实现方案
+    template: design.md
+    instruction: |
+      创建技术设计文档，说明当前仓库中应如何落地这项变更。
+      优先复用现有结构，避免与本次变更无关的重构。
+    requires:
+      - proposal
+
+  - id: tasks
+    generates: tasks.md
+    description: 可执行任务清单
+    template: tasks.md
+    instruction: |
+      创建可交给实现专家执行的任务清单。
+      任务必须具体、可验证，并严格限定在已批准的变更范围内。
+    requires:
+      - specs
+      - design
+
+  - id: checklist
+    generates: checklist.md
+    description: 交付检查清单
+    template: checklist.md
+    instruction: |
+      创建交付检查清单，基于实现结果、tasks、specs 和项目规则记录通过项、
+      未通过项、阻断项以及是否建议继续推进或放行。
+    requires:
+      - tasks
+
+  - id: iterations
+    generates: iterations.md
+    description: 迭代记录与残留风险
+    template: iterations.md
+    instruction: |
+      记录本轮发现的问题、已采取的修正动作、残留风险，以及下一轮或后续跟进建议。
+    requires:
+      - checklist
+
+apply:
+  requires:
+    - tasks
+  tracks: tasks.md

package/openspec/schemas/expert-delivery/templates/checklist.md

@@ -1,39 +1,39 @@
-## 通过项
-
-- [ ] proposal、specs、design 与实现结果保持一致
-- [ ] 已完成任务已真实反映在代码和配套文件中
-- [ ] 项目的目录、路由、接口、样式、测试等规则已满足
-
-### 本地验证摘要
-
-- [ ] lint(静态检查)：
-- [ ] typecheck(类型检查)：
-- [ ] test(测试)：
-- [ ] build(构建)：
-
-### 浏览器验证摘要
-
-- [ ] 页面可访问：
-- [ ] 关键路径可执行：
-- [ ] console(控制台) 检查：
-
-### 范围一致性
-
-- [ ] 当前实现未超出 proposal、design、tasks 已批准范围
-
-### 组件复用检查
-
-- [ ] 已记录复用组件、组件缺口和重复实现风险
-
-## 未通过项
-
-- [ ] 记录未满足需求或项目规则的项
-
-## 阻断项
-
-- [ ] 记录在继续交付、放行或归档前必须解决的项
-
-## 是否建议继续推进
-
-<!-- 说明当前变更是可以继续推进、带风险推进，还是必须阻断。 -->
-<!-- 建议同步给出完成内容、验证摘要和是否适合继续交接或归档。 -->
+## 通过项
+
+- [ ] proposal、specs、design 与实现结果保持一致
+- [ ] 已完成任务已真实反映在代码和配套文件中
+- [ ] 项目的目录、路由、接口、样式、测试等规则已满足
+
+### 本地验证摘要
+
+- [ ] lint(静态检查)：
+- [ ] typecheck(类型检查)：
+- [ ] test(测试)：
+- [ ] build(构建)：
+
+### 浏览器验证摘要
+
+- [ ] 页面可访问：
+- [ ] 关键路径可执行：
+- [ ] console(控制台) 检查：
+
+### 范围一致性
+
+- [ ] 当前实现未超出 proposal、design、tasks 已批准范围
+
+### 组件复用检查
+
+- [ ] 已记录复用组件、组件缺口和重复实现风险
+
+## 未通过项
+
+- [ ] 记录未满足需求或项目规则的项
+
+## 阻断项
+
+- [ ] 记录在继续交付、放行或归档前必须解决的项
+
+## 是否建议继续推进
+
+<!-- 说明当前变更是可以继续推进、带风险推进，还是必须阻断。 -->
+<!-- 建议同步给出完成内容、验证摘要和是否适合继续交接或归档。 -->

package/openspec/schemas/expert-delivery/templates/design.md

@@ -1,61 +1,61 @@
-## 方案概览
-
-<!-- 结合当前仓库上下文，概述本次实现方案。 -->
-
-## 仓库对齐
-
-### 页面与路由落点
-
-<!-- 说明页面文件、路由模块、导航入口和懒加载边界。 -->
-
-### 接口与数据落点
-
-<!-- 说明 API(接口) 封装、数据来源、mock(模拟数据) 或响应契约落点。 -->
-
-### 状态与样式落点
-
-<!-- 说明状态层、缓存策略、主题变量和样式入口。 -->
-
-### 测试与组件库落点
-
-<!-- 说明测试文件、验证脚本、组件目录和组件库约束的对应位置。 -->
-
-## 关键决策
-
-### 信息结构
-
-<!-- 说明页面结构、模块边界或信息分层，以及为什么这样拆分。 -->
-
-### 状态管理方案
-
-<!-- 说明查询状态、列表状态、表单状态或跨模块状态如何组织。 -->
-
-### 组件复用策略
-
-<!-- 说明优先复用的组件、页面实际组合方式和复用理由。 -->
-
-### 禁止重复实现的能力
-
-<!-- 说明哪些已有能力必须复用，避免在本次变更中重复实现。 -->
-
-### 组件缺口
-
-<!-- 如现有组件或基础能力无法满足需求，在这里记录缺口和临时处理方式。 -->
-
-## 数据与接口变更
-
-<!-- 说明请求/响应、状态更新、props、事件或契约变化。 -->
-
-## 验证说明
-
-### 本地验证
-
-<!-- 说明 lint(静态检查)、typecheck(类型检查)、test(测试)、build(构建) 或其他本地验证策略。 -->
-
-### 浏览器验证
-
-<!-- 说明页面可访问性、关键交互路径、console(控制台) 检查或 UI(界面) 验收方式。 -->
-
-### 关键验收路径
-
-<!-- 说明最关键的端到端路径、失败信号和交付前必须看到的验证证据。 -->
+## 方案概览
+
+<!-- 结合当前仓库上下文，概述本次实现方案。 -->
+
+## 仓库对齐
+
+### 页面与路由落点
+
+<!-- 说明页面文件、路由模块、导航入口和懒加载边界。 -->
+
+### 接口与数据落点
+
+<!-- 说明 API(接口) 封装、数据来源、mock(模拟数据) 或响应契约落点。 -->
+
+### 状态与样式落点
+
+<!-- 说明状态层、缓存策略、主题变量和样式入口。 -->
+
+### 测试与组件库落点
+
+<!-- 说明测试文件、验证脚本、组件目录和组件库约束的对应位置。 -->
+
+## 关键决策
+
+### 信息结构
+
+<!-- 说明页面结构、模块边界或信息分层，以及为什么这样拆分。 -->
+
+### 状态管理方案
+
+<!-- 说明查询状态、列表状态、表单状态或跨模块状态如何组织。 -->
+
+### 组件复用策略
+
+<!-- 说明优先复用的组件、页面实际组合方式和复用理由。 -->
+
+### 禁止重复实现的能力
+
+<!-- 说明哪些已有能力必须复用，避免在本次变更中重复实现。 -->
+
+### 组件缺口
+
+<!-- 如现有组件或基础能力无法满足需求，在这里记录缺口和临时处理方式。 -->
+
+## 数据与接口变更
+
+<!-- 说明请求/响应、状态更新、props、事件或契约变化。 -->
+
+## 验证说明
+
+### 本地验证
+
+<!-- 说明 lint(静态检查)、typecheck(类型检查)、test(测试)、build(构建) 或其他本地验证策略。 -->
+
+### 浏览器验证
+
+<!-- 说明页面可访问性、关键交互路径、console(控制台) 检查或 UI(界面) 验收方式。 -->
+
+### 关键验收路径
+
+<!-- 说明最关键的端到端路径、失败信号和交付前必须看到的验证证据。 -->

package/openspec/schemas/expert-delivery/templates/iterations.md

@@ -1,25 +1,25 @@
-## 本轮问题
-
-- [ ] 记录本轮识别出的关键问题
-- 问题来源：
-- 影响范围：
-- 关联证据：
-
-## 修正动作
-
-- [ ] 记录已采取的修复或后续处理动作
-- 已完成动作：
-- 待跟进动作：
-
-## 残留风险
-
-- [ ] 记录仍然存在的风险、警告或延后项
-- 风险说明：
-- 触发条件：
-- 建议缓解方式：
-
-## 下轮提醒
-
-- [ ] 记录下一轮协作或后续变更的提醒
-- 下一轮关注点：
-- 交接说明：
+## 本轮问题
+
+- [ ] 记录本轮识别出的关键问题
+- 问题来源：
+- 影响范围：
+- 关联证据：
+
+## 修正动作
+
+- [ ] 记录已采取的修复或后续处理动作
+- 已完成动作：
+- 待跟进动作：
+
+## 残留风险
+
+- [ ] 记录仍然存在的风险、警告或延后项
+- 风险说明：
+- 触发条件：
+- 建议缓解方式：
+
+## 下轮提醒
+
+- [ ] 记录下一轮协作或后续变更的提醒
+- 下一轮关注点：
+- 交接说明：

package/openspec/schemas/expert-delivery/templates/proposal.md

@@ -1,45 +1,45 @@
-## 目标
-
-### 业务目标
-
-<!-- 说明这项变更要解决的业务问题、目标用户或交付价值。 -->
-
-### 工程目标
-
-<!-- 说明本次变更对目录、接口、状态、样式、测试或交付流程的工程目标。 -->
-
-### 变更对象与入口
-
-<!-- 记录页面、模块、路由、接口、状态、样式、脚本或命令入口。 -->
-
-### 设计链接
-
-<!-- 记录 Figma(设计稿)、PRD(需求文档)、原型、议题或其他背景材料。 -->
-
-### 组件复用约束（可选）
-
-<!-- 记录优先复用的组件、禁止重复实现的能力，以及当前识别出的组件库缺口。 -->
-
-## 范围
-
-### In Scope(纳入范围)
-
-<!-- 列出本次明确包含的内容，尽量写成可验证的交付项。 -->
-
-### Out of Scope(排除范围)
-
-<!-- 列出当前不做的内容，避免实现阶段静默扩范围。 -->
-
-## 非目标
-
-<!-- 列出本次明确不追求的目标、暂不处理的方向或不承诺的结果。 -->
-
-## 默认假设
-
-<!-- 记录根据仓库、项目规则或现有代码推断出的默认假设。 -->
-<!-- 建议覆盖：仓库事实、组件库缺口、验证边界、外部依赖和上下游配合方式。 -->
-
-## 风险与待确认项
-
-<!-- 在进入实现前明确尚未解决的权衡、约束与高风险项。 -->
-<!-- 建议覆盖：关键依赖、组件库限制、验证证据、上线或归档前置条件。 -->
+## 目标
+
+### 业务目标
+
+<!-- 说明这项变更要解决的业务问题、目标用户或交付价值。 -->
+
+### 工程目标
+
+<!-- 说明本次变更对目录、接口、状态、样式、测试或交付流程的工程目标。 -->
+
+### 变更对象与入口
+
+<!-- 记录页面、模块、路由、接口、状态、样式、脚本或命令入口。 -->
+
+### 设计链接
+
+<!-- 记录 Figma(设计稿)、PRD(需求文档)、原型、议题或其他背景材料。 -->
+
+### 组件复用约束（可选）
+
+<!-- 记录优先复用的组件、禁止重复实现的能力，以及当前识别出的组件库缺口。 -->
+
+## 范围
+
+### In Scope(纳入范围)
+
+<!-- 列出本次明确包含的内容，尽量写成可验证的交付项。 -->
+
+### Out of Scope(排除范围)
+
+<!-- 列出当前不做的内容，避免实现阶段静默扩范围。 -->
+
+## 非目标
+
+<!-- 列出本次明确不追求的目标、暂不处理的方向或不承诺的结果。 -->
+
+## 默认假设
+
+<!-- 记录根据仓库、项目规则或现有代码推断出的默认假设。 -->
+<!-- 建议覆盖：仓库事实、组件库缺口、验证边界、外部依赖和上下游配合方式。 -->
+
+## 风险与待确认项
+
+<!-- 在进入实现前明确尚未解决的权衡、约束与高风险项。 -->
+<!-- 建议覆盖：关键依赖、组件库限制、验证证据、上线或归档前置条件。 -->

package/openspec/schemas/expert-delivery/templates/spec.md

@@ -1,29 +1,29 @@
-## 新增需求
-
-### 需求：[名称]
-
-系统必须……
-
-#### 场景：[场景名称]
-
-- **已知** ……
-- **当** ……
-- **则** ……
-
-## 更新需求
-
-### 需求：[名称]
-
-系统必须……
-
-#### 场景：[场景名称]
-
-- **已知** ……
-- **当** ……
-- **则** ……
-
-## 删除需求
-
-### 需求：[名称]
-
-<!-- 说明为什么删除或替换这条需求。 -->
+## 新增需求
+
+### 需求：[名称]
+
+系统必须……
+
+#### 场景：[场景名称]
+
+- **已知** ……
+- **当** ……
+- **则** ……
+
+## 更新需求
+
+### 需求：[名称]
+
+系统必须……
+
+#### 场景：[场景名称]
+
+- **已知** ……
+- **当** ……
+- **则** ……
+
+## 删除需求
+
+### 需求：[名称]
+
+<!-- 说明为什么删除或替换这条需求。 -->