@gong-ym/ai-spec-auto 0.2.14 → 0.2.17

package/openspec/config.yaml.template

@@ -1,52 +1,43 @@
-# 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:
+    - "先收敛目标、范围和风险，再进入实现。"
+    - "涉及页面、路由、接口、状态、样式时，必须对齐项目既有落点。"
+    - "proposal.md 写清业务与工程目标、纳入/排除范围、约束与风险。"
+  specs:
+    - "需求必须落为可测试的增量规范和场景。"
+    - "涉及 UI 时，验收场景应覆盖关键布局、状态和交互。"
+    - "涉及安装脚本、路径、运行态文件、归档或 IDE 适配时，必须明确 macOS / Linux / Windows 的行为差异与兼容边界。"
+    - "涉及产物生成、同步或删除时，必须明确目标定位依据，优先使用显式清单、注册表或固定映射，不依赖模糊模式匹配。"
+  tasks:
+    - "任务必须可执行、可验证、可交接。"
+    - "实现阶段不得静默扩 scope。"
+    - "涉及 UI 时必须明确验收方式；涉及接口时必须明确封装方式。"
+    - "保持改动最小化，聚焦于请求的变更。"
+    - "涉及安装、路径、runtime、归档或 IDE 适配时，必须包含跨平台验证任务。"
+    - "tasks.md 每个子任务写明做什么和怎么验。"
+  checklist:
+    - "检查结论必须基于 specs/tasks、项目规则和实现证据。"
+    - "checklist.md 沉淀通过项、验证结果、未通过/阻断项和建议。"
+  iterations:
+    - "iterations.md 记录问题与修正、残留风险与下轮提醒。"

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

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

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

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

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

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

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

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

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

@@ -1,24 +1,11 @@
-## 执行总原则
-
-- [ ] 任务必须限定在 proposal.md、design.md 和 specs 已批准的范围内
-- [ ] 每个子任务都要写明目标、输入、输出、验证点和依赖或前置条件
-- [ ] 任务必须可执行、可验证、可交接，不得只写模糊动作
-- [ ] 如发现范围变化，先更新 proposal.md、design.md 和 tasks.md，再继续实现
-
-## 子任务清单
-
-### 子任务 1
-
-- [ ] 目标：
-- [ ] 输入：
-- [ ] 输出：
-- [ ] 验证点：
-- [ ] 依赖或前置条件：
-
-### 子任务 2
-
-- [ ] 目标：
-- [ ] 输入：
-- [ ] 输出：
-- [ ] 验证点：
-- [ ] 依赖或前置条件：
+## 子任务
+
+### 1. 
+
+- [ ] 做什么：
+- [ ] 怎么验：
+
+### 2. 
+
+- [ ] 做什么：
+- [ ] 怎么验：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gong-ym/ai-spec-auto",
-  "version": "0.2.14",
+  "version": "0.2.17",
   "description": "AI Coding 团队规范驱动开发 CLI — 一键安装规范、技能与工具配置",
   "homepage": "https://github.com/gong-chick/engineered-spec#readme",
   "repository": {