airail 0.1.0

package/dist/cli/init.js

@@ -0,0 +1,74 @@
+"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.cmdInit = cmdInit;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+const colors_1 = require("./colors");
+async function cmdInit() {
+    const cwd = process.cwd();
+    const claudeDir = path.join(cwd, '.claude');
+    if (fs.existsSync(path.join(claudeDir, 'airail.json'))) {
+        console.log((0, colors_1.warn)('当前项目已初始化 airail。'));
+        return;
+    }
+    console.log((0, colors_1.info)('正在初始化 airail...\n'));
+    const projectType = (0, utils_1.detectProjectType)(cwd);
+    if (projectType)
+        console.log((0, colors_1.cyan)(`检测到项目类型: ${projectType}\n`));
+    fs.mkdirSync(path.join(claudeDir, 'hooks'), { recursive: true });
+    fs.mkdirSync(path.join(claudeDir, 'skills'), { recursive: true });
+    (0, utils_1.copyHooks)(claudeDir);
+    (0, utils_1.copyBuiltinSkills)('universal', claudeDir);
+    (0, utils_1.copyTemplateDir)('commands', claudeDir);
+    (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.writeSettings)(claudeDir);
+    const config = {
+        version: '0.1.0',
+        pack: null,
+    };
+    (0, utils_1.writeAirailJson)(claudeDir, config);
+    console.log((0, colors_1.ok)('核心 hooks 已安装'));
+    console.log((0, colors_1.ok)('通用技能已安装'));
+    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 分析项目代码并自动填充规范文档。'));
+}

package/dist/cli/status.js

@@ -0,0 +1,66 @@
+"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.cmdStatus = cmdStatus;
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+const fs = __importStar(require("fs"));
+const colors_1 = require("./colors");
+async function cmdStatus() {
+    const claudeDir = path.join(process.cwd(), '.claude');
+    if (!fs.existsSync(path.join(claudeDir, 'airail.json'))) {
+        console.log((0, colors_1.warn)('未初始化，请先执行 "airail init"。'));
+        return;
+    }
+    const config = (0, utils_1.readAirailJson)(claudeDir);
+    console.log((0, colors_1.cyan)(`airail v${config.version}`));
+    // 只显示已安装的 skills
+    const skillsDir = path.join(claudeDir, 'skills');
+    if (!fs.existsSync(skillsDir))
+        return;
+    const skills = fs.readdirSync(skillsDir, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => e.name);
+    console.log((0, colors_1.cyan)(`\n已安装技能 (${skills.length}):`));
+    for (const s of skills) {
+        const skillFile = path.join(skillsDir, s, 'SKILL.md');
+        let desc = '';
+        if (fs.existsSync(skillFile)) {
+            const line = fs.readFileSync(skillFile, 'utf-8').split('\n').find(l => l.startsWith('description:'));
+            desc = line?.replace('description:', '').trim() || '';
+        }
+        console.log(`  ${(0, colors_1.gray)(s.padEnd(28))} ${desc}`);
+    }
+}

package/dist/cli/update.js

@@ -0,0 +1,51 @@
+"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.cmdUpdate = cmdUpdate;
+const path = __importStar(require("path"));
+const utils_1 = require("../utils");
+const colors_1 = require("./colors");
+async function cmdUpdate() {
+    const claudeDir = path.join(process.cwd(), '.claude');
+    const config = (0, utils_1.requireAirailJson)(claudeDir);
+    if (!config.pack) {
+        console.error((0, colors_1.err)('未安装任何 pack，无需更新。'));
+        process.exit(1);
+    }
+    // 从 airail.json 读取 pack 来源信息（需要扩展 AirailJson 结构）
+    // 暂时简化：提示用户重新 add
+    console.error((0, colors_1.err)('update 功能开发中，请使用 airail add 重新安装。'));
+    process.exit(1);
+}

package/dist/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./cli/index");
+(0, index_1.runCLI)();

package/dist/utils.js

