@localsummer/incspec 0.1.0 → 0.1.1

package/commands/init.mjs

@@ -121,7 +121,7 @@ export async function initCommand(ctx) {
   print('');
   print(colorize('下一步:', colors.bold));
   print(colorize(`  1. 运行 'incspec status' 查看工作流状态`, colors.dim));
-  print(colorize(`  2. 运行 'incspec cursor-sync' 同步 Cursor 命令`, colors.dim));
+  print(colorize(`  2. 运行 'incspec sync' 同步 Cursor 命令`, colors.dim));
   print(colorize(`  3. 使用 /incspec/inc-analyze 开始第一个工作流`, colors.dim));
   print('');
 }

package/commands/sync.mjs

@@ -114,12 +114,12 @@ async function syncCursor(ctx) {
       {
         name: `当前目录 (${cwd}/.cursor/commands/incspec/)`,
         value: 'project',
-        description: '仅对当前目录生效',
+        description: colorize('仅对当前目录生效', colors.blue),
       },
       {
         name: '全局目录 (~/.cursor/commands/incspec/)',
         value: 'global',
-        description: '对所有项目生效',
+        description: colorize('对所有项目生效', colors.blue),
       },
     ];
 
@@ -182,12 +182,12 @@ async function syncClaude(ctx) {
       {
         name: `当前目录 (${cwd}/.claude/skills/inc-spec-skill/)`,
         value: 'project',
-        description: '仅对当前目录生效',
+        description: colorize('仅对当前目录生效', colors.blue),
       },
       {
         name: '全局目录 (~/.claude/skills/inc-spec-skill/)',
         value: 'global',
-        description: '对所有项目生效（推荐）',
+        description: colorize('对所有项目生效（推荐）', colors.blue),
       },
     ];
 

package/lib/cursor.mjs

@@ -19,8 +19,8 @@ const GLOBAL_CURSOR_DIR = path.join(os.homedir(), '.cursor', 'commands', 'incspe
 /** Claude commands source directory (user local) */
 const CLAUDE_COMMANDS_DIR = path.join(os.homedir(), '.claude', 'commands', 'ai-increment');
 
-/** Built-in templates directory (fallback when Claude commands not installed) */
-const TEMPLATES_DIR = fileURLToPath(new URL('../templates/cursor-commands', import.meta.url));
+/** Built-in templates directory */
+const TEMPLATES_DIR = fileURLToPath(new URL('../templates/commands', import.meta.url));
 
 /**
  * Command mapping from Claude to Cursor

package/package.json

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

package/templates/AGENTS.md

@@ -141,7 +141,8 @@ incspec archive [--yes] [--keep]    # 步骤7
 # 验证与同步
 incspec validate / v [--strict]     # 验证完整性
 incspec sync [--cursor|--claude|--all] [--global|--project]  # IDE集成
-incspec reset [--to=<step>]         # 重置工作流（可选回退到指定步骤 1-6）
+incspec reset                       # 完全重置工作流（归档所有产出）
+incspec reset --to=<step>           # 部分回退到指定步骤（保留1-N，重置N+1至7）
 ```
 
 ## 文件格式示例
@@ -210,6 +211,10 @@ baseline: home-baseline-v1
 | No baseline found | 先完成步骤 1 (analyze) |
 | Previous step not completed | 运行 `incspec status` 检查进度 |
 | Validation failed | 检查文件格式和编号序列 |
-| 工作流卡住 | 运行 `incspec reset` 重置状态 |
+| 工作流卡住或状态异常 | `incspec reset` 完全重置，或 `incspec reset --to=N` 回退到步骤N |
+
+**工作流重置**:
+- 完全重置: `incspec reset` - 归档所有产出，回到初始状态
+- 部分回退: `incspec reset --to=N` - 保留步骤1-N，重置N+1至7（示例：`--to=3` 保留1-3，重置4-7）
 
 记住: **基线是真相，增量是提案**。通过工作流周期保持它们同步。

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

@@ -101,7 +101,8 @@ description: 设计优先的前端功能增量编码工作流。适用于实现
 - `incspec status` - 查看工作流状态
 - `incspec list` - 列出规范文件
 - `incspec validate` - 验证项目健康状态
-- `incspec reset [--to=<step>]` - 重置工作流（可选回退到指定步骤 1-6）
+- `incspec reset` - 重置工作流到初始状态
+- `incspec reset --to=N` - 回退到步骤N，保留1-N，重置N+1至7（示例：`--to=3` 保留1-3，重置4-7）
 
 ## 步骤详情
 
@@ -224,6 +225,10 @@ incspec archive <file> --keep      # 复制而非移动
 - 步骤5后: 验证所有文件已正确创建/修改
 - 步骤7后: 确认工作区已清理
 
+**工作流重置:**
+- 完全重置: `incspec reset` - 归档所有产出，回到初始状态
+- 部分回退: `incspec reset --to=N` - 保留步骤1-N，重置步骤N+1至7。示例：步骤5发现设计有误 → `--to=3` → 重做步骤4-7
+
 **人工确认点:**
 
 | 步骤 | 确认级别 | 快速模式 | 说明 |
@@ -241,14 +246,15 @@ incspec archive <file> --keep      # 复制而非移动
 
 ## 常见陷阱
 
-| 陷阱 | 后果 |
-|------|------|
-| 跳过代码流程分析 | 集成问题，返工 |
-| 接受模糊需求 | 编码时发现歧义 |
-| 遗漏依赖 | 导入错误，运行时失败 |
-| 编码先于设计 | 在不符合架构的实现上浪费精力 |
-| 跳过基线合并 | 对当前系统状态产生混淆 |
-| 忽略归档 | 工作区杂乱，历史丢失 |
+| 陷阱 | 后果 | 解决方案 |
+|------|------|----------|
+| 跳过代码流程分析 | 集成问题，返工 | 始终从步骤1开始，建立准确基线 |
+| 接受模糊需求 | 编码时发现歧义 | 步骤2必须确认，消除所有模糊术语 |
+| 遗漏依赖 | 导入错误，运行时失败 | 完整模式严格执行步骤3 |
+| 编码先于设计 | 在不符合架构的实现上浪费精力 | 完整模式严格执行步骤4，步骤4设计获批后才执行步骤5 |
+| 跳过基线合并 | 对当前系统状态产生混淆 | 每次增量后必须执行步骤6 |
+| 忽略归档 | 工作区杂乱，历史丢失 | 工作流完成后立即执行步骤7 |
+| 工作流状态不一致 | CLI命令执行失败 | 使用 `incspec status` 检查状态，必要时使用 `incspec reset` 修复 |
 
 ## 参考资源