psmgr 1.0.0

package/.agents/skills-config.template.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://raw.githubusercontent.com/JiunianTV/Le-Skills/main/.agents/skills-registry.schema.json",
+  "version": "1.0.0",
+  "description": "项目自定义技能配置 — 覆盖/扩展 skills-registry.json 的全局设置",
+  "customSources": [
+    {
+      "name": "my-team-skills",
+      "url": "https://github.com/myorg/team-skills",
+      "ref": "main",
+      "description": "团队私有技能集",
+      "filter": "always",
+      "skills": [
+        "my-standards",
+        "my-deployment"
+      ],
+      "tags": ["team", "private"]
+    }
+  ],
+  "ignore": [],
+  "alwaysInstall": []
+}

package/.agents/skills-registry.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "https://raw.githubusercontent.com/JiunianTV/Le-Skills/main/.agents/skills-registry.schema.json",
+  "version": "1.0.0",
+  "description": "PSM 技能注册中心 — 定义可安装的技能来源和过滤规则",
+  "sources": [
+    {
+      "name": "superpowers",
+      "url": "https://github.com/obra/superpowers",
+      "ref": "main",
+      "description": "通用工程技能集：TDD、系统调试、验证循环等",
+      "filter": "always",
+      "skills": [
+        "test-driven-development",
+        "systematic-debugging",
+        "verification-loop",
+        "flatten-with-flags",
+        "condition-based-waiting"
+      ],
+      "tags": ["engineering", "general", "debugging", "testing"]
+    },
+    {
+      "name": "karpathy",
+      "url": "https://github.com/multica-ai/andrej-karpathy-skills",
+      "ref": "main",
+      "description": "Karpathy 工程方法论：工程规范、调试、架构",
+      "filter": "always",
+      "skills": [
+        "karpathy-engineering",
+        "karpathy-debugging",
+        "karpathy-architecture"
+      ],
+      "tags": ["engineering", "discipline", "architecture"]
+    },
+    {
+      "name": "ecc",
+      "url": "https://github.com/affaan-m/ECC",
+      "ref": "main",
+      "description": "框架级前端/后端技能：React、Vue、Jest、Cypress 等",
+      "filter": "tech-stack",
+      "match": {
+        "files": ["package.json"],
+        "dependencies": ["react", "vue", "next", "nuxt"]
+      },
+      "skills": [
+        "frontend-react",
+        "frontend-vue",
+        "testing-cypress",
+        "testing-jest",
+        "api-client",
+        "state-management"
+      ],
+      "tags": ["frontend", "react", "vue", "testing"]
+    },
+    {
+      "name": "impeccable",
+      "url": "https://github.com/pbakaus/impeccable",
+      "ref": "main",
+      "description": "高质量代码审查与 UI 设计技能",
+      "filter": "tech-stack",
+      "match": {
+        "files": ["package.json"],
+        "dependencies": ["react", "vue", "angular", "svelte"]
+      },
+      "skills": [
+        "impeccable-code-review",
+        "impeccable-ui"
+      ],
+      "tags": ["code-review", "ui", "frontend"]
+    },
+    {
+      "name": "taste-skill",
+      "url": "https://github.com/Leonxlnx/taste-skill",
+      "ref": "main",
+      "description": "设计品味与前端美学技能",
+      "filter": "tech-stack",
+      "match": {
+        "files": ["package.json"],
+        "dependencies": ["react", "vue", "angular", "svelte"]
+      },
+      "skills": [
+        "taste-frontend",
+        "taste-design"
+      ],
+      "tags": ["design", "ui", "frontend", "ux"]
+    },
+    {
+      "name": "gitnexus",
+      "url": "https://github.com/abhigyanpatwari/GitNexus",
+      "ref": "main",
+      "description": "Git 代码智能：blame、日志分析、变更影响",
+      "filter": "always",
+      "selfManaged": true,
+      "skills": [],
+      "tags": ["git", "intelligence", "analysis"]
+    },
+    {
+      "name": "codegraph",
+      "url": "https://github.com/colbymchenry/codegraph",
+      "ref": "main",
+      "description": "符号搜索、调用图、影响分析",
+      "filter": "always",
+      "selfManaged": true,
+      "skills": [],
+      "tags": ["code-analysis", "graph", "dependency"]
+    }
+  ],
+  "customSources": {
+    "description": "用户可在此添加自定义技能源。安装时此文件不会被覆盖。",
+    "hint": "在项目根目录创建 .agents/skills-config.json 覆盖此列表"
+  },
+  "tools": {
+    "description": "技能依赖的工具定义 — CLI 和 MCP 两种安装方式",
+    "items": [
+      {
+        "name": "codegraph",
+        "description": "代码图谱：符号搜索、调用图、影响分析",
+        "homepage": "https://github.com/colbymchenry/codegraph",
+        "checkCommand": "codegraph --version 2>/dev/null || echo 'not-found'",
+        "commands": [
+          { "cmd": "codegraph query", "description": "查询代码符号和关系" },
+          { "cmd": "codegraph explore", "description": "交互式浏览代码图谱" },
+          { "cmd": "codegraph index", "description": "索引当前项目的代码图谱" },
+          { "cmd": "codegraph sync", "description": "同步代码变更到图谱" },
+          { "cmd": "codegraph install", "description": "安装/配置 MCP 服务器" }
+        ],
+        "cli": {
+          "description": "安装脚本（推荐，无需 Node.js）或 npm 全局安装",
+          "commands": [
+            "curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh",
+            "npm i -g @colbymchenry/codegraph"
+          ],
+          "postInstall": "codegraph install"
+        },
+        "mcp": {
+          "description": "运行 codegraph install 自动配置当前 IDE 的 MCP",
+          "autoSetup": true,
+          "note": "支持 Claude Code / Cursor / Windsurf / Codex CLI 等"
+        },
+        "tags": ["code-analysis", "graph", "search"]
+      },
+      {
+        "name": "gitnexus",
+        "description": "Git 代码智能：blame、日志分析、变更影响",
+        "homepage": "https://github.com/abhigyanpatwari/GitNexus",
+        "checkCommand": "gitnexus --version 2>/dev/null || echo 'not-found'",
+        "commands": [
+          { "cmd": "gitnexus analyze", "description": "分析仓库并生成代码知识图谱" },
+          { "cmd": "gitnexus blame", "description": "追查代码行变更历史" },
+          { "cmd": "gitnexus log", "description": "查看 Git 提交日志" },
+          { "cmd": "gitnexus diff", "description": "显示变更差异" },
+          { "cmd": "gitnexus setup", "description": "配置 IDE MCP 集成" }
+        ],
+        "cli": {
+          "description": "npm 全局安装",
+          "commands": [
+            "npm install -g gitnexus@latest"
+          ],
+          "postInstall": "gitnexus setup"
+        },
+        "mcp": {
+          "description": "通过 npx 启动 MCP 服务器，自动配置到 IDE",
+          "config": {
+            "command": "npx",
+            "args": ["-y", "gitnexus@latest", "mcp"]
+          },
+          "note": "支持 Claude Code / Cursor / Windsurf 等"
+        },
+        "tags": ["git", "intelligence", "analysis"]
+      }
+    ]
+  }
+}

