neo-skill 0.1.11 → 0.1.13

package/README.md

@@ -2,16 +2,48 @@
 
 一个确定性的 **skill-creator** 仓库。
 
-**GitHub**: https://github.com/liuminxin45/neo-skill
+**GitHub**: https://github.com/liuminxin45/neo-skill  
+**npm**: https://www.npmjs.com/package/neo-skill
 
 ## 安装
 
 ```bash
-# 全局安装
+# 通过 npm 安装（推荐）
 npm install -g neo-skill
+
+# 或通过 pip 安装
+pip install neo-skill
 ```
 
-**前置依赖**：需要安装 Python 3.8+（命令行执行依赖 Python）
+**前置依赖**：需要安装 Python 3.8+
+
+## 使用方式
+
+### 命令行工具（安装后）
+
+```bash
+# 初始化技能
+omni-skill init --ai claude
+
+# 生成技能输出
+skill-creator generate skills/skill-name/skillspec.json
+
+# 验证技能
+skill-creator validate skills/skill-name/skillspec.json
+```
+
+### 直接运行 Python 模块（开发模式）
+
+```bash
+# 初始化技能
+python -m omni_skill.cli init --ai claude
+
+# 生成技能输出
+python -m skill_creator.cli generate skills/skill-name/skillspec.json
+
+# 验证技能
+python -m skill_creator.cli validate skills/skill-name/skillspec.json
+```
 
 ## 功能说明
 - 使用 canonical `skills/<skill>/skillspec.json` 作为单一真源（single source of truth）
@@ -38,64 +70,35 @@ npm install -g neo-skill
 
 ### 典型使用场景
 
-**场景 1：在 neo-skill 仓库内开发/维护 skill**
+### 使用场景
+
+**初始化技能文件**
 ```bash
-# 从仓库根目录执行，初始化指定 AI 助手的技能文件
+# 初始化指定 AI 助手的技能文件
 omni-skill init --ai claude
 omni-skill init --ai windsurf
 omni-skill init --ai all  # 初始化所有支持的 AI 助手
-```
 
-**场景 2：在 neo-skill 仓库内更新并重新生成所有 IDE 入口文件**
-在 neo-skill 仓库根目录执行：
-
-```bash
+# 更新（基于上次 init 的配置）
 omni-skill update
 ```
 
-行为说明：
-- 根据上次 init 时保存的 AI 目标，重新同步/生成所有入口文件
-
-**场景 3：在其他项目中使用 neo-skill 的 skill**
-将 neo-skill 仓库克隆到你的项目中（例如 `vendor/neo-skill/`），然后根据你使用的 IDE，复制对应的入口文件到项目根目录：
-- **Windsurf**：复制 `.windsurf/workflows/<skill>.md` 和 `.windsurf/workflows/data/`
-- **Cursor**：复制 `.cursor/commands/<skill>.md`
-- **Claude Desktop**：复制 `.claude/skills/<skill>/`
-- **GitHub / VS Code Skills**：复制 `.github/skills/<skill>/`
-
-### 推荐用法
-
+**生成和验证技能**
 ```bash
-# 初始化指定 AI 助手
-omni-skill init --ai claude
-omni-skill init --ai windsurf --ai cursor  # 可指定多个
+# 生成技能输出
+skill-creator generate skills/skill-name/skillspec.json
 
-# 初始化所有支持的 AI 助手
-omni-skill init --ai all
+# 验证技能
+skill-creator validate skills/skill-name/skillspec.json
 
-# 更新（基于上次 init 的配置）
-omni-skill update
+# 打包 Claude 技能
+skill-creator package --target claude --skill skill-name
 ```
 
