@ghenya/clinn 0.8.5 → 0.8.7

package/Skills/code_review.cjs

@@ -0,0 +1,48 @@
+/**
+ * 代码审查技能 — 写完后自检，不等用户发现问题
+ */
+module.exports = {
+  description: "写完代码后系统性地自审: 安全/性能/可读性/边界条件 四维检查",
+  category: "development",
+  trigger: "每次写完新文件或修改 >20 行代码时自动调用",
+  instructions: `
+你刚完成了一次代码修改。现在必须对自己的代码进行系统审查，不能直接说"完成了"。
+
+审查按以下四个维度进行：
+
+【安全】
+- 有无 SQL 注入？(检查字符串拼接构建 SQL)
+- 有无 XSS？(检查未经转义的用户输入输出)
+- 有无命令注入？(检查 exec/execSync 中的用户输入)
+- 敏感信息是否硬编码？(API key/password)
+
+【性能】
+- 有无 N+1 查询？
+- 循环内有无同步 I/O？
+- 大文件是否一次性读入内存？
+
+【可读性】
+- 函数是否超过 30 行？
+- 变量名是否清晰？
+- 有无魔数？
+
+【边界条件】
+- null/undefined 是否处理？
+- 空数组/空字符串？
+- 极端值（0, -1, MAX_INT）？
+`,
+  workflow: [
+    "读取刚写的文件完整内容",
+    "逐维度检查，列出发现的问题",
+    "对每个问题判定: 严重/建议",
+    "用 search_replace 修复严重问题",
+    "修复后重新运行语法检查",
+    "汇报: 检查了X个维度，发现Y个问题，修复了Z个",
+  ],
+  pitfalls: [
+    "不要只读几行就下结论——读完整文件",
+    "不要假设代码没问题——每一个维度都要真正去看",
+    "严重问题必须当场修，不能只报告",
+    "如果代码确实完美，也要明确说'四维度检查通过，无问题'",
+  ],
+};

package/Skills/git_workflow.cjs

@@ -0,0 +1,47 @@
+/**
+ * Git 工作流技能
+ */
+module.exports = {
+  description: "标准 Git 工作流: 分支→提交→推送, 含提交信息规范和代码审查前检查",
+  category: "development",
+  trigger: "用户说 '提交'/'commit'/'push'/'PR' 或写完代码准备提交时使用",
+  instructions: `
+【提交前检查】
+- 运行语法检查 (node --check / py_compile)
+- 如果项目有测试，运行相关测试
+- 检查是否有调试代码 (console.log / print / debugger)
+- 检查是否有敏感信息 (API key / token / password)
+
+【分支策略】
+- 新功能: feature/<描述>
+- Bug修复: fix/<描述>
+- 重构: refactor/<描述>
+- 不要直接在 main/master 上提交
+
+【提交信息规范】
+格式: <type>: <简短描述>
+type: feat / fix / refactor / docs / test / chore
+描述用中文或英文，动词开头，不超过 50 字
+如有必要，空一行后加详细说明
+
+【推送与 PR】
+- push 前先 git pull --rebase
+- 解决冲突后重新运行测试
+- PR 描述写清楚: 做了什么 / 为什么 / 怎么测
+`,
+  workflow: [
+    "检查当前分支和状态 (git status)",
+    "创建功能分支 (如需要)",
+    "运行语法检查和测试",
+    "检查无调试代码和敏感信息",
+    "git add 相关文件（不提交无关文件）",
+    "按规范撰写提交信息并提交",
+    "git pull --rebase 同步远程",
+    "推送并汇报",
+  ],
+  pitfalls: [
+    "绝对不提交 node_modules / .env / 编译产物",
+    "不要 git add . 一把梭——逐文件确认",
+    "提交信息不要写 'update' / 'fix' / '修改' 这种无意义描述",
+  ],
+};

package/Skills/refactor.cjs

