airail 0.1.2 → 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([
         '',
@@ -59,16 +60,17 @@ function printBanner() {
 function printHelp() {
     const cmds = [
         ['init', '在当前项目初始化 airail'],
-        ['add <url|路径>', '安装规范包（git URL 或本地路径）'],
+        ['add <包名[@版本]|路径>', '安装规范包（从配置仓库或本地路径）'],
         ['install [工具名]', '安装 CLI 工具（如 claude-code）'],
         ['clear', '清理 airail 相关内容'],
         ['update', '更新已安装的规范包'],
         ['config [子命令]', '管理团队配置仓库 (setup / list / use)'],
         ['status', '查看已安装的技能'],
+        ['ver', '查看 airail 版本'],
         ['exit', '退出交互模式'],
     ];
     const dispWidth = (s) => [...s].reduce((n, c) => n + (c.charCodeAt(0) > 0x7f ? 2 : 1), 0);
-    const col = 22;
+    const col = 30;
     const lines = cmds.map(([c, d]) => `  ${c}${' '.repeat(Math.max(1, col - dispWidth(c)))}${d}`);
     console.log(['可用命令:', ...lines].join('\n'));
 }
@@ -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/init.js

@@ -57,7 +57,7 @@ async function cmdInit() {
     (0, utils_1.copyTemplateDir)('agents', claudeDir);
     (0, utils_1.copyTemplateDir)('templates', claudeDir);
     (0, utils_1.copyTemplateDir)('docs', claudeDir);
-    (0, utils_1.writeClaude)(cwd);
+    (0, utils_1.writeClaude)(claudeDir);
     (0, utils_1.writeSettings)(claudeDir);
     const config = {
         version: '0.1.0',
@@ -69,6 +69,6 @@ async function cmdInit() {
     console.log((0, colors_1.ok)('斜杠命令已安装'));
     console.log((0, colors_1.ok)('文档模板已安装'));
     console.log((0, colors_1.ok)('\nairail 初始化完成！'));
-    console.log((0, colors_1.warn)('提示：执行 airail add <git-url|路径> 安装规范包。'));
-    console.log((0, colors_1.warn)('提示：在 Claude Code 中输入 /init-docs 让 AI 分析项目代码并自动填充规范文档。'));
+    console.log((0, colors_1.warn)('提示：在 Claude Code 中输入 /init-skills 让 AI 分析项目并生成技能。'));
+    console.log((0, colors_1.warn)('提示：在 Claude Code 中输入 /start 了解项目。'));
 }

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.2",
+  "version": "0.1.4",
   "description": "AI coding assistant framework - enforce coding standards via Claude hooks & skills",
   "bin": {
     "airail": "./bin/airail.js"

package/skills/universal/development-workflow/SKILL.md

@@ -0,0 +1,307 @@
+---
+name: development-workflow
+description: |
+  项目开发工作流和最佳实践。包含开发流程建议、编码最佳实践、技术选型建议。
+
+  触发场景：
+  - 询问开发流程和工作流
+  - 询问最佳实践和开发规范
+  - 询问如何组织开发工作
+  - 询问技术选型建议
+  - 询问命令使用顺序
+
+  触发词：开发流程、工作流、最佳实践、开发规范、如何开发、开发建议、技术选型、命令使用、开发顺序、项目管理
+---
+
+# 项目开发工作流和最佳实践
+
+## 概述
+
+本技能提供项目开发的工作流建议、编码最佳实践和技术选型指导，帮助开发者高效、规范地完成项目开发。
+
+---
+
+## 开发流程建议
+
+### 标准开发流程（6步法）
+
+1. **明确需求** → 使用 `/start` 快速了解项目
+   - 了解项目结构和技术栈
+   - 查看现有功能和代码组织
+   - 确认开发环境和依赖
+
+2. **检查规范** → 使用 `/check` 检查代码质量
+   - 检查现有代码规范
+   - 发现潜在问题
+   - 了解项目编码标准
+
+3. **分析进度** → 使用 `/progress` 了解完成情况
+   - 查看项目完成度
+   - 了解待办事项
+   - 评估工作量
+
+4. **开始开发** → 使用 `/dev` 或 `/crud` 快速生成代码
+   - 表已存在：使用 `/crud` 快速生成
+   - 从零开始：使用 `/dev` 完整开发
+   - 遵循项目规范和架构
+
+5. **添加待办** → 使用 `/add-todo` 跟踪任务
+   - 记录新发现的任务
+   - 标记优先级
+   - 设置截止日期
+
+6. **获取建议** → 使用 `/next` 确定下一步方向
+   - 分析当前状态
+   - 获取优先级建议
+   - 规划下一步工作
+
+### 定期维护流程
+
+- **每日**：使用 `/add-todo` 记录新任务
+- **每周**：使用 `/check` 检查代码质量
+- **每周**：使用 `/progress` 查看进度
+- **每周**：使用 `/sync` 生成综合报告
+- **每月**：使用 `/next` 规划下一阶段工作
+
+---
+
+## 编码最佳实践
+
+### 1. 单一职责原则
+
+**原则**：每个模块、类、方法只负责一件事
+
+**实践**：
+- 业务层负责业务逻辑
+- 接口层负责请求处理和参数验证
+- 数据层负责数据访问
+- 工具类负责通用功能
+
+**反例**：
+```
+❌ Controller 中包含复杂的业务逻辑
+❌ Service 中直接操作 HTTP 请求
+❌ 一个方法做多件不相关的事
+```
+
+**正例**：
+```
+✅ Controller 只做参数验证和调用 Service
+✅ Service 专注业务逻辑
+✅ 每个方法职责清晰
+```
+
+---
+
+### 2. 查询优化
+
+**原则**：规范构建查询条件，避免性能问题
+
+**实践**：
+- 使用规范的查询条件构建方式
+- 避免 N+1 查询问题
+- 合理使用索引
+- 分页查询大数据量
+
+**查询条件规范**：
+- 精确匹配：ID、状态、类型等
+- 模糊搜索：名称、标题、内容等
+- 范围查询：日期、金额等
+- 关联查询：使用 JOIN 而非多次查询
+
+---
+
+### 3. 权限管理
+
+**原则**：所有公开接口必须有权限控制
+
+**实践**：
+- 所有接口添加权限注解
+- 按模块划分权限
+- 按操作类型划分权限（查看、新增、修改、删除）
+- 敏感操作增加二次验证
+
+**权限分类**：
+- 查看权限：list、query
+- 操作权限：add、edit、remove
+- 特殊权限：export、import、approve
+
+---
+
+### 4. 注释完整
+
+**原则**：关键方法必须有完整注释
+
+**实践**：
+- 公开接口必须有注释
+- 复杂业务逻辑必须有注释
+- 工具方法必须有注释
+- 注释说明用途、参数、返回值
+
+**注释内容**：
+- 方法用途和功能
+- 参数说明（类型、含义、约束）
+- 返回值说明
+- 异常说明
+- 使用示例（如需要）
+
+---
+
+### 5. 定期检查
+
+**原则**：每周至少一次运行代码检查和进度查看
+
+**实践**：
+- 每周运行 `/check` 检查代码质量
+- 每周运行 `/progress` 查看进度
+- 每周运行 `/sync` 生成综合报告
+- 及时修复发现的问题
+
+**检查内容**：
+- 代码规范问题
+- TODO/FIXME 标记
+- 代码重复
+- 性能问题
+- 安全问题
+
+---
+
+## 技术选型建议
+
+### 场景 1：快速生成 CRUD
+
+**推荐方案**：`/crud` 命令
+
+**适用条件**：
+- 数据库表已存在
+- 只需标准 CRUD 功能
+- 无复杂业务逻辑
+
+**优势**：
+- 生成速度快
+- 代码规范统一
+- 减少重复工作
+
+---
+
+### 场景 2：从零开发功能
+
+**推荐方案**：`/dev` 命令
+
+**适用条件**：
+- 表结构尚未设计
+- 需要完整的开发流程
+- 包含业务逻辑设计
+
+**优势**：
+- 包含表设计指导
+- 完整的开发流程
+- 考虑业务逻辑
+
+---
+
+### 场景 3：代码规范检查
+
+**推荐方案**：`/check` 命令
+
+**适用条件**：
+- 开发完成后
+- 定期检查
+- 发现代码问题
+
+**优势**：
+- 及时发现问题
+- 统一代码规范
+- 提升代码质量
+
+---
+
+### 场景 4：项目进度追踪
+
+**推荐方案**：`/progress` 命令
+
+**适用条件**：
+- 定期了解完成情况
+- 评估工作量
+- 规划下一步工作
+
+**优势**：
+- 清晰的进度展示
+- 待办事项统计
+- 完成率分析
+
+---
+
+### 场景 5：全量同步
+
+**推荐方案**：`/sync` 命令
+
+**适用条件**：
+- 每周整理
+- 发现数据不一致
+- 生成综合报告
+
+**优势**：
+- 全量扫描
+- 综合分析
+- 生成报告
+
+---
+
+## 常见问题
+
+### Q1：什么时候使用 /crud，什么时候使用 /dev？
+
+**A1**：
+- 表已存在 → 使用 `/crud`
+- 从零开始 → 使用 `/dev`
+- 只需标准 CRUD → 使用 `/crud`
+- 需要复杂业务逻辑 → 使用 `/dev`
+
+---
+
+### Q2：如何保证代码质量？
+
+**A2**：
+1. 开发前：使用 `/check` 了解项目规范
+2. 开发中：遵循最佳实践
+3. 开发后：使用 `/check` 检查代码
+4. 定期：每周运行 `/check` 和 `/sync`
+
+---
+
+### Q3：如何管理待办事项？
+
+**A3**：
+1. 发现任务：使用 `/add-todo` 立即记录
+2. 查看进度：使用 `/progress` 查看待办
+3. 获取建议：使用 `/next` 确定优先级
+4. 定期整理：每周清理已完成任务
+
+---
+
+### Q4：如何规划下一步工作？
+
+**A4**：
+1. 使用 `/next` 获取建议
+2. 根据优先级排序
+3. 先处理高优先级任务
+4. 定期使用 `/progress` 查看进度
+
+---
+
+## 注意事项
+
+1. **遵循项目规范**：每个项目可能有特定的规范，优先遵循项目规范
+2. **保持代码一致性**：与现有代码保持一致的风格
+3. **及时记录待办**：发现问题立即记录，避免遗忘
+4. **定期检查代码**：每周至少一次代码检查
+5. **持续学习改进**：根据项目经验不断优化工作流
+
+---
+
+## 相关技能
+
+- 如果是后端开发规范 → 使用 backend-development 技能
+- 如果是数据库设计规范 → 使用 database-design 技能
+- 如果是 API 设计规范 → 使用 api-design 技能

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/add-todo.md

@@ -1,24 +1,224 @@
-# 添加待办事项
+# /add-todo - 快速添加待办事项
 
-> 使用方式：`/add-todo <任务描述>`
+智能待办事项管理助手，支持优先级解析、模块识别、批量添加、自动创建文档。
 
-## 执行流程
+---
 
-1. 解析任务描述
-2. 追加到 `.claude/templates/项目状态.md` 的待办清单
-3. 输出确认信息
+## 使用方式
+
+```bash
+/add-todo 实现用户权限管理
+/add-todo 修复登录bug，优先级高
+/add-todo 优化接口性能，3天，中等优先级
+/add-todo [模块名] 实现测试功能
+/add-todo 修复缓存问题，高，截止1月30号
+```
+
+---
+
+## 第一步：智能检测文档状态
+
+### 检查待办清单文档
+
+检查 `docs/待办清单.md` 或 `.claude/docs/待办清单.md` 是否存在：
+
+**如果不存在**：
+1. 自动创建待办清单文档
+2. 使用标准模板（包含高/中/低优先级分区）
+3. 输出提示：`📝 已自动创建待办清单文档`
+
+**如果存在**：
+直接读取现有内容
+
+---
+
+## 第二步：解析任务信息
+
+### 从用户输入中提取
+
+| 信息 | 解析方式 | 默认值 |
+|------|---------|--------|
+| 任务名称 | 必填，主体内容 | - |
+| 优先级 | "高"/"中"/"低"，或"紧急"/"重要" | 中 |
+| 预计时间 | "X天"/"X周" | 待定 |
+| 所属模块 | 模块名前缀（如有） | 通用 |
+| 截止日期 | "截止XX"或"deadline XX" | 待定 |
+
+### 优先级映射
+
+| 用户输入 | 映射到 |
+|---------|--------|
+| 高、紧急、urgent、critical、ASAP | 🔥 高优先级 |
+| 中、一般、normal、默认 | 📌 中优先级 |
+| 低、可延后、optional、nice-to-have | 💡 低优先级 |
+
+### 模块识别
+
+如果任务描述以模块名开头（如"后端 XXX"、"前端 XXX"、"[模块名] XXX"），自动识别并记录所属模块。
+
+---
+
+## 第三步：添加到待办清单
+
+### 读取现有内容
+- 读取待办清单文档
+- 解析各优先级区域的位置
+
+### 添加任务
+
+根据优先级添加到对应区域：
+
+```markdown
+## 🔥 高优先级（紧急重要）
+- [ ] [任务名称]
+  - 截止日期: YYYY-MM-DD（如果有）
+  - 描述: [任务描述]（如果有）
+  - 所属模块: [模块名]（如果识别到）
+  - 预计工作量: X天（如果有）
+  - 添加时间: YYYY-MM-DD HH:MM
+
+## 📌 中优先级（重要不紧急）
+...
+
+## 💡 低优先级（可延后）
+...
+```
+
+### 更新统计信息
+- 更新"待办总数": X 项
+- 更新"最后更新": 当前时间
+
+---
+
+## 第四步：输出确认信息
+
+```markdown
+✅ 已添加待办任务：
+
+📌 **[任务名称]**
+- 优先级: 高/中/低
+- 预计时间: X天
+- 所属模块: [模块名]（如果有）
+- 截止日期: YYYY-MM-DD（如果有）
+
+📁 已更新文件: docs/待办清单.md
+📊 当前待办总数: X 项
+```
+
+---
+
+## 批量添加支持
+
+### 多任务添加
+
+用户可以一次添加多个任务：
+
+```bash
+/add-todo 实现用户登录；实现用户注册；实现密码重置
+```
+
+或分行：
+
+```
+/add-todo
+1. 实现用户登录，高优先级
+2. 实现用户注册，中优先级
+3. 实现密码重置，低优先级
+```
+
+### 处理方式
+- 按分号、换行、数字编号分割
+- 依次解析每个任务
+- 批量添加并汇总报告
+
+---
+
+## 智能建议
+
+### 添加后提示
+
+添加任务后，根据情况给出建议：
+
+**待办过多时（>15项）**：
+```
+💡 提示：当前待办已有 18 项，建议梳理优先级或归档低优先级任务
+```
+
+**高优先级过多时（>5项）**：
+```
+⚠️ 提示：高优先级任务已有 6 项，建议重新评估优先级
+```
+
+**相似任务检测**：
+```
+💡 提示：检测到相似待办：
+- 已有: "实现用户登录功能"
+- 新增: "用户登录"
+是否为同一任务？
+```
+
+---
 
 ## 示例
 
+### 示例 1：简单添加
+
+```
+用户: /add-todo 修复通知发送错误
+
+AI: ✅ 已添加待办任务：
+
+📌 **修复通知发送错误**
+- 优先级: 中
+- 预计时间: 待定
+- 添加时间: 2025-12-25 14:30
+
+📁 已更新: docs/待办清单.md
+📊 当前待办总数: 8 项
 ```
-/add-todo 实现用户导出 Excel 功能
-/add-todo 修复订单列表分页 bug
-/add-todo 优化商品查询接口性能
+
+### 示例 2：带参数添加
+
+```
+用户: /add-todo 后端 实现导出功能，高优先级，2天
+
+AI: ✅ 已添加待办任务：
+
+🔥 **实现导出功能**
+- 优先级: 高
+- 预计时间: 2天
+- 所属模块: 后端
+- 添加时间: 2025-12-25 14:30
+
+📁 已更新: docs/待办清单.md
+📊 当前待办总数: 9 项
 ```
 
-## 输出格式
+### 示例 3：自动创建文档
 
 ```
-✅ 已添加待办：{{TASK}}
-当前待办总数：{{COUNT}} 项
+用户: /add-todo 开发后端接口文档
+
+AI: 📝 已自动创建 docs/待办清单.md
+
+✅ 已添加待办任务：
+
+📌 **开发后端接口文档**
+- 优先级: 中
+- 预计时间: 待定
+- 添加时间: 2025-12-25 14:30
+
+📁 已更新: docs/待办清单.md
+📊 当前待办总数: 1 项
 ```
+
+---
+
+## 相关命令
+
+| 命令 | 关系 |
+|------|------|
+| `/update-status` | 批量同步待办清单，/add-todo 是单个添加 |
+| `/progress` | 查看项目进度和待办统计 |
+| `/sync` | 全量同步，生成综合报告 |
+| `/init-skills` | 初始化项目技能（首次使用） |