@@ -0,0 +1,243 @@
+"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.PKG_ROOT = void 0;
+exports.fetchText = fetchText;
+exports.readAirailJson = readAirailJson;
+exports.writeAirailJson = writeAirailJson;
+exports.requireAirailJson = requireAirailJson;
+exports.readRc = readRc;
+exports.writeRc = writeRc;
+exports.installPackFromDir = installPackFromDir;
+exports.installSkillsFromDir = installSkillsFromDir;
+exports.copyBuiltinSkills = copyBuiltinSkills;
+exports.removeNonUniversalSkills = removeNonUniversalSkills;
+exports.copyDir = copyDir;
+exports.copyHooks = copyHooks;
+exports.copyTemplateDir = copyTemplateDir;
+exports.writeSettings = writeSettings;
+exports.writeClaude = writeClaude;
+exports.detectProjectType = detectProjectType;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const https = __importStar(require("https"));
+const http = __importStar(require("http"));
+exports.PKG_ROOT = path.join(__dirname, '..');
+// ─── HTTP 工具 ────────────────────────────────────────────────────────────────
+function fetchText(url, token) {
+    return new Promise((resolve, reject) => {
+        const mod = url.startsWith('https') ? https : http;
+        const headers = { 'User-Agent': 'airail-cli' };
+        if (token)
+            headers['Authorization'] = `Bearer ${token}`;
+        mod.get(url, { headers }, (res) => {
+            if (res.statusCode === 401 || res.statusCode === 403) {
+                reject(new Error(`访问被拒绝 (${res.statusCode})，请检查 token 是否正确。`));
+                return;
+            }
+            if (res.statusCode === 404) {
+                reject(new Error(`资源不存在 (404): ${url}`));
+                return;
+            }
+            if (res.statusCode !== 200) {
+                reject(new Error(`请求失败 (${res.statusCode}): ${url}`));
+                return;
+            }
+            const chunks = [];
+            res.on('data', (c) => chunks.push(c));
+            res.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+            res.on('error', reject);
+        }).on('error', reject);
+    });
+}
+function readAirailJson(claudeDir) {
+    const p = path.join(claudeDir, 'airail.json');
+    return JSON.parse(fs.readFileSync(p, 'utf-8'));
+}
+function writeAirailJson(claudeDir, data) {
+    fs.writeFileSync(path.join(claudeDir, 'airail.json'), JSON.stringify(data, null, 2));
+}
+function requireAirailJson(claudeDir) {
+    if (!fs.existsSync(path.join(claudeDir, 'airail.json'))) {
+        console.error('未初始化，请先执行 "airail init"。');
+        process.exit(1);
+    }
+    return readAirailJson(claudeDir);
+}
+// ─── ~/.airailrc ──────────────────────────────────────────────────────────────
+const RC_PATH = path.join(os.homedir(), '.airailrc');
+function readRc() {
+    if (!fs.existsSync(RC_PATH))
+        return {};
+    try {
+        return JSON.parse(fs.readFileSync(RC_PATH, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeRc(patch) {
+    const current = readRc();
+    fs.writeFileSync(RC_PATH, JSON.stringify({ ...current, ...patch }, null, 2));
+}
+// ─── pack 安装 ────────────────────────────────────────────────────────────────
+/**
+ * 安装 pack：
+ *   - skills/ → .claude/skills/（带 packName 前缀）
+ *   - commands/agents/hooks/templates/ → .claude/ 对应目录（全量覆盖）
+ */
+function installPackFromDir(packDir, packName, claudeDir) {
+    // 删除旧 pack 的 skills
+    removeNonUniversalSkills(claudeDir);
+    // 安装新 pack 的 skills
+    installSkillsFromDir(packDir, packName, claudeDir);
+    // 覆盖 commands / agents / hooks / templates
+    for (const sub of ['commands', 'agents', 'hooks', 'templates']) {
+        const src = path.join(packDir, sub);
+        const dest = path.join(claudeDir, sub);
+        if (fs.existsSync(src)) {
+            fs.rmSync(dest, { recursive: true, force: true });
+            copyDir(src, dest);
+        }
+    }
+}
+// ─── skills ───────────────────────────────────────────────────────────────────
+/** 将 pack/skills/ 平铺复制到 .claude/skills/（universal 不加前缀） */
+function installSkillsFromDir(packDir, packName, claudeDir) {
+    const skillsSrc = path.join(packDir, 'skills');
+    if (!fs.existsSync(skillsSrc)) {
+        console.warn(`规范包 "${packName}" 中未找到 skills/ 目录。`);
+        return;
+    }
+    const skillsDest = path.join(claudeDir, 'skills');
+    fs.mkdirSync(skillsDest, { recursive: true });
+    for (const entry of fs.readdirSync(skillsSrc, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const destName = packName === 'universal' ? entry.name : `${packName}-${entry.name}`;
+        copyDir(path.join(skillsSrc, entry.name), path.join(skillsDest, destName));
+    }
+}
+function copyBuiltinSkills(packName, claudeDir) {
+    const src = path.join(exports.PKG_ROOT, 'skills', packName);
+    if (!fs.existsSync(src)) {
+        console.warn(`内置规范包 "${packName}" 不存在。`);
+        return;
+    }
+    const skillsDest = path.join(claudeDir, 'skills');
+    fs.mkdirSync(skillsDest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const destName = packName === 'universal' ? entry.name : `${packName}-${entry.name}`;
+        copyDir(path.join(src, entry.name), path.join(skillsDest, destName));
+    }
+}
+/** 删除所有非 universal 的 skills（即带 - 前缀的） */
+function removeNonUniversalSkills(claudeDir) {
+    const skillsDir = path.join(claudeDir, 'skills');
+    if (!fs.existsSync(skillsDir))
+        return;
+    for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name.includes('-')) {
+            fs.rmSync(path.join(skillsDir, entry.name), { recursive: true, force: true });
+        }
+    }
+}
+// ─── 内置模板工具 ──────────────────────────────────────────────────────────────
+function copyDir(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const s = path.join(src, entry.name);
+        const d = path.join(dest, entry.name);
+        entry.isDirectory() ? copyDir(s, d) : fs.copyFileSync(s, d);
+    }
+}
+function copyHooks(claudeDir) {
+    const src = path.join(exports.PKG_ROOT, 'src', 'templates', 'hooks');
+    const dest = path.join(claudeDir, 'hooks');
+    fs.mkdirSync(dest, { recursive: true });
+    for (const f of fs.readdirSync(src)) {
+        fs.copyFileSync(path.join(src, f), path.join(dest, f));
+    }
+}
+/** init 时复制模板目录（不覆盖已有文件） */
+function copyTemplateDir(subDir, claudeDir) {
+    const src = path.join(exports.PKG_ROOT, 'src', 'templates', subDir);
+    if (!fs.existsSync(src))
+        return;
+    const dest = path.join(claudeDir, subDir);
+    fs.mkdirSync(dest, { recursive: true });
+    for (const f of fs.readdirSync(src)) {
+        const destFile = path.join(dest, f);
+        if (!fs.existsSync(destFile))
+            fs.copyFileSync(path.join(src, f), destFile);
+    }
+}
+function writeSettings(claudeDir) {
+    const dest = path.join(claudeDir, 'settings.json');
+    if (fs.existsSync(dest))
+        return; // 不覆盖已有文件
+    const tpl = path.join(exports.PKG_ROOT, 'src', 'templates', 'settings.json');
+    fs.copyFileSync(tpl, dest);
+}
+function writeClaude(projectDir) {
+    const tpl = path.join(exports.PKG_ROOT, 'src', 'templates', 'CLAUDE.md');
+    const dest = path.join(projectDir, 'CLAUDE.md');
+    if (!fs.existsSync(dest))
+        fs.copyFileSync(tpl, dest);
+}
+function detectProjectType(cwd) {
+    if (fs.existsSync(path.join(cwd, 'pom.xml')))
+        return 'spring-boot';
+    if (fs.existsSync(path.join(cwd, 'go.mod')))
+        return 'go';
+    if (fs.existsSync(path.join(cwd, 'package.json'))) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf-8'));
+            if (pkg.dependencies?.next)
+                return 'nextjs';
+            if (pkg.dependencies?.vue)
+                return 'vue';
+            if (pkg.dependencies?.react)
+                return 'react';
+        }
+        catch { }
+    }
+    return null;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "airail",
+  "version": "0.1.0",
+  "description": "AI coding assistant framework - enforce coding standards via Claude hooks & skills",
+  "bin": {
+    "airail": "./bin/airail.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "bin/",
+    "dist/",
+    "skills/",
+    "src/templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "release": "node ../../scripts/release.js",
+    "release:dry": "node ../../scripts/release.js --dry"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "claude",
+    "ai",
+    "coding-standards",
+    "hooks",
+    "skills"
+  ],
+  "license": "MIT"
+}