@@ -0,0 +1,40 @@
+/**
+ * 安全重构技能
+ */
+module.exports = {
+  description: "安全重构: 先测试覆盖, 再小步改, 每步验证. 避免一次大改动导致全线崩溃",
+  category: "development",
+  trigger: "用户说 '重构'/'整理'/'优化结构' 时使用",
+  instructions: `
+重构的前提是：行为不变，结构变好。
+
+【第零步: 安全网】
+- 先确认现有测试是否通过
+- 如果没有测试，先写"特征测试"（验证当前行为）
+- 为要修改的模块的公共接口写测试
+
+【重构步】
+- 每次只做一个原子变换（如: 提取函数、重命名、移动文件）
+- 每次变换后立即运行测试
+- 测试失败 → 立即回退 → 分析原因 → 换方式再试
+
+【验证步】
+- 全部重构完成后运行全量测试
+- 对比重构前后的代码行数和复杂度
+- 确认没有引入新的 lint 警告
+`,
+  workflow: [
+    "运行现有测试确认基线绿色",
+    "如无测试，为要重构的模块写特征测试",
+    "识别代码坏味道（长函数/重复/耦合）",
+    "按优先级逐个处理，每次只做一个变换",
+    "每次变换后运行测试",
+    "全量测试验证",
+    "汇报重构结果",
+  ],
+  pitfalls: [
+    "绝对禁止同时做多个重构",
+    "没有测试不要重构——先写测试",
+    "不要顺便改功能——重构只改结构不改行为",
+  ],
+};

package/Skills/systematic_debug.cjs

@@ -0,0 +1,52 @@
+/**
+ * 系统调试技能 — 四阶段根因分析
+ */
+module.exports = {
+  description: "遇到错误时进行四阶段根因分析: 复现→定位→修复→验证, 不猜测、不跳过",
+  category: "development",
+  trigger: "任何命令返回非零退出码、抛出异常、或用户报告 bug 时使用",
+  instructions: `
+遇到错误时，严格按以下四阶段执行。禁止跳过任何阶段。
+
+【阶段1: 复现】
+- 读取错误信息全文（不要截断）
+- 找到触发错误的具体输入/操作
+- 用同样的输入再次执行，确认可复现
+- 如果是间歇性问题，执行 3 次
+
+【阶段2: 定位】
+- 读取报错文件的相关代码（错误行前后 20 行）
+- 追踪数据流：输入从哪里来→经过了什么处理→在哪里出错
+- 用 console.log / print 插入诊断点，确认中间值
+- 不要猜原因——必须看到证据
+
+【阶段3: 修复】
+- 确认根因后再改代码
+- 最小改动原则：只改必要的部分
+- 修改后立即运行语法检查
+- 如果有测试，运行相关测试
+
+【阶段4: 验证】
+- 用原来触发错误的输入重新测试
+- 测试边界条件（空值/极值）
+- 确认修复没有引入新问题
+- 报告：错误原因→修复内容→验证结果
+`,
+  workflow: [
+    "读取完整错误信息",
+    "定位错误文件和行号",
+    "读取错误上下文代码（前后20行）",
+    "插入诊断，确认根因",
+    "实施最小修复",
+    "运行语法检查",
+    "用原始输入重新测试",
+    "边界条件验证",
+    "汇报修复全过程",
+  ],
+  pitfalls: [
+    "绝对禁止猜测错误原因——每个结论必须有工具输出支撑",
+    "不要跳过诊断直接改代码",
+    "不要一次改多个地方——改一处验证一处",
+    "如果 3 次尝试仍未修复，停下来总结已知信息，重新分析",
+  ],
+};

package/Skills/templates/cli-tool.cjs

@@ -0,0 +1,55 @@
+/**
+ * Node.js CLI 工具模版
+ */
+module.exports = {
+  description: "Node.js CLI 工具 (commander + chalk)",
+  category: "nodejs",
+  params: {
+    name: "命令名, 如 'my-cli'",
+    description: "CLI 描述",
+    commands: "子命令, 逗号分隔, 如 'init,build'",
+  },
+  generate: function (params) {
+    var name = params.name || "my-cli";
+    var desc = params.description || "A CLI tool";
+    var cmds = params.commands ? params.commands.split(",").map(function (s) { return s.trim(); }) : ["hello"];
+
+    var lines = [
+      "#!/usr/bin/env node",
+      "const { program } = require('commander');",
+      "const chalk = require('chalk');",
+      "const fs = require('fs');",
+      "const path = require('path');",
+      "",
+      "// ---------- 配置 ----------",
+      "const pkg = require('../package.json');",
+      "program",
+      "  .name('" + name + "')",
+      "  .description('" + desc + "')",
+      "  .version(pkg.version)",
+      "  .option('-v, --verbose', '详细输出');",
+      "",
+      "// ---------- 子命令 ----------",
+    ];
+
+    cmds.forEach(function (cmd) {
+      lines.push("program");
+      lines.push("  .command('" + cmd + "')");
+      lines.push("  .description('" + cmd + " command')");
+      lines.push("  .action(function () {");
+      lines.push("    console.log(chalk.green('Running " + cmd + "...'));");
+      lines.push("  });");
+      lines.push("");
+    });
+
+    lines.push("// ---------- 启动 ----------");
+    lines.push("program.parse(process.argv);");
+    lines.push("");
+    lines.push("// 无参数时显示帮助");
+    lines.push("if (!process.argv.slice(2).length) {");
+    lines.push("  program.outputHelp();");
+    lines.push("}");
+
+    return lines.join("\n");
+  },
+};

