airail 0.1.1 → 0.1.3

package/dist/cli/add.js

@@ -45,7 +45,7 @@ async function cmdAdd(arg) {
     const config = (0, utils_1.requireAirailJson)(claudeDir);
     if (!arg) {
         console.error((0, colors_1.err)('用法: airail add <包名[@版本]|路径>'));
-        process.exit(1);
+        throw new Error('');
     }
     if (config.pack) {
         console.log((0, colors_1.warn)(`当前已安装 pack: ${config.pack}`));
@@ -56,7 +56,7 @@ async function cmdAdd(arg) {
         const localPath = path.resolve(arg);
         if (!fs.existsSync(localPath)) {
             console.error((0, colors_1.err)(`路径不存在: ${localPath}`));
-            process.exit(1);
+            throw new Error('');
         }
         const packName = readPackName(localPath);
         (0, utils_1.installPackFromDir)(localPath, packName, claudeDir);
@@ -69,7 +69,7 @@ async function cmdAdd(arg) {
     const rc = (0, utils_1.readRc)();
     if (!rc.configServer) {
         console.error((0, colors_1.err)('未配置配置仓库，请先执行: airail config setup'));
-        process.exit(1);
+        throw new Error('');
     }
     await installPackFromConfigCenter(arg, claudeDir, config, rc);
     (0, utils_1.writeAirailJson)(claudeDir, config);
@@ -113,13 +113,13 @@ async function installPackFromConfigCenter(packNameWithVersion, claudeDir, confi
     }
     catch (e) {
         console.error((0, colors_1.err)(`获取规范包列表失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     const pack = packs.find(p => p.name === packName);
     if (!pack) {
         console.error((0, colors_1.err)(`规范包 "${packName}" 不存在。`));
         console.log((0, colors_1.info)(`可用规范包: ${packs.map(p => p.name).join(', ')}`));
-        process.exit(1);
+        throw new Error('');
     }
     // 使用用户指定的版本，如果没有指定则使用配置仓库的版本
     const gitRef = userVersion || pack.gitRef;

package/dist/cli/config.js

@@ -104,19 +104,19 @@ async function listConfigs() {
     const rc = (0, utils_1.readRc)();
     if (!rc.configServer) {
         console.error((0, colors_1.err)('未配置配置仓库，请先执行: airail config setup'));
-        process.exit(1);
+        throw new Error('');
     }
     try {
         ensureConfigRepo(rc.configServer, rc.configToken);
     }
     catch (e) {
         console.error((0, colors_1.err)(e.message));
-        process.exit(1);
+        throw new Error('');
     }
     const indexPath = path.join(CONFIG_REPO_DIR, 'settings', 'index.json');
     if (!fs.existsSync(indexPath)) {
         console.error((0, colors_1.err)('配置仓库中未找到 settings/index.json'));
-        process.exit(1);
+        throw new Error('');
     }
     let entries;
     try {
@@ -124,7 +124,7 @@ async function listConfigs() {
     }
     catch (e) {
         console.error((0, colors_1.err)(`读取配置列表失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     if (entries.length === 0) {
         console.log((0, colors_1.warn)('暂无可用配置。'));
@@ -139,20 +139,20 @@ async function useConfig(name) {
     const rc = (0, utils_1.readRc)();
     if (!rc.configServer) {
         console.error((0, colors_1.err)('未配置配置仓库，请先执行: airail config setup'));
-        process.exit(1);
+        throw new Error('');
     }
     try {
         ensureConfigRepo(rc.configServer, rc.configToken);
     }
     catch (e) {
         console.error((0, colors_1.err)(e.message));
-        process.exit(1);
+        throw new Error('');
     }
     // 获取配置清单
     const indexPath = path.join(CONFIG_REPO_DIR, 'settings', 'index.json');
     if (!fs.existsSync(indexPath)) {
         console.error((0, colors_1.err)('配置仓库中未找到 settings/index.json'));
-        process.exit(1);
+        throw new Error('');
     }
     let entries;
     try {
@@ -160,7 +160,7 @@ async function useConfig(name) {
     }
     catch (e) {
         console.error((0, colors_1.err)(`读取配置列表失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     if (entries.length === 0) {
         console.log((0, colors_1.warn)('暂无可用配置。'));
@@ -171,7 +171,7 @@ async function useConfig(name) {
     if (name) {
         if (!entries.find(e => e.name === name)) {
             console.error((0, colors_1.err)(`配置 "${name}" 不存在，可用: ${entries.map(e => e.name).join(', ')}`));
-            process.exit(1);
+            throw new Error('');
         }
         chosen = name;
     }
@@ -188,7 +188,7 @@ async function useConfig(name) {
     const settingsPath = path.join(CONFIG_REPO_DIR, 'settings', `${chosen}.json`);
     if (!fs.existsSync(settingsPath)) {
         console.error((0, colors_1.err)(`配置文件不存在: settings/${chosen}.json`));
-        process.exit(1);
+        throw new Error('');
     }
     let content;
     try {
@@ -197,7 +197,7 @@ async function useConfig(name) {
     }
     catch (e) {
         console.error((0, colors_1.err)(`读取配置失败: ${e.message}`));
-        process.exit(1);
+        throw new Error('');
     }
     const globalClaudeDir = path.join(os.homedir(), '.claude');
     if (!fs.existsSync(globalClaudeDir)) {

package/dist/cli/index.js

@@ -59,7 +59,7 @@ function printBanner() {
 function printHelp() {
     const cmds = [
         ['init', '在当前项目初始化 airail'],
-        ['add <url|路径>', '安装规范包（git URL 或本地路径）'],
+        ['add <包名[@版本]|路径>', '安装规范包（从配置仓库或本地路径）'],
         ['install [工具名]', '安装 CLI 工具（如 claude-code）'],
         ['clear', '清理 airail 相关内容'],
         ['update', '更新已安装的规范包'],
@@ -68,7 +68,7 @@ function printHelp() {
         ['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'));
 }
@@ -83,21 +83,24 @@ async function executeCommand(cmd, args) {
         config: () => (0, config_1.cmdConfig)(args[0], ...args.slice(1)),
     };
     if (cmd === 'exit') {
-        return false;
+        return { shouldContinue: false, success: true };
     }
     const handler = commands[cmd];
     if (!handler) {
         console.log(`未知命令: ${cmd}`);
         printHelp();
-        return true;
+        return { shouldContinue: true, success: false };
     }
     try {
         await handler();
+        return { shouldContinue: true, success: true };
     }
     catch (e) {
-        console.error(e.message);
+        if (e.message) {
+            console.error(e.message);
+        }
+        return { shouldContinue: true, success: false };
     }
-    return true;
 }
 function startInteractiveMode() {
     printBanner();
@@ -116,7 +119,7 @@ function startInteractiveMode() {
             return;
         }
         const [cmd, ...args] = input.split(/\s+/);
-        const shouldContinue = await executeCommand(cmd, args);
+        const { shouldContinue } = await executeCommand(cmd, args);
         if (!shouldContinue) {
             rl.close();
             process.exit(0);
@@ -136,9 +139,9 @@ function runCLI() {
         return;
     }
     // 有参数：直接执行命令（不显示 banner）
-    executeCommand(cmd, args).then((shouldContinue) => {
-        if (!shouldContinue) {
-            process.exit(0);
+    executeCommand(cmd, args).then(({ shouldContinue, success }) => {
+        if (!shouldContinue || !success) {
+            process.exit(success ? 0 : 1);
         }
     }).catch((e) => {
         console.error(e.message);

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/update.js

@@ -42,10 +42,10 @@ async function cmdUpdate() {
     const config = (0, utils_1.requireAirailJson)(claudeDir);
     if (!config.pack) {
         console.error((0, colors_1.err)('未安装任何 pack，无需更新。'));
-        process.exit(1);
+        throw new Error('');
     }
     // 从 airail.json 读取 pack 来源信息（需要扩展 AirailJson 结构）
     // 暂时简化：提示用户重新 add
     console.error((0, colors_1.err)('update 功能开发中，请使用 airail add 重新安装。'));
-    process.exit(1);
+    throw new Error('');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airail",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "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 技能