package/skills/universal/code-quality/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: code-quality
+version: 1.0.0
+pack: universal
+description: 通用代码质量规范，DRY/KISS/命名规范
+triggers:
+  - 代码质量
+  - 重构
+  - 命名
+  - DRY
+  - 重复代码
+---
+
+# 代码质量规范
+
+## 核心原则
+
+**KISS**：能简单就不复杂，三行能解决的不写十行。
+
+**DRY**：发现重复代码立即提取，零容忍 copy-paste。
+
+**YAGNI**：不为假设的未来需求写代码，只解决当前问题。
+
+## 命名规范
+
+- 变量/函数：描述"做什么"，不描述"怎么做"
+- 布尔值：用 `is/has/can/should` 前缀
+- 函数：动词开头（`getUser`, `createOrder`, `validateInput`）
+- 常量：全大写下划线（`MAX_RETRY_COUNT`）
+
+## 禁止事项
+
+- 禁止魔法数字，提取为命名常量
+- 禁止注释掉的废弃代码，直接删除
+- 禁止无意义的注释（`// 循环遍历数组`）
+- 禁止超过 3 层的嵌套，提前 return 或提取函数
+- 函数超过 30 行考虑拆分

package/skills/universal/code-review/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: code-review
+version: 1.0.0
+pack: universal
+description: 代码审查清单
+triggers:
+  - code review
+  - 代码审查
+  - 检查代码
+  - review
+---
+
+# 代码审查清单
+
+## 功能正确性
+
+- [ ] 逻辑是否正确，边界条件是否处理
+- [ ] 错误路径是否有处理
+- [ ] 是否有遗漏的业务场景
+
+## 代码质量
+
+- [ ] 有无重复代码（DRY）
+- [ ] 命名是否清晰
+- [ ] 函数是否单一职责
+- [ ] 是否有不必要的复杂度
+
+## 安全
+
+- [ ] 用户输入是否验证
+- [ ] 是否有硬编码密钥
+- [ ] 权限控制是否正确
+
+## 性能
+
+- [ ] 是否有 N+1 查询
+- [ ] 大数据量是否有分页