package/Skills/templates/express-api.cjs

@@ -0,0 +1,66 @@
+/**
+ * Express REST API 模版
+ * 生成一个完整的 Express 服务器，含路由、中间件、错误处理
+ */
+module.exports = {
+  description: "Express.js REST API 服务器 (含路由/中间件/错误处理)",
+  category: "nodejs",
+  params: {
+    name: "项目名",
+    port: "端口号, 默认 3000",
+    routes: "路由列表, 逗号分隔, 如 'users,posts'",
+  },
+  generate: function (params) {
+    var port = params.port || 3000;
+    var routeNames = params.routes ? params.routes.split(",").map(function (s) { return s.trim(); }) : ["api"];
+
+    var routeUses = routeNames
+      .map(function (r) { return "app.use('/api/" + r + "', " + r + "Router);"; })
+      .join("\n");
+
+    var lines = [
+      "const express = require('express');",
+      "const cors = require('cors');",
+      "const morgan = require('morgan');",
+      "",
+      "const app = express();",
+      "const PORT = process.env.PORT || " + port + ";",
+      "",
+      "// ---------- 中间件 ----------",
+      "app.use(cors());",
+      "app.use(morgan('dev'));",
+      "app.use(express.json());",
+      "app.use(express.urlencoded({ extended: true }));",
+      "",
+      "// ---------- 路由 ----------",
+      routeUses,
+      "",
+      "app.get('/health', (req, res) => {",
+      "  res.json({ status: 'ok', uptime: process.uptime() });",
+      "});",
+      "",
+      "// ---------- 404 ----------",
+      "app.use((req, res) => {",
+      "  res.status(404).json({ error: 'Not Found' });",
+      "});",
+      "",
+      "// ---------- 全局错误处理 ----------",
+      "app.use((err, req, res, next) => {",
+      "  console.error('[Error]', err.message);",
+      "  res.status(err.status || 500).json({",
+      "    error: err.message || 'Internal Server Error',",
+      "  });",
+      "});",
+      "",
+      "// ---------- 启动 ----------",
+      "if (require.main === module) {",
+      "  app.listen(PORT, function () {",
+      "    console.log('Server running on http://localhost:' + PORT);",
+      "  });",
+      "}",
+      "",
+      "module.exports = app;",
+    ];
+    return lines.join("\n");
+  },
+};

package/Skills/templates/python-script.cjs

@@ -0,0 +1,64 @@
+/**
+ * Python 脚本模版
+ */
+module.exports = {
+  description: "Python 脚本骨架 (argparse + logging)",
+  category: "python",
+  params: {
+    name: "脚本描述",
+  },
+  generate: function (params) {
+    var desc = params.name || "Python script";
+    return [
+      "#!/usr/bin/env python3",
+      '"""' + desc + '"""',
+      "",
+      "import argparse",
+      "import logging",
+      "import sys",
+      "from pathlib import Path",
+      "",
+      "# ---------- 日志 ----------",
+      "logging.basicConfig(",
+      '    level=logging.INFO,',
+      '    format="%(asctime)s [%(levelname)s] %(message)s",',
+      '    datefmt="%Y-%m-%d %H:%M:%S",',
+      ")",
+      "logger = logging.getLogger(__name__)",
+      "",
+      "",
+      "def main() -> None:",
+      '    parser = argparse.ArgumentParser(description="' + desc + '")',
+      '    parser.add_argument("--verbose", "-v", action="store_true", help="详细输出")',
+      '    parser.add_argument("input", nargs="?", help="输入文件路径")',
+      "    args = parser.parse_args()",
+      "",
+      "    if args.verbose:",
+      "        logging.getLogger().setLevel(logging.DEBUG)",
+      "",
+      '    logger.info("Starting...")',
+      "",
+      "    try:",
+      "        # TODO: 主逻辑",
+      "        if args.input:",
+      "            path = Path(args.input)",
+      "            if not path.exists():",
+      '                logger.error(f"File not found: {args.input}")',
+      "                sys.exit(1)",
+      '            logger.info(f"Processing: {path}")',
+      "",
+      '        logger.info("Done.")',
+      "",
+      "    except KeyboardInterrupt:",
+      '        logger.info("Interrupted by user")',
+      "        sys.exit(130)",
+      "    except Exception as e:",
+      '        logger.exception(f"Fatal error: {e}")',
+      "        sys.exit(1)",
+      "",
+      "",
+      'if __name__ == "__main__":',
+      "    main()",
+    ].join("\n");
+  },
+};