-### 关于 npm 安装后的 init 行为
-
-当你通过 `npm install -g neo-skill` 安装后：
-
-- **命令来源**：`omni-skill` 和 `skill-creator` 命令来自全局 npm 包（内部调用 Python）
-- **同步内容**：`omni-skill init` 会把包内的技能/资源内容同步到当前项目目录（覆盖式同步）：
-  - `skills/`
-  - `.shared/skill-creator/`
-  - 以及指定 AI 对应的目录（如 `.claude/skills/`、`.windsurf/workflows/` 等）
-
-**核心行为：**
-- 根据 `--ai` 参数生成对应 IDE 的入口文件
-- 不同 IDE 可以共存，切换 IDE 时无需重新生成
-- 生成的文件都是从 canonical `skills/<skill>/skillspec.json` 渲染而来
-
-**参数说明：**
-- `init`：初始化技能文件
-- `update`：基于上次 init 保存的配置重新同步
-- `--ai <target>`：指定目标 AI 助手（可重复使用）
+**在其他项目中使用**
+将 neo-skill 仓库克隆到你的项目中（例如 `vendor/neo-skill/`），然后：
+1. 设置 PYTHONPATH：`export PYTHONPATH=$PWD/vendor/neo-skill/src:$PYTHONPATH`
+2. 运行命令：`omni-skill init --ai claude`
 
 **支持的 AI 助手：**
 claude, cursor, windsurf, antigravity, copilot, kiro, codex, qoder, roocode, gemini, trae, opencode, continue, all

package/package.json

@@ -1,14 +1,10 @@
 {
   "name": "neo-skill",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "A multi-assistant skill generator (Claude/Windsurf/Cursor/GitHub Skills) driven by a canonical SkillSpec.",
   "license": "MIT",
-  "bin": {
-    "omni-skill": "bin/omni-skill.js",
-    "skill-creator": "bin/skill-creator.js"
-  },
+  "main": "src/skill_creator/__init__.py",
   "files": [
-    "bin/**",
     "src/**",
     "skills/**",
     ".shared/**",
@@ -16,9 +12,12 @@
     ".windsurf/**",
     ".cursor/**",
     ".github/skills/**",
-    "README.md"
+    "README.md",
+    "pyproject.toml"
   ],
-  "scripts": {},
+  "scripts": {
+    "postinstall": "pip install -e . 2>/dev/null || python -m pip install -e . 2>/dev/null || echo 'Warning: Python package installation failed. Please run: pip install neo-skill'"
+  },
   "engines": {
     "node": ">=16"
   }

package/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=56"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "neo-skill"
+dynamic = ["version"]
+description = "A multi-assistant skill generator (Claude/Windsurf/Cursor/GitHub Skills) driven by a canonical SkillSpec."
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "skill-creator"}]
+
+[project.scripts]
+omni-skill = "omni_skill.cli:main"
+skill-creator = "skill_creator.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = {attr = "skill_creator.__version__"}
+

package/skills/review-gate/skillspec.json

@@ -2,8 +2,7 @@
   "version": 1,
   "name": "review-gate",
   "description": "为 TypeScript/JavaScript（React/Vue/Node）项目建立架构与工程化 Review 规范：明确分层职责边界、模块 API 设计、副作用隔离、复杂度与可读性、错误处理策略等，提供可执行的 PR Review Checklist，防止架构在长期演进中"慢慢写歪"。",