package/skills/universal/error-handling/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: error-handling
+version: 1.0.0
+pack: universal
+description: 错误处理规范，异常捕获和错误传递
+triggers:
+  - 错误处理
+  - 异常
+  - try catch
+  - error
+---
+
+# 错误处理规范
+
+## 核心原则
+
+- 只在系统边界处理错误（HTTP 入口、外部 API 调用、文件 IO）
+- 内部函数抛出错误，不要吞掉
+- 错误信息要有上下文，不要只写 "error occurred"
+
+## 模式
+
+**不要吞掉错误：**
+```js
+// 错误
+try { ... } catch (e) {}
+
+// 正确
+try { ... } catch (e) { throw new Error(`Failed to process order ${id}: ${e.message}`); }
+```
+
+**区分可恢复和不可恢复错误：**
+- 可恢复（用户输入错误、网络超时）：返回错误响应
+- 不可恢复（数据库连接失败）：让程序崩溃，由进程管理器重启
+
+## 禁止事项
+
+- 禁止空 catch 块
+- 禁止对不可能发生的场景加错误处理（过度防御）
+- 禁止在日志中打印完整堆栈到生产环境

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

@@ -0,0 +1,37 @@
+---
+name: git-workflow
+version: 1.0.0
+pack: universal
+description: Git 工作流规范，commit 格式和分支策略
+triggers:
+  - git
+  - commit
+  - 分支
+  - 提交
+---
+
+# Git 工作流规范
+
+## Commit 格式
+
+```
+<type>(<scope>): <description>
+```
+
+类型：`feat` / `fix` / `refactor` / `docs` / `test` / `chore`
+
+示例：
+- `feat(auth): add JWT refresh token`
+- `fix(order): correct total price calculation`
+
+## 分支策略
+
+- `main`：生产代码，禁止直接推送
+- `feat/<name>`：新功能
+- `fix/<name>`：Bug 修复
+
+## 禁止事项
+
+- 禁止 `git push --force` 到 main/master
+- 禁止提交 `.env`、密钥、凭证文件
+- 禁止在 commit message 中加 AI 署名

package/skills/universal/performance/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: performance
+version: 1.0.0
+pack: universal
+description: 性能优化原则
+triggers:
+  - 性能
+  - 慢查询
+  - 优化
+  - N+1
+---
+
+# 性能优化规范
+
+## 数据库
+
+- 查询必须走索引，避免全表扫描
+- 禁止 N+1 查询，用 JOIN 或批量查询
+- 分页查询必须有 LIMIT，禁止无限制查询
+
+## 缓存
+
+- 热点数据加缓存，设置合理 TTL
+- 缓存 key 要有命名空间，避免冲突
+- 写操作后主动失效相关缓存
+
+## 代码层面
+
+- 循环内禁止数据库查询
+- 大数据量用流式处理，不要一次性加载到内存
+- 先测量再优化，不要凭感觉优化