package/Skills/templates/react-component.cjs

@@ -0,0 +1,71 @@
+/**
+ * React 函数组件模版 — TypeScript + Hooks
+ */
+module.exports = {
+  description: "React 函数组件 (TypeScript + Hooks + Props)",
+  category: "react",
+  params: {
+    name: "组件名 (PascalCase), 如 'UserCard'",
+    props: "Props 定义, 如 'title:string,count:number'",
+    useState: "state 变量, 逗号分隔",
+    useEffect: "useEffect 依赖",
+  },
+  generate: function (params) {
+    var name = params.name || "MyComponent";
+    var propsDef = params.props || "";
+    var states = params.useState ? params.useState.split(",").map(function (s) { return s.trim(); }) : [];
+    var hasEffect = !!params.useEffect;
+    var effectDep = params.useEffect || "";
+
+    var lines = ["import React" + (states.length > 0 ? ", { useState" + (hasEffect ? ", useEffect" : "") + " }" : "") + " from 'react';"];
+
+    // Props interface
+    if (propsDef) {
+      lines.push("");
+      lines.push("interface " + name + "Props {");
+      propsDef.split(",").forEach(function (p) {
+        var parts = p.split(":").map(function (s) { return s.trim(); });
+        lines.push("  " + parts[0] + (parts[1] ? ": " + parts[1] : ": any") + ";");
+      });
+      lines.push("}");
+    }
+
+    // Destructure props
+    var propsKeys = propsDef ? propsDef.split(",").map(function (p) { return p.split(":")[0].trim(); }) : [];
+    var propsDestruct = propsKeys.length > 0 ? "{ " + propsKeys.join(", ") + " }" : "";
+
+    var compType = propsDef ? "React.FC<" + name + "Props>" : "React.FC";
+
+    lines.push("");
+    lines.push("export const " + name + ": " + compType + " = (" + propsDestruct + ") => {");
+
+    // State declarations
+    if (states.length > 0) {
+      states.forEach(function (s) {
+        var cap = s.charAt(0).toUpperCase() + s.slice(1);
+        var type = s === "loading" ? "boolean" : s === "error" ? "string | null" : "any";
+        lines.push("  const [" + s + ", set" + cap + "] = useState<" + type + ">(null);");
+      });
+    }
+
+    // useEffect
+    if (hasEffect) {
+      lines.push("");
+      lines.push("  useEffect(function () {");
+      lines.push("    // 当 " + effectDep + " 变化时执行");
+      lines.push("  }, [" + effectDep.split(",").map(function (s) { return s.trim(); }).join(", ") + "]);");
+    }
+
+    lines.push("");
+    lines.push("  return (");
+    lines.push("    <div className=\"" + name.toLowerCase() + "\">");
+    lines.push("      {/* TODO: 组件内容 */}");
+    lines.push("    </div>");
+    lines.push("  );");
+    lines.push("};");
+    lines.push("");
+    lines.push("export default " + name + ";");
+
+    return lines.join("\n");
+  },
+};

package/Skills/templates/test-jest.cjs