-  "assistants": ["claude", "windsurf", "cursor", "github-skills"],
-  "questions": [
+    "questions": [
     "你的仓库采用什么分层模型（type-first / feature-first / 其他），现有层级命名是什么？",
     "是否已有明确的架构/工程规范文档，或仅依靠口头约定？",
     "PR Review 流程是什么（必须至少 1 人 approve / 需要架构师 review / 其他）？",

package/src/skill_creator/__init__.py

@@ -1 +1,6 @@
-__version__ = "0.1.11"
+import json
+from pathlib import Path
+
+# Read version from package.json (single source of truth)
+_pkg_json = Path(__file__).parent.parent.parent / "package.json"
+__version__ = json.loads(_pkg_json.read_text())["version"]

package/bin/omni-skill.js

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require("child_process");
-const path = require("path");
-
-function main() {
-  const pkgRoot = path.resolve(__dirname, "..");
-  const pySrc = path.join(pkgRoot, "src");
-
-  const env = { ...process.env };
-  env.PYTHONPATH = env.PYTHONPATH ? `${pySrc}${path.delimiter}${env.PYTHONPATH}` : pySrc;
-
-  const baseArgs = ["-m", "omni_skill.cli", ...process.argv.slice(2)];
-
-  const candidates = [];
-  if (env.OMNI_SKILL_PYTHON) {
-    candidates.push({ cmd: env.OMNI_SKILL_PYTHON, extraArgs: [] });
-  }
-  if (process.platform === "win32") {
-    candidates.push({ cmd: "python", extraArgs: [] });
-    candidates.push({ cmd: "python3", extraArgs: [] });
-    candidates.push({ cmd: "py", extraArgs: ["-3"] });
-  } else {
-    candidates.push({ cmd: "python3", extraArgs: [] });
-    candidates.push({ cmd: "python", extraArgs: [] });
-  }
-
-  let lastError = null;
-  for (const c of candidates) {
-    const r = spawnSync(c.cmd, [...c.extraArgs, ...baseArgs], { stdio: "inherit", env });
-    if (r.error) {
-      lastError = r.error;
-      const msg = String(r.error.message || "").toLowerCase();
-      if (msg.includes("enoent")) {
-        continue;
-      }
-      console.error(r.error);
-      process.exit(1);
-    }
-    if (typeof r.status === "number" && r.status === 9009) {
-      continue;
-    }
-    process.exit(r.status == null ? 1 : r.status);
-  }
-
-  console.error(
-    "Python not found. Please install Python 3 and ensure 'python' works, or set OMNI_SKILL_PYTHON to your interpreter path.",
-  );
-  if (lastError) {
-    console.error(lastError);
-  }
-  process.exit(127);
-}
-
-main();

package/bin/skill-creator.js

@@ -1,55 +0,0 @@
-#!/usr/bin/env node
-
-const { spawnSync } = require("child_process");
-const path = require("path");
-
-function main() {
-  const pkgRoot = path.resolve(__dirname, "..");
-  const pySrc = path.join(pkgRoot, "src");
-
-  const env = { ...process.env };
-  env.PYTHONPATH = env.PYTHONPATH ? `${pySrc}${path.delimiter}${env.PYTHONPATH}` : pySrc;
-
-  const baseArgs = ["-m", "skill_creator.cli", ...process.argv.slice(2)];
-
-  const candidates = [];
-  if (env.OMNI_SKILL_PYTHON) {
-    candidates.push({ cmd: env.OMNI_SKILL_PYTHON, extraArgs: [] });
-  }
-  if (process.platform === "win32") {
-    candidates.push({ cmd: "python", extraArgs: [] });
-    candidates.push({ cmd: "python3", extraArgs: [] });
-    candidates.push({ cmd: "py", extraArgs: ["-3"] });
-  } else {
-    candidates.push({ cmd: "python3", extraArgs: [] });
-    candidates.push({ cmd: "python", extraArgs: [] });
-  }
-
-  let lastError = null;
-  for (const c of candidates) {
-    const r = spawnSync(c.cmd, [...c.extraArgs, ...baseArgs], { stdio: "inherit", env });
-    if (r.error) {
-      lastError = r.error;
-      const msg = String(r.error.message || "").toLowerCase();
-      if (msg.includes("enoent")) {
-        continue;
-      }
-      console.error(r.error);
-      process.exit(1);
-    }
-    if (typeof r.status === "number" && r.status === 9009) {
-      continue;
-    }
-    process.exit(r.status == null ? 1 : r.status);
-  }
-
-  console.error(
-    "Python not found. Please install Python 3 and ensure 'python' works, or set OMNI_SKILL_PYTHON to your interpreter path.",
-  );
-  if (lastError) {
-    console.error(lastError);
-  }
-  process.exit(127);
-}
-
-main();