psmgr 1.0.0

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "psmgr",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "PSMgr (Project Skills Manager) — one command to install AI agent skills & rules into any project",
+  "keywords": [
+    "psmgr",
+    "psm",
+    "project-skills-manager",
+    "ai-skills",
+    "project-skills",
+    "agent-skills",
+    "claude-skills",
+    "cursor-skills",
+    "windsurf-skills",
+    "skills-manager",
+    "bootstrap",
+    "agent-rules"
+  ],
+  "homepage": "https://github.com/JiunianTV/Le-Skills",
+  "bugs": {
+    "url": "https://github.com/JiunianTV/Le-Skills/issues"
+  },
+  "license": "MIT",
+  "author": "JiunianTV",
+  "bin": {
+    "psm": "bin/psm.js"
+  },
+  "files": [
+    "bin/",
+    ".agents/",
+    "scripts/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "bootstrap": "node scripts/bootstrap.js",
+    "bootstrap:check": "node scripts/bootstrap.js --check"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JiunianTV/Le-Skills.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/bootstrap.js

@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+// ============================================================
+// bootstrap.js — Cross-platform project detection & guidance
+// ============================================================
+//   node scripts/bootstrap.js          Detection + guidance
+//   node scripts/bootstrap.js --check  Just check status, exit 0/1
+// ============================================================
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const ROOT_DIR = path.resolve(__filename, '../..');
+
+// ---- Colour helpers ----
+
+function colour(code, text) {
+  return process.stdout.isTTY ? `\x1b[${code}m${text}\x1b[0m` : text;
+}
+
+const info = (s) => console.log(colour('0;36', `ℹ ${s}`));
+const ok = (s) => console.log(colour('0;32', `✔ ${s}`));
+const warn = (s) => console.log(colour('1;33', `⚡ ${s}`));
+const err = (s) => console.log(colour('0;31', `✘ ${s}`));
+
+// ---- Detection ----
+
+function detectProjectType() {
+  if (fs.existsSync(path.join(ROOT_DIR, 'package.json'))) return 'node';
+  if (fs.existsSync(path.join(ROOT_DIR, 'pyproject.toml'))) return 'python';
+  if (fs.existsSync(path.join(ROOT_DIR, 'requirements.txt'))) return 'python';
+  if (fs.existsSync(path.join(ROOT_DIR, 'Cargo.toml'))) return 'rust';
+  if (fs.existsSync(path.join(ROOT_DIR, 'go.mod'))) return 'go';
+  return 'unknown';
+}
+
+function checkSkillsStatus() {
+  const skillsDir = path.join(ROOT_DIR, '.agents', 'skills');
+  const rulesDir = path.join(ROOT_DIR, '.agents', 'rules');
+
+  if (!fs.existsSync(skillsDir)) return 'no-skills-dir';
+  if (!fs.existsSync(path.join(skillsDir, 'INDEX.md'))) return 'no-index';
+
+  const count = fs.readdirSync(skillsDir).filter((e) => {
+    const skillMd = path.join(skillsDir, e, 'SKILL.md');
+    return fs.statSync(path.join(skillsDir, e)).isDirectory() && fs.existsSync(skillMd);
+  }).length;
+
+  if (count === 0) return 'empty';
+
+  // Check rules
+  const rulesCount = fs.existsSync(rulesDir)
+    ? fs.readdirSync(rulesDir).filter((f) => f.endsWith('.md')).length
+    : 0;
+
+  return { count, rulesCount };
+}
+
+const PROJECT_LABELS = {
+  node: 'Node.js / Frontend',
+  python: 'Python',
+  rust: 'Rust',
+  go: 'Go',
+  unknown: '未能自动识别',
+};
+
+// ---- Print guidance ----
+
+function printGuidance(projectType, skillsStatus) {
+  console.log();
+  console.log('============================================');
+  console.log('  Project Skills — Bootstrap Report');
+  console.log('============================================');
+  console.log();
+
+  // Project type
+  const label = PROJECT_LABELS[projectType] || projectType;
+  if (projectType === 'unknown') {
+    warn(`项目类型: ${label}（未找到 package.json/pyproject.toml/Cargo.toml/go.mod）`);
+  } else {
+    ok(`项目类型: ${label}`);
+  }
+
+  console.log();
+
+  // Skills status
+  if (typeof skillsStatus === 'string') {
+    switch (skillsStatus) {
+      case 'no-skills-dir':
+        warn('技能尚未安装');
+        info('解决方案: 在 IDE 中打开项目，输入「安装技能和规则」即可自动配置');
+        break;
+      case 'no-index':
+      case 'empty':
+        warn('技能目录存在但尚未完成安装');
+        info('解决方案: 在 IDE 中打开项目，输入「安装技能和规则」即可自动安装');
+        break;
+    }
+  } else {
+    ok(`已安装 ${skillsStatus.count} 个技能`);
+    ok(`${skillsStatus.rulesCount} 个规则文件`);
+    info('运行以下命令查看技能清单:');
+    console.log(`  dir ${ROOT_DIR}\\.agents\\skills\\`);
+    console.log();
+    info('如需更新技能，运行:');
+    console.log('  npx psmgr install --yes');
+  }
+
+  // IDE hints
+  console.log();
+  console.log('━━━ IDE 使用提示 ━━━');
+  console.log();
+  console.log('  支持的 IDE 命令:');
+  console.log('    「安装技能和规则」  — 首次安装/配置');
+  console.log('    「更新技能和规则」  — 升级已有技能');
+  console.log('    「卸载技能 xxx」    — 移除指定技能');
+  console.log('    「查看技能」        — 查看技能状态');
+  console.log('    「更新更新日志为 vx.x.x」 — 生成 CHANGELOG');
+  console.log();
+  console.log('━━━━━━━━━━━━━━━━━━');
+  console.log();
+}
+
+// ---- Main ----
+
+function main() {
+  const args = process.argv.slice(2);
+  const checkMode = args.includes('--check');
+
+  const projectType = detectProjectType();
+  const skillsStatus = checkSkillsStatus();
+
+  // --check mode: just exit with code
+  if (checkMode) {
+    if (typeof skillsStatus === 'string') {
+      process.exit(1);
+    }
+    process.exit(0);
+  }
+
+  printGuidance(projectType, skillsStatus);
+}
+
+main();

package/scripts/bootstrap.sh

@@ -0,0 +1,157 @@
+#!/usr/bin/env bash
+# ============================================================
+# Project Skills Bootstrap Script
+# ============================================================
+# Detects project type, checks skill installation status,
+# and guides the user to set up skills.
+#
+# Usage:
+#   bash scripts/bootstrap.sh          # Detection + guidance
+#   bash scripts/bootstrap.sh --check  # Just check status, exit 0/1
+# ============================================================
+# NOTE: A cross-platform Node.js version is also available:
+#   node scripts/bootstrap.js
+# ============================================================
+
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+
+# ---- Windows detection ----
+if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "cygwin" || -n "$WINDIR" ]]; then
+    echo ""
+    echo "============================================"
+    echo "  Windows detected"
+    echo "============================================"
+    echo ""
+    echo "  For better Windows support, use the Node.js version:"
+    echo "    node scripts/bootstrap.js"
+    echo ""
+    echo "  Or run this script with Git Bash / WSL."
+    echo ""
+fi
+
+# ---- Colour helpers ----
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+info()  { echo -e "${CYAN}ℹ${NC} $1"; }
+ok()    { echo -e "${GREEN}✔${NC} $1"; }
+warn()  { echo -e "${YELLOW}⚡${NC} $1"; }
+err()   { echo -e "${RED}✘${NC} $1"; }
+
+# ---- Detect project type ----
+detect_project_type() {
+    if [[ -f "$ROOT_DIR/package.json" ]]; then
+        echo "node"
+    elif [[ -f "$ROOT_DIR/pyproject.toml" ]]; then
+        echo "python"
+    elif [[ -f "$ROOT_DIR/requirements.txt" ]]; then
+        echo "python"
+    elif [[ -f "$ROOT_DIR/Cargo.toml" ]]; then
+        echo "rust"
+    elif [[ -f "$ROOT_DIR/go.mod" ]]; then
+        echo "go"
+    else
+        echo "unknown"
+    fi
+}
+
+# ---- Skill installation status ----
+check_skills_status() {
+    local skills_dir="$ROOT_DIR/.agents/skills"
+    local rules_dir="$ROOT_DIR/.agents/rules"
+
+    if [[ ! -d "$skills_dir" ]]; then
+        echo "no-skills-dir"
+    elif [[ ! -f "$skills_dir/INDEX.md" ]]; then
+        echo "no-index"
+    else
+        local count
+        count=$(find "$skills_dir" -maxdepth 2 -name "SKILL.md" 2>/dev/null | wc -l)
+        if [[ "$count" -eq 0 ]]; then
+            echo "empty"
+        else
+            echo "installed:$count"
+        fi
+    fi
+}
+
+# ---- Print guidance ----
+print_guidance() {
+    local project_type="$1"
+    local skills_status="$2"
+
+    echo ""
+    echo "============================================"
+    echo "  Project Skills — Bootstrap Report"
+    echo "============================================"
+    echo ""
+
+    # Project type
+    case "$project_type" in
+        node)    ok "项目类型: Node.js / Frontend" ;;
+        python)  ok "项目类型: Python" ;;
+        rust)    ok "项目类型: Rust" ;;
+        go)      ok "项目类型: Go" ;;
+        *)       warn "项目类型: 未能自动识别（未找到 package.json/pyproject.toml/Cargo.toml/go.mod）" ;;
+    esac
+
+    # Skills status
+    echo ""
+    case "$skills_status" in
+        no-skills-dir)
+            warn "技能尚未安装"
+            info "解决方案: 在 IDE 中打开项目，输入「安装技能和规则」即可自动配置"
+            ;;
+        no-index|empty)
+            warn "技能目录存在但尚未完成安装"
+            info "解决方案: 在 IDE 中打开项目，输入「安装技能和规则」即可自动安装"
+            ;;
+        installed:*)
+            local count="${skills_status#installed:}"
+            ok "已安装 ${count} 个技能"
+            info "查看技能清单:"
+            echo "  ls ${ROOT_DIR}/.agents/skills/"
+            info "如需更新技能，在 IDE 中输入「更新技能和规则」或运行:"
+            echo "  npx psmgr install --yes"
+            ;;
+    esac
+
+    # IDE hints
+    echo ""
+    echo "━━━ IDE 使用提示 ━━━"
+    echo ""
+    echo "  支持的 IDE 命令:"
+    echo "    「安装技能和规则」  — 首次安装/配置"
+    echo "    「更新技能和规则」  — 升级已有技能"
+    echo "    「卸载技能 xxx」    — 移除指定技能"
+    echo "    「查看技能」        — 查看技能状态"
+    echo "    「更新更新日志为 vx.x.x」 — 生成 CHANGELOG"
+    echo ""
+    echo "━━━━━━━━━━━━━━━━━━"
+    echo ""
+}
+
+# ---- Main ----
+main() {
+    local project_type
+    project_type=$(detect_project_type)
+
+    local skills_status
+    skills_status=$(check_skills_status)
+
+    # --check mode: just exit with status
+    if [[ "${1:-}" == "--check" ]]; then
+        case "$skills_status" in
+            no-skills-dir|no-index|empty) exit 1 ;;
+            *) exit 0 ;;
+        esac
+    fi
+
+    print_guidance "$project_type" "$skills_status"
+}
+
+main "$@"