@@ -0,0 +1,41 @@
+/**
+ * Jest 测试模版
+ */
+module.exports = {
+  description: "Jest 测试文件 (describe/it/beforeEach)",
+  category: "testing",
+  params: {
+    module: "被测试模块路径, 如 '../src/utils'",
+    functions: "导出函数, 逗号分隔, 如 'parse,validate'",
+  },
+  generate: function (params) {
+    var modulePath = params.module || "../src/module";
+    var funcs = params.functions ? params.functions.split(",").map(function (s) { return s.trim(); }) : ["myFunction"];
+
+    var lines = [
+      "const { " + funcs.join(", ") + " } = require('" + modulePath + "');",
+      "",
+    ];
+
+    funcs.forEach(function (fn) {
+      lines.push("describe('" + fn + "', function () {");
+      lines.push("  it('should return expected value for valid input', function () {");
+      lines.push("    const result = " + fn + "(/* valid input */);");
+      lines.push("    expect(result).toBeDefined();");
+      lines.push("  });");
+      lines.push("");
+      lines.push("  it('should handle edge case: null input', function () {");
+      lines.push("    expect(function () { " + fn + "(null); }).toThrow();");
+      lines.push("  });");
+      lines.push("");
+      lines.push("  it('should handle edge case: empty input', function () {");
+      lines.push("    const result = " + fn + "(/* empty input */);");
+      lines.push("    // TODO: define expected behavior");
+      lines.push("  });");
+      lines.push("});");
+      lines.push("");
+    });
+
+    return lines.join("\n");
+  },
+};

package/Skills/test_first.cjs

@@ -0,0 +1,45 @@
+/**
+ * 测试驱动开发技能 — 红→绿→重构
+ */
+module.exports = {
+  description: "测试驱动开发(TDD): 先写失败的测试, 再写最小实现, 最后重构. 严格红→绿→重构循环",
+  category: "development",
+  trigger: "用户说 '写一个函数'/'实现'/'开发' 时使用; 写新模块时使用",
+  instructions: `
+严格遵循 RED → GREEN → REFACTOR 三步循环。不允许跳过任何步骤。
+
+【RED — 写失败的测试】
+- 先确定函数的输入/输出规格
+- 写一个测试用例，描述期望行为
+- 运行测试，确认它失败（红灯）
+- 如果测试直接通过，说明测试写得不对或功能已存在
+
+【GREEN — 最小实现】
+- 写刚好让测试通过的最少代码
+- 不要"顺便"加功能——只满足当前测试
+- 运行测试，确认通过（绿灯）
+- 如果没通过，只看测试输出，不要猜
+
+【REFACTOR — 重构】
+- 绿灯后才能重构
+- 消除重复、改善命名、提取函数
+- 每次重构后立即运行测试
+- 红灯出现说明重构引入 bug，立即回退
+`,
+  workflow: [
+    "确定函数签名和预期行为",
+    "写测试文件，覆盖正常输入+边界条件",
+    "运行测试确认 RED（失败）",
+    "写最小实现代码确保测试通过",
+    "运行测试确认 GREEN",
+    "重构代码改善质量",
+    "再次运行测试确认仍然 GREEN",
+    "报告: RED→GREEN→REFACTOR 完成",
+  ],
+  pitfalls: [
+    "绝对禁止先写实现后补测试",
+    "测试必须包含边界条件（null/空/极值）",
+    "最小实现就是最小——不要额外功能",
+    "重构必须在绿灯下进行",
+  ],
+};

package/Src/index.jsx

@@ -22,7 +22,7 @@ const CLINN_CONFIG = path.join(CLINN_DIR, "config.json");
 const PKG_CONFIG = path.join(__dirname, "..", "config.json");
 const LOGO_PATH = path.join(__dirname, "..", "Logos", "StartLogo.txt");
 
-const VER = "0.8.5";
+const VER = "0.8.7";
 
 function ensureDir() { if (!fs.existsSync(CLINN_DIR)) fs.mkdirSync(CLINN_DIR, { recursive: true }); }
 function loadConfig() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghenya/clinn",
-  "version": "0.8.5",
+  "version": "0.8.7",
   "description": "终端原生 AI 编程助手 — DeepSeek 驱动，50+ 工具，对话记忆，虚拟浏览器，Ink 全屏界面",
   "main": "Src/index.jsx",
   "bin": {
@@ -11,6 +11,7 @@
     "Tools/",
     "Mem/",
     "Logos/",
+    "Skills/",
     "bin/",
     "config.json",
     "README.md",