airail 0.1.3 → 0.1.4

package/dist/cli/index.js

@@ -42,6 +42,7 @@ const update_1 = require("./update");
 const status_1 = require("./status");
 const config_1 = require("./config");
 const install_1 = require("./install");
+const version_1 = require("./version");
 function printBanner() {
     console.log([
         '',
@@ -65,6 +66,7 @@ function printHelp() {
         ['update', '更新已安装的规范包'],
         ['config [子命令]', '管理团队配置仓库 (setup / list / use)'],
         ['status', '查看已安装的技能'],
+        ['ver', '查看 airail 版本'],
         ['exit', '退出交互模式'],
     ];
     const dispWidth = (s) => [...s].reduce((n, c) => n + (c.charCodeAt(0) > 0x7f ? 2 : 1), 0);
@@ -81,6 +83,7 @@ async function executeCommand(cmd, args) {
         update: update_1.cmdUpdate,
         status: status_1.cmdStatus,
         config: () => (0, config_1.cmdConfig)(args[0], ...args.slice(1)),
+        ver: version_1.cmdVersion,
     };
     if (cmd === 'exit') {
         return { shouldContinue: false, success: true };

package/dist/cli/version.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmdVersion = cmdVersion;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+async function cmdVersion() {
+    const packageJsonPath = path.join(__dirname, '../../package.json');
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    console.log(`airail v${packageJson.version}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airail",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "AI coding assistant framework - enforce coding standards via Claude hooks & skills",
   "bin": {
     "airail": "./bin/airail.js"

package/src/templates/agents/code-reviewer.md

@@ -1,6 +1,8 @@
 ---
 name: code-reviewer
-description: 代码审查专家，在提交代码前进行全面的规范检查和质量评估。当用户完成功能开发、需要代码审查时调用。
+description: 自动代码审查助手，在完成功能开发后自动检查代码是否符合项目规范。当使用 /dev 命令完成代码生成后，或用户说"审查代码"、"检查代码"时自动调用。
+model: opus
+tools: Read, Grep, Glob
 ---
 
 # 代码审查专家
@@ -9,13 +11,26 @@ description: 代码审查专家，在提交代码前进行全面的规范检查
 
 你是一位严格的代码审查专家，熟悉本项目的所有规范。你的职责是在代码合并前发现问题，而不是帮助实现功能。
 
+## 核心职责
+
+在以下场景自动执行代码审查：
+
+1. **`/dev` 命令完成后** - 审查新生成的完整业务模块
+2. **用户手动触发** - 说"审查代码"、"检查代码"、"review"
+
+## 审查原则
+
+1. **严格但不死板** - 遵循规范，但理解特殊情况
+2. **提供修复建议** - 不只指出问题，还要给解决方案
+3. **优先级明确** - 区分必须修复和建议修复
+4. **快速反馈** - 审查报告简洁明了
+
 ## 审查流程
 
-1. 读取 `.claude/docs/后端开发指南.md` 和 `.claude/docs/数据库设计规范.md`
-2. 逐文件检查，按严重程度分类问题
-3. 输出结构化审查报告
+1. 根据审查清单逐文件检查，按严重程度分类问题
+2. 输出结构化审查报告
 
-## 审查维度
+## 审查清单
 
 ### 必须修复（阻塞合并）
 

package/src/templates/commands/dev-frontend.md

@@ -0,0 +1,38 @@
+# /dev-frontend - 开发前端新功能
+
+
+
+## 执行流程
+
+1. **需求确认**：理解要开发的功能，列出关键点和交互流程
+2. **重复检查**：扫描现有组件和页面，确认功能不重复
+3. **接口文档检查**（强制）：用户必须提供后端接口文档，包含：
+   - 接口地址和请求方法
+   - 请求参数结构
+   - 响应数据结构
+   - 错误码说明
+   - 支持格式：Swagger/OpenAPI、Apifox、手写文档、接口截图
+4. **方案设计**：列出要创建/修改的文件清单（组件、页面、路由、状态），等待确认
+5. **代码生成**：逐层实现（技能会根据开发内容自动激活）
+6. **完成报告**：列出所有变更文件，提示测试和联调事项
+
+## AI 执行规则
+
+- **强制要求**：没有后端接口文档，不得开始开发。必须先向用户索要接口文档
+- 开始写代码前必须先列出方案，等待用户确认
+- 相关技能会根据开发内容自动激活：
+  - 前端开发 → frontend-development 技能
+  - API 对接 → api-integration 技能
+  - 组件设计 → component-design 技能
+- 优先复用项目中已有的组件、工具函数和样式
+- 遵循项目的状态管理方案（Vuex/Pinia/Redux 等）
+- 禁止修改框架核心代码和公共组件库
+
+## 技能自动激活说明
+
+开发过程中，AI 会根据触发词自动激活相关技能：
+- 提到"组件"、"页面"、"Vue"、"React" → 激活 frontend-development
+- 提到"API"、"接口"、"请求" → 激活 api-integration
+- 提到"样式"、"布局"、"响应式" → 激活 ui-design
+
+无需手动调用技能，AI 会自动应用项目规范。

package/src/templates/commands/dev.md

@@ -1,6 +1,6 @@
 # /dev - 开发新功能
 
-> 使用方式：在 Claude Code 中输入 `/dev`
+
 
 ## 执行流程
 

package/src/templates/hooks/skill-eval.cjs

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * Hook: UserPromptSubmit
+ * 强制技能激活 - 将激活率从 ~25% 提升到 90%+
+ * 来源：ruoyi-vue-plus skill-forced-eval.js 方案
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// 从 stdin 读取用户输入
+let inputData = '';
+try {
+  inputData = fs.readFileSync(0, 'utf8');
+} catch {
+  process.exit(0);
+}
+
+let input;
+try {
+  input = JSON.parse(inputData);
+} catch {
+  process.exit(0);
+}
+
+const prompt = (input.prompt || '').trim();
+
+// 跳过斜杠命令
+if (/^\/[^\s]/.test(prompt)) process.exit(0);
+
+// 检测是否是恢复会话（防止上下文溢出死循环）
+const skipPatterns = [
+  'continued from a previous conversation',
+  'ran out of context',
+  'No code restore',
+  'Conversation compacted',
+  'commands restored',
+  'context window',
+  'session is being continued',
+  '继续',
+  '恢复',
+  '上次'
+];
+
+const isRecoverySession = skipPatterns.some(pattern =>
+  prompt.toLowerCase().includes(pattern.toLowerCase())
+);
+
+if (isRecoverySession) {
+  process.exit(0);
+}
+
+// 读取已安装技能列表
+const claudeDir = path.join(process.cwd(), '.claude');
+let skills = [];
+try {
+  const skillsDir = path.join(claudeDir, 'skills');
+  for (const skill of fs.readdirSync(skillsDir)) {
+    const skillFile = path.join(skillsDir, skill, 'SKILL.md');
+    if (fs.existsSync(skillFile)) skills.push(skill);
+  }
+} catch {}
+
+if (skills.length === 0) process.exit(0);
+
+// 输出强制激活指令
+const instructions = `## 强制技能激活流程（必须执行）
+
+### 步骤 1 - 评估（必须在响应中明确展示）
+
+针对用户问题，列出匹配的技能：\`技能名: 理由\`，无匹配则写"无匹配技能"
+
+可用技能 (${skills.length} 个)：${skills.join(', ')}
+
+### 步骤 2 - 激活（逐个调用，等待每个完成）
+
+⚠️ **必须逐个调用 Skill() 工具，每次调用后等待返回再调用下一个**
+- 有 N 个匹配技能 → 逐个发起 N 次 Skill() 调用（不要并行！）
+- 无匹配技能 → 跳过此步骤
+
+**调用顺序**：按列出顺序，先调用第一个，等返回后再调用第二个...
+
+### 步骤 3 - 实现
+
+只有在步骤 2 的所有 Skill() 调用完成后，才能开始实现。
+
+---
+
+**关键规则（违反将导致任务失败）**：
+1. ⛔ 禁止：评估后跳过 Skill() 直接实现
+2. ⛔ 禁止：只调用部分技能（必须全部调用）
+3. ⛔ 禁止：并行调用多个 Skill()（必须串行，一个一个来）
+4. ✅ 正确：评估 → 逐个调用 Skill() → 全部完成后实现`;
+
+console.log(instructions);
+process.exit(0);

package/src/templates/settings.json

@@ -4,25 +4,25 @@
     "SessionStart": [
       {
         "matcher": "",
-        "hooks": [{ "type": "command", "command": "node .claude/hooks/inject.js" }]
+        "hooks": [{ "type": "command", "command": "node .claude/hooks/inject.cjs" }]
       }
     ],
     "UserPromptSubmit": [
       {
         "matcher": "",
-        "hooks": [{ "type": "command", "command": "node .claude/hooks/skill-eval.js" }]
+        "hooks": [{ "type": "command", "command": "node .claude/hooks/skill-eval.cjs" }]
       }
     ],
     "PreToolUse": [
       {
         "matcher": "Bash|Write",
-        "hooks": [{ "type": "command", "command": "node .claude/hooks/guard.js", "timeout": 5000 }]
+        "hooks": [{ "type": "command", "command": "node .claude/hooks/guard.cjs", "timeout": 5000 }]
       }
     ],
     "Stop": [
       {
         "matcher": "",
-        "hooks": [{ "type": "command", "command": "node .claude/hooks/stop.js" }]
+        "hooks": [{ "type": "command", "command": "node .claude/hooks/stop.cjs" }]
       }
     ]
   },

package/src/templates/hooks/skill-eval.js

@@ -1,48 +0,0 @@
-#!/usr/bin/env node
-/**
- * Hook: UserPromptSubmit
- * 强制技能激活 - 将激活率从 ~25% 提升到 90%+
- * 来源：ruoyi-vue-plus skill-forced-eval.js 方案
- */
-const input = JSON.parse(process.argv[2] || '{}');
-const prompt = (input.prompt || '').trim();
-
-// 跳过斜杠命令
-if (/^\/[^\s]/.test(prompt)) process.exit(0);
-
-// 跳过恢复会话关键词
-const skipWords = ['继续', 'continue', 'resume', '恢复', '上次'];
-if (skipWords.some(w => prompt.toLowerCase().includes(w))) process.exit(0);
-
-// 读取已安装技能列表
-const fs = require('fs');
-const path = require('path');
-const claudeDir = path.join(process.cwd(), '.claude');
-let skills = [];
-try {
-  const skillsDir = path.join(claudeDir, 'skills');
-  for (const pack of fs.readdirSync(skillsDir)) {
-    const packDir = path.join(skillsDir, pack);
-    if (!fs.statSync(packDir).isDirectory()) continue;
-    for (const skill of fs.readdirSync(packDir)) {
-      const skillFile = path.join(packDir, skill, 'SKILL.md');
-      if (fs.existsSync(skillFile)) skills.push(`${pack}/${skill}`);
-    }
-  }
-} catch {}
-
-if (skills.length === 0) process.exit(0);
-
-// 输出强制激活指令（写入 stdout，Claude Code 会将其注入到上下文）
-process.stdout.write(JSON.stringify({
-  type: 'assistant_hint',
-  content: `## 强制技能激活（必须执行）
-
-可用技能：${skills.join(', ')}
-
-步骤 1 - 评估：针对用户问题，列出匹配的技能名称
-步骤 2 - 激活：逐个调用 Skill() 工具，每次调用后等待返回再调用下一个
-步骤 3 - 实现：所有 Skill() 调用完成后，才能开始实现
-
-⚠️ 禁止：跳过步骤 2 直接实现`
-}));