@localsummer/incspec 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localsummer/incspec",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "面向 AI 编程助手的增量规范驱动开发工具",
   "bin": {
     "incspec": "index.mjs"

package/templates/AGENTS.md

@@ -10,8 +10,14 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 
 **快速模式 (5步)**:
 - 启动: `incspec analyze <path> --quick`
-- 按顺序执行: analyze → collect-req → apply → merge → archive
-- 跳过步骤 3 (UI依赖采集) 和步骤 4 (增量设计)
+- 按顺序执行: 
+  - 步骤1: analyze (代码分析)
+  - 步骤2: collect-req (需求收集)
+  - [跳过步骤3: UI依赖采集]
+  - [跳过步骤4: 增量设计]
+  - 步骤5: apply (应用代码)
+  - 步骤6: merge (合并基线)
+  - 步骤7: archive (归档)
 - 适用于: Bug 修复、简单功能、不涉及复杂 UI 依赖的变更
 
 **核心约定**:
@@ -25,7 +31,7 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 
 ```
 完整模式:  [1分析] → [2需求] → [3UI依赖] → [4设计] → [5应用] → [6合并] → [7归档] → 循环
-快速模式:  [1分析] → [2需求] ─────────────────────→ [5应用] → [6合并] → [7归档] → 循环
+快速模式:  [1分析] → [2需求] ─(跳过3,4)─→ [5应用] → [6合并] → [7归档] → 循环
 ```
 
 ### 步骤 1: 分析代码工作流
@@ -105,7 +111,7 @@ AI 编码助手使用 IncSpec 进行增量规格驱动开发的操作指南。
 
 **目的**: 将已完成的工作流产出归档到 `incspec/archives/YYYY-MM/{module}/`
 
-**验证**: 归档前执行 `incspec validate` 确保项目健康，归档后再次验证确保文件移动正确
+**验证**: 归档前执行 `incspec validate` 确保项目健康。归档操作本身会验证文件移动正确性。
 
 ## 目录结构
 

package/templates/inc-spec-skill/SKILL.md

@@ -31,20 +31,27 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 ```
 1. 分析现有代码    → incspec analyze <path> --quick
 2. 收集需求        → incspec collect-req
-3. 应用代码变更    → incspec apply (基于需求文档)
-4. 合并到基线      → incspec merge (重新分析生成)
-5. 归档工作流      → incspec archive --yes
+   [跳过 3: 依赖收集 - 简单变更无需此步]
+   [跳过 4: 增量设计 - 直接基于需求实现]
+5. 应用代码变更    → incspec apply (基于需求文档)
+6. 合并到基线      → incspec merge (重新分析生成)
+7. 归档工作流      → incspec archive --yes
 ```
 
 首次使用前初始化: `incspec init`
 
 ## 执行规则
 
-当用户请求满足以下条件时，**直接开始执行**，无需搜索确认:
+当用户请求满足以下条件时，**立即启动工作流**，无需额外搜索或确认启动意图:
 - 明确指定了模式（完整/快速）
 - 提供了目标路径或基线文件
 - 意图清晰无歧义
 
+**重要说明**:
+- "立即启动工作流"指无需确认是否开始执行，但**不跳过**工作流中定义的人工确认点
+- 步骤2(需求收集)和步骤4(增量设计)仍然**必须**等待用户确认后才能继续
+- 步骤7(归档)建议向用户确认归档范围
+
 **默认行为**:
 - 未指定模式时，默认使用完整模式
 - 提供 `--baseline=<file>` 时，跳过步骤1的代码分析，直接使用已有基线
@@ -87,15 +94,15 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 
 每个步骤与 `incspec` CLI同步以跟踪工作流状态:
 
-| 步骤 | 开始 | 完成 |
-|------|------|------|
-| 分析 | `incspec analyze <path> --module=<m>` 或 `--baseline=<file>` | `--complete --output=<file>` |
-| 需求 | `incspec collect-req` | `--complete` |
-| 依赖 | `incspec collect-dep` | `--complete` |
-| 设计 | `incspec design --feature=<f>` | `--complete --output=<file>` |
-| 应用 | `incspec apply <report>` | `--complete` |
-| 合并 | `incspec merge <report>` | `--complete --output=<file>` |
-| 归档 | `incspec archive --yes` | - |
+| 步骤 | 模式 | 开始 | 完成 |
+|------|------|------|------|
+| 分析 | 完整/快速 | `incspec analyze <path> --module=<m>` 或 `--baseline=<file>` | `--complete --output=<file>` |
+| 需求 | 完整/快速 | `incspec collect-req` | `--complete` |
+| 依赖 | 仅完整 | `incspec collect-dep` | `--complete` |
+| 设计 | 仅完整 | `incspec design --feature=<f>` | `--complete --output=<file>` |
+| 应用 | 完整/快速 | `incspec apply <report>` | `--complete` |
+| 合并 | 完整/快速 | `incspec merge <report>` | `--complete --output=<file>` |
+| 归档 | 完整/快速 | `incspec archive --yes` | - |
 
 管理命令:
 - `incspec status` - 查看工作流状态
@@ -281,7 +288,7 @@ incspec archive <file> --keep      # 复制而非移动
 
 ## 使用示例
 
-**任务:** 为产品仪表板添加筛选功能
+**完整任务模式:** 为产品仪表板添加筛选功能
 
 ```
 步骤1: 分析产品仪表板代码流程