package/.agents/tools.json

@@ -0,0 +1,70 @@
+{
+  "codegraph": {
+    "installed": true,
+    "mode": "cli",
+    "version": "1.0.1",
+    "path": "D:\\nodejs\\node_global\\codegraph\r",
+    "commands": [
+      {
+        "cmd": "codegraph query",
+        "description": "查询代码符号和关系",
+        "verified": true
+      },
+      {
+        "cmd": "codegraph explore",
+        "description": "交互式浏览代码图谱",
+        "verified": true
+      },
+      {
+        "cmd": "codegraph index",
+        "description": "索引当前项目的代码图谱",
+        "verified": true
+      },
+      {
+        "cmd": "codegraph sync",
+        "description": "同步代码变更到图谱",
+        "verified": true
+      },
+      {
+        "cmd": "codegraph install",
+        "description": "安装/配置 MCP 服务器",
+        "verified": true
+      }
+    ],
+    "verifiedAt": "2026-06-17T19:36:14.315Z"
+  },
+  "gitnexus": {
+    "installed": true,
+    "mode": "cli",
+    "version": "1.6.5",
+    "path": "D:\\nodejs\\node_global\\gitnexus\r",
+    "commands": [
+      {
+        "cmd": "gitnexus analyze",
+        "description": "分析仓库并生成代码知识图谱",
+        "verified": true
+      },
+      {
+        "cmd": "gitnexus blame",
+        "description": "追查代码行变更历史",
+        "verified": true
+      },
+      {
+        "cmd": "gitnexus log",
+        "description": "查看 Git 提交日志",
+        "verified": true
+      },
+      {
+        "cmd": "gitnexus diff",
+        "description": "显示变更差异",
+        "verified": true
+      },
+      {
+        "cmd": "gitnexus setup",
+        "description": "配置 IDE MCP 集成",
+        "verified": true
+      }
+    ],
+    "verifiedAt": "2026-06-17T19:36:15.974Z"
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 JiunianTV
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,133 @@
+# PSMgr (Project Skills Manager)
+
+[![npm version](https://img.shields.io/npm/v/psmgr?color=blue)](https://www.npmjs.com/package/psmgr)
+[![npm downloads](https://img.shields.io/npm/dm/psmgr?color=blue)](https://www.npmjs.com/package/psmgr)
+[![license](https://img.shields.io/npm/l/psmgr?color=green)](LICENSE)
+
+> **PSMgr** = **P**roject **S**kills **M**anager — AI Agent 技能与规则管理工具。
+一行命令安装到任何项目，自动匹配技术栈、生成规则文件。
+
+---
+
+## 快速安装
+
+```bash
+npx psmgr install
+```
+
+安装到其他目录：
+
+```bash
+npx psmgr install ../my-project
+```
+
+## CLI 命令参考
+
+| 命令 | 作用 |
+|------|------|
+| `npx psmgr install [-y] [target]` | 安装技能和规则到目标项目 |
+| `npx psmgr check [target]` | 检测安装状态并展示报告 |
+| `npx psmgr info [target]` | 显示版本、环境、安装详情 |
+| `npx psmgr list` | 显示当前包中包含的技能清单 |
+| `npx psmgr outdated` | 检查 npm 是否有新版本 |
+| `npx psmgr update` | 自更新到最新版本 |
+| `npx psmgr version` | 显示版本号 |
+| `npx psmgr help` | 显示帮助 |
+
+### 选项
+
+| 选项 | 说明 |
+|------|------|
+| `-y, --yes` | 静默模式，覆盖已安装的内容（用于 CI/脚本） |
+
+## 安装到项目（其他方式）
+
+### 方式一：npx（推荐）
+
+```bash
+npx psmgr install
+```
+
+无需全局安装，零依赖，自动下载并运行。
+
+### 方式二：Git 子目录复制
+
+```bash
+git clone --depth 1 https://github.com/JiunianTV/Le-Skills.git .psm-tmp
+cp -r .psm-tmp/.agents ./your-project/
+cp -r .psm-tmp/scripts ./your-project/
+rm -rf .psm-tmp
+```
+
+### 方式三：Git subtree（跟踪上游更新）
+
+```bash
+git subtree add --prefix=.psm \
+  https://github.com/JiunianTV/Le-Skills.git main --squash
+ln -sf .psm/.agents .agents
+ln -sf .psm/scripts scripts
+```
+
+## 安装后的下一步
+
+```bash
+# 1. 运行检测脚本
+bash scripts/bootstrap.sh
+
+# 2. 在 IDE 中输入以下指令：
+#    「安装技能和规则」  — 首次安装/配置
+#    「更新技能和规则」  — 升级已有技能
+#    「卸载技能 xxx」    — 移除指定技能
+#    「查看技能」        — 查看技能状态
+#    「更新更新日志为 v1.0.0」 — 生成 CHANGELOG
+```
+
+## 目录结构
+
+```
+PSM/
+├── bin/
+│   └── psm.js              # CLI 入口（npm 发布）
+├── .agents/
+│   ├── skills/                   # 规范化技能（每个 SKILL.md 含 YAML frontmatter）
+│   │   ├── INDEX.md              # 技能清单
+│   │   ├── managing-project-skills/
+│   │   ├── installing-project-skills/
+│   │   ├── scheduling-project-skills/
+│   │   └── generating-changelogs/
+│   └── rules/                    # 按需加载的规则
+│       ├── project-rules.md      # 全量加载 — 通用规范
+│       ├── skill-lifecycle-rules.md
+│       ├── skill-scheduling-rules.md
+│       └── changelog-rules.md
+├── scripts/
+│   └── bootstrap.sh              # 自举检测脚本
+├── prompt/                       # 完整版提示词（源文档）
+│   ├── Flight-Translator.md
+│   └── Project-Skills-Manager.md
+└── package.json
+```
+
+## 规则加载机制
+
+| 规则文件 | 加载方式 | 触发场景 |
+|---------|---------|---------|
+| `project-rules.md` | 全量加载 | 每次对话自动注入 |
+| `skill-lifecycle-rules.md` | 按需 | 用户说安装/升级/卸载技能时 |
+| `skill-scheduling-rules.md` | 按需 | 技能执行任务时 |
+| `changelog-rules.md` | 按需 | 用户说更新更新日志时 |
+
+## CI 集成
+
+```yaml
+# .github/workflows/check-skills.yml
+steps:
+  - run: npx psmgr check   # 使用 npx
+  - run: bash scripts/bootstrap.sh --check  # 或直接使用脚本
+```
+
+技能未安装时 exit 1，已就绪 exit 0。
+
+## 开源协议
+
+MIT