ai-engineering-init 1.2.4 → 1.2.6

package/.cursor/hooks/stop.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Stop Hook - Cursor 回答结束时触发
+ * 功能: nul 文件清理 + 完成音效
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// 清理可能误创建的 nul 文件（Windows 下 > nul 可能创建该文件）
+const findAndDeleteNul = (dir, depth = 0) => {
+  if (depth > 5) return;
+  try {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = path.join(dir, entry.name);
+      if (entry.isFile() && entry.name === 'nul') {
+        fs.unlinkSync(fullPath);
+        console.error(`🧹 已清理: ${fullPath}`);
+      } else if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+        findAndDeleteNul(fullPath, depth + 1);
+      }
+    }
+  } catch {
+    // 访问失败时静默忽略
+  }
+};
+findAndDeleteNul(process.cwd());
+
+// 播放完成音效（可选）
+// 优先使用 .cursor/audio/，若不存在则尝试 .claude/audio/（兼容两者都安装的情况）
+const cursorAudio = path.join(process.cwd(), '.cursor', 'audio', 'completed.wav');
+const claudeAudio = path.join(process.cwd(), '.claude', 'audio', 'completed.wav');
+const audioFile = fs.existsSync(cursorAudio) ? cursorAudio : (fs.existsSync(claudeAudio) ? claudeAudio : null);
+
+try {
+  if (audioFile) {
+    const platform = process.platform;
+    if (platform === 'darwin') {
+      execSync(`afplay "${audioFile}"`, { stdio: ['pipe', 'pipe', 'pipe'] });
+    } else if (platform === 'win32') {
+      execSync(`powershell -c "(New-Object Media.SoundPlayer '${audioFile.replace(/'/g, "''")}').PlaySync()"`, {
+        stdio: ['pipe', 'pipe', 'pipe']
+      });
+    } else if (platform === 'linux') {
+      try {
+        execSync(`aplay "${audioFile}"`, { stdio: ['pipe', 'pipe', 'pipe'] });
+      } catch {
+        try {
+          execSync(`paplay "${audioFile}"`, { stdio: ['pipe', 'pipe', 'pipe'] });
+        } catch {
+          // 播放失败，静默忽略
+        }
+      }
+    }
+  }
+} catch {
+  // 播放失败时静默忽略
+}
+
+process.exit(0);

package/.cursor/hooks.json

@@ -1,38 +1,22 @@
 {
+  "version": 1,
   "hooks": {
     "beforeSubmitPrompt": [
       {
         "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .cursor/hooks/cursor-skill-eval.js"
-          }
-        ]
+        "command": "node .cursor/hooks/cursor-skill-eval.js"
       }
     ],
     "preToolUse": [
       {
         "matcher": "Shell|Write|CreateFile|EditFile",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .cursor/hooks/cursor-pre-tool-use.js",
-            "timeout": 5000
-          }
-        ]
+        "command": "node .cursor/hooks/cursor-pre-tool-use.js"
       }
     ],
     "stop": [
       {
         "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node .claude/hooks/stop.js",
-            "timeout": 10000
-          }
-        ]
+        "command": "node .cursor/hooks/stop.js"
       }
     ]
   }

package/README.md

@@ -193,6 +193,25 @@ cd ai-engineering-init
 3. Subagents 会根据任务自动委托：`/code-reviewer`、`/project-manager`
 4. 在 Settings → MCP 中确认 MCP 服务器已连接
 
+#### OpenSpec 规格驱动开发（opsx 命令）
+
+基于 [OpenSpec](https://github.com/Fission-AI/OpenSpec) 的规格驱动开发工作流，在 Cursor Chat 中通过 `/opsx-*` 命令使用：
+
+| 命令 | 用途 |
+|------|------|
+| `/opsx-new` | 新建变更，描述需求并创建规格文档 |
+| `/opsx-ff` | 快速推进，一次性生成所有制品（规格+任务） |
+| `/opsx-apply` | 开始实现，按任务清单编码 |
+| `/opsx-continue` | 继续变更，创建下一个制品 |
+| `/opsx-verify` | 验证实现是否与规格匹配 |
+| `/opsx-sync` | 将 delta 规格同步到主规格 |
+| `/opsx-archive` | 归档已完成的变更 |
+| `/opsx-bulk-archive` | 批量归档多个变更 |
+| `/opsx-explore` | 探索模式，思维伙伴式问题分析 |
+| `/opsx-onboard` | 新手引导，完整工作流演示 |
+
+**标准开发流程**：`/opsx-new` → `/opsx-ff` → `/opsx-apply` → `/opsx-verify` → `/opsx-archive`
+
 ### OpenAI Codex
 
 1. 修改 `AGENTS.md` 中的项目说明
@@ -200,11 +219,29 @@ cd ai-engineering-init
 3. （可选）以 MCP Server 接入 Claude Code：`.claude/settings.json` → `mcpServers.codex`，重启后 Claude 可直接调用 `codex` / `codex-reply` 工具
    - **Windows 用户**：将 `command` 路径改为 `where codex` 查询到的实际路径（如 `C:\Users\YourName\AppData\Roaming\npm\codex.cmd`）
 
+## 更新已安装的项目
+
+当有新版本发布时，在已安装的项目根目录执行：
+
+```bash
+# 必须加 @latest，确保使用最新源文件
+npx ai-engineering-init@latest update
+
+# 只更新指定工具
+npx ai-engineering-init@latest update --tool cursor
+npx ai-engineering-init@latest update --tool claude
+
+# 强制更新，包括 settings.json / CLAUDE.md 等保留文件
+npx ai-engineering-init@latest update --force
+```
+
+> **注意**：不加 `@latest` 会使用 npx 本地缓存的旧版本，源文件不是最新的。
+
 ## 更新日志
 
 查看完整更新历史：[CHANGELOG.md](./CHANGELOG.md)
 
-**v1.2.4 优化**：优化 leniu 技能系统触发词精准度；合并冗余技能；新增定制报表技能。
+**v1.2.6 修复**：Cursor stop hook 自包含，不再依赖 Claude Code 安装；修复完成音效无法触发的问题。
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-engineering-init",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "description": "AI 工程化配置初始化工具 — 一键为 Claude Code、OpenAI Codex 等 AI 工具初始化 Skills 和项目规范",
   "keywords": [
     "claude-code",