psmgr 1.0.0

package/.agents/skills/INDEX.md

@@ -0,0 +1,160 @@
+# 技能树 INDEX
+
+> 🎯 **任何 AI Agent / AI IDE 的统一导航入口** — 安装后优先读取此文件了解技能结构
+> 由 psm install 自动生成 — 运行 `npx psm install --yes` 重新生成
+
+---
+
+## 🤖 Agent 使用协议
+
+任何 AI Agent 在加载本项目后，应按以下流程操作：
+
+```
+1. 读取本 INDEX.md ──────────────── 了解技能树结构和路由规则
+2. 根据用户输入 + 项目上下文 ─────── 匹配「导航指南」或「条件路由」表
+3. 加载对应的 L2 SKILL.md ───────── 技能文件含完整执行流程
+4. 多技能任务 → 加载 skill-scheduling-rules.md
+5. 执行完成 → 更新任务状态
+```
+
+**核心原则：** Agent 不应跳过技能树直接执行。先路由，再执行。
+
+---
+
+## 🌳 技能树总览
+
+```
+L0: managing-project-skills（根节点 — 用户入口）
+  │
+  ├── L1: 🔧 生命周期管理
+  │     └── L2: installing-project-skills — 安装/更新/卸载/查看技能
+  │
+  ├── L1: 📋 任务调度
+  │     └── L2: scheduling-project-skills — 技能编排/难度分级/场景映射
+  │
+  └── L1: 📦 版本发布
+        └── L2: generating-changelogs — 从 git commit 生成 CHANGELOG.md
+```
+
+---
+
+## 🧭 导航指南（按用户意图路由）
+
+### 流程：用户发来消息 → 匹配 L1 类别 → 加载 L2 技能
+
+| 用户说/场景 | → 匹配 L1 | → 加载 L2 技能 |
+|------------|----------|---------------|
+| "安装技能和规则" / "setup skills" | 🔧 生命周期管理 | `installing-project-skills` |
+| "更新/升级/卸载技能 xxx" | 🔧 生命周期管理 | `installing-project-skills` |
+| "查看技能" / "技能状态" | 🔧 生命周期管理 | `installing-project-skills` |
+| 多技能编排/判断难度/复杂任务 | 📋 任务调度 | `scheduling-project-skills` |
+| "更新更新日志为 vx.x.x" | 📦 版本发布 | `generating-changelogs` |
+| "版本管理" / "版本规范" | 📦 版本发布 | 检查 `version-management-rules.md` |
+
+---
+
+## 🔀 条件路由（按项目上下文路由）
+
+> 当用户意图不明确或涉及多个领域时，根据项目上下文自动选择路径。
+
+| 项目上下文 | 用户意图模糊时 → 默认路径 | 说明 |
+|-----------|------------------------|------|
+| 项目无 `.agents/skills/` | → 直接触发 `installing-project-skills` full-install | 首次配置 |
+| 项目有 `package.json` + React/Vue | → 优先路由到前端相关技能链 | 技术栈感知 |
+| 项目有 `Cargo.toml` | → 路由到 Rust 工程链 | 内存安全/并发 |
+| 项目有 `go.mod` | → 路由到 Go 微服务链 | 微服务/网络 |
+| 项目有 `requirements.txt` / `pyproject.toml` | → 路由到 Python 数据链 | 数据处理/ML |
+| 项目有 `package.json` + UI 框架 | → 额外评估前端设计技能（见 registry） | 设计技能匹配 |
+| 用户说"帮我看看这个项目" | → 先 `installing-project-skills` status check | 快速诊断 |
+| 错误信息中带有 stack trace | → 加载 `scheduling-project-skills` + 调试场景 | 异常处理 |
+
+> **优先级：** 条件路由 > 导航指南。即项目上下文匹配时优先走条件路由，否则根据用户意图走导航指南。
+
+---
+
+## 📂 文件索引
+
+| 文件 | 树路径 | 用途 |
+|------|-------|------|
+| `managing-project-skills/SKILL.md` | `root` | 根节点，L0 入口调度 |
+| `installing-project-skills/SKILL.md` | `lifecycle/install` | L2，安装/更新/卸载/查看 |
+| `scheduling-project-skills/SKILL.md` | `schedule/orchestrate` | L2，编排/调度/难度分级 |
+| `generating-changelogs/SKILL.md` | `release/changelog` | L2，更新日志生成 |
+
+---
+
+## 🔌 跨平台兼容矩阵
+
+| 平台 | 技能识别方式 | 规则加载方式 | 兼容状态 | 启用方式 |
+|------|-------------|-------------|---------|---------|
+| **Trae** | `.agents/skills/` 自动识别 | `.agents/rules/` 自动加载 | ✅ 原生支持 | 无需配置 |
+| **Cursor** | `.cursor/rules/` + AGENTS.md | 文件匹配 | ⚠️ 需配置 | 安装后运行 `npx psm setup --cursor` |
+| **Windsurf** | `.windsurf/` 目录 | 特定目录 | ⚠️ 需配置 | 安装后运行 `npx psm setup --windsurf` |
+| **Claude Code** | `CLAUDE.md` | 全量 prompt | ⚠️ 部分支持 | 安装后 AGENTS.md 自动注入技能树入口 |
+| **GitHub Copilot** | `.github/copilot-instructions.md` | 指令文件 | ❌ 未适配 | 需要手动配置 |
+| **Cline / Roo Code** | `CLINE.md` / `ROO.md` | 全量 prompt | ❌ 未适配 | 暂无适配计划 |
+
+> 平台适配层规划见 `.agents/adapters/`（未来版本）。
+
+---
+
+## ⚡ 按需加载决策表
+
+| 触发条件 | 操作 | 加载方式 |
+|---------|------|---------|
+| 用户说「更新更新日志」「发布」「打 tag」 | 读取 `version-management-rules.md` 并应用 | 按需加载 |
+| 用户说「修改代码」「新增」「提交代码」 | 读取 `code-standards-rules.md` 检查规范 | 按需加载 |
+| 用户说「安装/更新/卸载技能」 | 读取 `skill-lifecycle-rules.md` 执行生命周期 | 按需加载 |
+| 技能执行时编排任务 | 读取 `skill-scheduling-rules.md` 决定调度策略 | 按需加载 |
+| 用户说「更新更新日志为 vx.x.x」 | 读取 `changelog-rules.md` 生成更新日志 | 按需加载 |
+| 未匹配以上条件 | 仅使用 `project-rules.md`（已全量加载） | 全量加载 |
+
+---
+
+## 🛍️ 可安装技能市场
+
+> 以下技能来自 `.agents/skills-registry.json`，可根据项目技术栈安装。
+
+| 来源 | 技能 | 适用项目 | 安装条件 |
+|------|------|---------|---------|
+| superpowers | TDD、系统调试、验证循环 | 任何项目 | ✅ 始终推荐 |
+| karpathy | 工程规范、调试方法论 | 任何项目 | ✅ 始终推荐 |
+| ecc | React/Vue 前端、Jest/Cypress 测试 | Node/前端项目 | ⚠️ 技术栈匹配 |
+| impeccable | 代码审查、UI 设计 | 前端/全栈项目 | ⚠️ 有 UI 框架 |
+| taste-skill | 设计品味、前端美学 | 前端/全栈项目 | ⚠️ 有 UI 框架 |
+| gitnexus | Git 代码智能（自管理） | 任何 Git 项目 | 🔄 自管理（CLI 安装） |
+| codegraph | 符号搜索/调用图（自管理） | 任何项目 | 🔄 自管理（CLI 安装） |
+
+> 用户自定义源：在项目根目录创建 `.agents/skills-config.json` 可添加私有技能源。
+
+---
+
+## 🔧 工具依赖管理
+
+> 以下工具为技能提供 CLI/MCP 能力。通过 `psm tool install` 交互式安装，支持 CLI 和 MCP 两种方式。
+
+| 工具 | 用途 | CLI 安装 | MCP 配置 | 状态索引 |
+|------|------|---------|---------|---------|
+| **codegraph** | 符号搜索、调用图、影响分析 | `curl ... install.sh \| sh` | `codegraph install` 自动配置 IDE | `.agents/tools.json` |
+| **gitnexus** | Git blame、日志分析、变更影响 | `npm install -g gitnexus` | 自动写入 `.mcp.json` | `.agents/tools.json` |
+
+**命令：**
+- `npx psm tool list` — 查看所有工具安装状态、路径、已验证的子命令
+- `npx psm tool install <name>` — 交互式安装（选 CLI 还是 MCP）
+- `npx psm tool setup` — 扫描已安装技能，批量安装缺失工具
+- `npx psm tool verify` — 重新验证已安装工具的所有子命令可用性
+
+**调用方式：** 技能通过读取 `.agents/tools.json` 获取工具的安装路径和可用命令。例如 `codegraph query` 在 tools.json 中记录为 `verified: true`，技能可直接调用。MCP 方式则通过 IDE 的 MCP 服务器配置调用，无需手动管理命令路径。
+
+---
+
+## 相关工具
+
+| 工具 | 用途 | 位置 |
+|------|------|------|
+| `psm` CLI | 安装/更新/卸载技能和规则 | `npx psm install` |
+| `bootstrap.js` | 跨平台项目检测 + 技能安装状态 | `scripts/bootstrap.js` |
+| `bootstrap.sh` | Linux/macOS 版项目检测 | `scripts/bootstrap.sh` |
+| `skills-registry.json` | 技能注册中心（可扩展） | `.agents/skills-registry.json` |
+
+> **注意：** 本 INDEX.md 由 psm 维护。任何 AI IDE（Cursor / Windsurf / Trae / Claude Code / GitHub Copilot）均可通过读取此文件理解技能树结构。

package/.agents/skills/generating-changelogs/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: generating-changelogs
+description: Use when the user says "更新更新日志为 vx.x.x" or "update changelog" or any request to generate or update a CHANGELOG.md from git history
+tree: release/changelog
+version: 1.0.0
+author: JiunianTV
+requires: []
+requires_tools:
+  - git
+platforms:
+  - cursor
+  - windsurf
+  - trae
+  - claude-code
+tags:
+  - release
+  - changelog
+  - versioning
+---
+
+# Generating Changelogs
+
+> 📍 **技能树位置：L1/L2 — 版本发布/更新日志** — 受 managing-project-skills（根节点）分派
+
+## Overview
+
+Collects commits since the last tag, classifies them by type, and writes a formatted CHANGELOG.md entry.
+
+## Trigger
+
+User says: "更新更新日志为 vx.x.x" or "发布新版本" or "打 tag" or equivalent.
+
+## Version Management Dependency
+
+Before executing, check if `.agents/rules/version-management-rules.md` exists:
+
+- **Exists:** Load it first — it may contain project-specific version numbering, CHANGELOG format, or release process customizations. Apply those rules instead of the defaults below.
+- **Missing:** Use the default flow below. Consider suggesting the user run `npx psm install --preview` to detect and extract version management rules from AGENTS.md/CLAUDE.md.
+
+> **Note:** If the project has custom version management rules in AGENTS.md/CLAUDE.md that were not extracted to `.agents/rules/version-management-rules.md`, the behavior may be inconsistent. Recommend extraction for consistency.
+
+## Flow
+
+### 1. Collect Commits
+
+```bash
+# Get the last tag
+git describe --tags --abbrev=0
+# Get commits since that tag
+git log <last-tag>..HEAD --oneline
+```
+
+### 2. Classify by Type
+
+| Category | Emoji | Keywords |
+|---|---|---|
+| New feature | 🎉 新增 | feat:, feature, 新增, add |
+| UX polish | ✨ 优化 | improve, optimize, enhance, perf |
+| Bug fix | 🔧 修复 | fix:, bug, patch, 修复 |
+| Config | ⚡ 调整 | config, setting, param, env |
+| Refactor | 🏗️ 重构 | refactor:, restructure, 重构 |
+| Documentation | 📊 文档 | docs:, doc, readme, 文档 |
+| Style | 🎨 样式 | style, css, ui, theme, 样式 |
+
+Use conventional commit prefixes when available; otherwise infer from message semantics.
+
+### 3. Output Format
+
+```markdown
+## v{x.y.z} - {YYYY-MM-DD}
+
+### 🎉 新增
+- Feature 1
+- Feature 2
+
+### ✨ 优化
+- Improvement 1
+```
+
+### 4. Version Bump
+
+Update version in: `package.json`, `pyproject.toml`, `VERSION`, and CHANGELOG.md header.
+
+### 5. CHANGELOG.md Location
+
+- Prepend to existing `CHANGELOG.md` in project root
+- Create one if none exists

package/.agents/skills/installing-project-skills/SKILL.md

@@ -0,0 +1,274 @@
+---
+name: installing-project-skills
+description: Use when installing skills for a new project, or when the user asks to update, upgrade, uninstall, or check status of project skills
+tree: lifecycle/install
+version: 1.0.0
+author: JiunianTV
+requires: []
+requires_tools:
+  - git
+  - node (>=18)
+platforms:
+  - cursor
+  - windsurf
+  - trae
+  - claude-code
+tags:
+  - lifecycle
+  - install
+  - upgrade
+  - uninstall
+---
+
+# Installing Project Skills
+
+> 📍 **技能树位置：L1/L2 — 生命周期管理/安装** — 受 managing-project-skills（根节点）分派
+
+## Overview
+
+Covers the full lifecycle of project skills: first-time install, migration from other directories, upgrade from upstream repos, uninstall, and status checks.
+
+## When to Use
+
+- User says "安装技能和规则" / "setup skills" — full install
+- User says "更新技能" / "升级技能" / "同步技能" — upgrade existing
+- User says "卸载技能 xxx" — remove a skill
+- User says "查看技能" / "技能状态" — list and verify
+- User says "有什么技能适合我" / "推荐技能" / "discover skills" — skill discovery
+
+## Skill Discovery
+
+When the user asks what skills are available or suitable for their project:
+
+1. **Read the registry** — open `.agents/skills-registry.json` and list all available sources
+2. **Scan project tech stack** — detect `package.json` / `go.mod` / `Cargo.toml` / `requirements.txt`
+3. **Filter by tech stack** — match registry source `filter` and `match` rules against project deps
+4. **Show recommendations** — present a table of available skills with:
+   - ✅ **always** — recommended for every project
+   - ⚠️ **tech-stack** — only if project dependencies match
+   - 🔄 **self-managed** — installed via their own CLI
+5. **Ask user** which ones to install, then proceed to Core Flow step 5 (confirmation)
+
+Also check `.agents/skills-config.json` for user-defined custom sources and include them in the recommendation list.
+
+## Core Flow
+
+### 1. Detect Project Info
+
+Read `package.json` / `requirements.txt` / `Cargo.toml` / `go.mod` to determine tech stack. If none found, ask.
+
+### 2. Scan Existing Skills
+
+Search `**/SKILL.md` and `**/skill.md` across the project. Target dirs: `.agents/skills/`, `.trae/skills/`, `skills/`, `.skills/`, `docs/skills/`.
+
+**Self-managed tools (DO NOT migrate):** GitNexus, codegraph — they manage their own skill dirs via CLI.
+
+### 2.5. Scan & Extract Existing Rules from AGENTS.md / CLAUDE.md
+
+**Why:** Projects often have version management and code standards rules embedded in AGENTS.md or CLAUDE.md. These should be extracted to `.agents/rules/` so they become discoverable by psm and don't duplicate across files.
+
+**Detection:** Scan AGENTS.md and CLAUDE.md for these patterns:
+
+| Rule type | Search keywords |
+|-----------|----------------|
+| 版本管理 | 版本管理、版本更新、版本号、versioning、changelog、更新日志、release |
+| 代码规范 | 代码规范、编码规范、提交规范、code style、commit convention、代码风格、lint |
+
+**Action for each detected match:**
+
+1. **Ask the user:** "检测到 AGENTS.md 中包含版本管理/代码规范规则。要提取到 `.agents/rules/` 并替换为引用吗？"
+2. **If yes:** Extract the section(s) to the corresponding rule file (`version-management-rules.md` or `code-standards-rules.md`), then replace the original section in AGENTS.md with a short reference: `> **版本管理：** 详见 \`.agents/rules/version-management-rules.md\``
+3. **If no:** Leave as-is, but record in INDEX.md as "未提取（用户选择保留）"
+4. **If AGENTS.md doesn't exist:** Generate AGENTS.md with the required loading chain reference
+
+**Loading chain:** Ensure AGENTS.md has the mandatory skill tree entry. If not, inject:
+```markdown
+## psm 技能树入口
+
+读取 `.agents/skills/INDEX.md` 了解技能树和按需加载规则。
+```
+
+**CLAUDE.md:** If CLAUDE.md exists and doesn't have `@AGENTS.md`, prepend it. This is automatically handled by `npx psm install`.
+
+### 3. Read Skill Registry
+
+Read `.agents/skills-registry.json` to discover available skill sources. The registry defines:
+
+- **Source name & URL** — where to clone from
+- **Filter rule** — `always` (install for every project) or `tech-stack` (only when dependencies match)
+- **Skill list** — which skills each source provides
+- **selfManaged** — tools that manage their own skill directories (GitNexus, codegraph), skip migration
+
+```json
+// 示例：skills-registry.json 结构
+{
+  "sources": [
+    { "name": "superpowers", "filter": "always" },
+    { "name": "ecc", "filter": "tech-stack", "match": { "dependencies": ["react", "vue"] } },
+    { "name": "gitnexus", "selfManaged": true }
+  ],
+  "customSources": { "hint": "新建 .agents/skills-config.json 可自定义源" }
+}
+```
+
+**Self-managed tools** (marked `selfManaged: true`): they automatically download/update skills to their own directories via CLI. Detect and skip during migration — do NOT move them into `.agents/skills/`.
+
+**Design skill evaluation rule:** For sources with `filter: tech-stack`, check the project's dependency files (`package.json`, `go.mod`, etc.) against the `match` criteria. Only install when the project's dependencies satisfy the match.
+
+### 3a. Custom Sources (User Config)
+
+Check if `.agents/skills-config.json` exists in the project. If it does, merge its `customSources` into the registry:
+
+```json
+// .agents/skills-config.json — 用户自定义技能源
+{
+  "customSources": [
+    {
+      "name": "my-team-skills",
+      "url": "https://github.com/myorg/team-skills",
+      "filter": "always",
+      "skills": ["my-standards", "my-deployment"]
+    }
+  ],
+  "ignore": ["impeccable-ui"],        // 强制忽略某些技能
+  "alwaysInstall": ["my-standards"]     // 强制安装某些技能
+}
+```
+
+**Template:** `.agents/skills-config.template.json` can be copied as a starting point.
+**Note:** This file is NEVER overwritten by `psm install`, so users can safely customize it.
+
+### 4. Tech-Stack Filtering
+
+| Project type | Priority skills |
+|---|---|
+| Node/frontend (package.json) | Design, testing, code-quality |
+| Python (requirements.txt/pyproject.toml) | Data, ML, API |
+| Rust (Cargo.toml) | Memory-safe, concurrent |
+| Go (go.mod) | Microservice, container |
+| Full-stack | Combined from both tiers |
+
+### 5. User Confirmation & Customization
+
+**Before any files are written**, present a full checklist to the user and let them customize:
+
+#### 5a. Present the Checklist
+
+Show the user a structured summary:
+
+```
+📋 安装计划确认
+
+【待安装】来自上游仓库
+  □ superpowers/test-driven-development
+  □ superpowers/systematic-debugging
+  □ karpathy/karpathy-engineering
+  □ ECC/frontend-react          ← 仅在匹配技术栈时
+  □ impeccable/impeccable-ui    ← 仅在有 UI 框架时
+
+【待迁移】来自旧目录
+  □ .trae/skills/xxx → .agents/skills/xxx
+
+【待删除】旧目录（迁移完成后）
+  □ .trae/skills/
+  □ skills/                      ← 仅当所有内容已迁移
+  □ .skills/
+
+【待生成】规则文件
+  □ skill-lifecycle-rules.md
+  □ skill-scheduling-rules.md
+  □ changelog-rules.md
+  □ project-rules.md              ← 根据项目技术栈动态生成代码规范
+  □ version-management-rules.md  ← 如 AGENTS.md 中有版本管理规则
+  □ code-standards-rules.md      ← 如 AGENTS.md 中有代码规范规则
+
+【待注入】技能树入口
+  □ AGENTS.md → 指向 .agents/skills/INDEX.md
+  □ CLAUDE.md → @AGENTS.md（如不存在）
+```
+
+#### 5b. Offer Customization Actions
+
+For each item, the user can say:
+
+| 用户指令 | 处理方式 |
+|---------|---------|
+| "保留 xxx" | Skip deletion, keep the skill/rules as-is where it is |
+| "删除 xxx" | Remove from the install/migrate list entirely |
+| "只安装 xxx 和 yyy" | Prune the list to only the named items |
+| "这个不需要" | Remove that specific item |
+| "先安装全部，再手动清理" | Skip confirmation, proceed with full plan |
+
+#### 5c. Apply User Choices
+
+After the user confirms (with or without modifications), proceed with the approved list. Skip items the user rejected. Record skipped items in INDEX.md as "用户选择跳过".
+
+### 6. Handle Conflicts
+
+| Conflict | Action |
+|---|---|
+| Same name, different version | Ask: keep old / install new / keep both (rename) |
+| Functional overlap | Ask user to pick one |
+| Dependency conflict | Auto-select compatible version or report |
+
+### 7. Install & Migrate
+
+- Move migratable skills into `.agents/skills/<name>/SKILL.md`
+- Keep self-managed tool dirs untouched
+- Install new skills from upstream repos into `.agents/skills/`
+- Record migration history (原位置 → 新位置) in INDEX.md
+
+### 8. Clean Up Old Dirs
+
+Delete `.trae/skills/`, `skills/`, `.skills/` **only if** all content has been migrated and no self-managed tools remain.
+
+### 9. Tool Dependency Resolution
+
+For each skill that declares `requires_tools` in its frontmatter:
+
+1. **Check tools.json** — read `.agents/tools.json` to see if the tool has been installed or configured before
+2. **Check system PATH** — run `psm tool list [target]` to see which tools are available
+3. **If not found** — ask the user: "技能 xxx 需要 Y 能力，要安装吗？"
+   - 使用 `npx psm tool install <name>` 进行交互式安装（CLI 或 MCP，用户自选）
+   - 安装完成后自动更新 `.agents/tools.json`
+4. **Batch check** — run `npx psm tool setup` to scan all installed skills and install missing tools in one go
+
+**工具定义来源：** `.agents/skills-registry.json` 中的 `tools` 字段，每个工具定义了：
+- `checkCommand` — 检测是否已安装
+- `cli` — CLI 安装命令和安装后配置
+- `mcp` — MCP 服务器配置方式（command + args）
+
+**自管理工具**（如 GitNexus、CodeGraph）：它们有自己的 CLI 来管理技能和更新，通过 `psm tool install` 安装后，其技能由自身 CLI 管理，PSM 不做迁移。
+
+### 10. Generate INDEX.md
+
+List all installed skills with purpose, source, version, and migration notes.
+
+---
+
+## Upgrade Flow
+
+1. Compare installed versions against upstream repos
+2. Identify new applicable skills (based on current tech stack)
+3. **Present upgrade plan** to the user as a checklist (same format as 5a), with:
+   - Skills that will be updated
+   - New skills that will be installed
+   - Skills that will be removed (if upstream dropped them)
+   - Whether rules will be overwritten or merged
+4. Let user customize: "保留旧版", "这个不更新", "只更新 xxx" etc.
+5. Download updates; merge custom rules (do NOT overwrite user customizations)
+6. Update INDEX.md; clean up obsolete entries
+
+## Uninstall Flow
+
+1. Confirm skill name
+2. Remove from `.agents/skills/<name>/`
+3. Remove from INDEX.md
+4. Check if any rule file references it; ask about cleanup
+
+## Status Check
+
+1. List `.agents/skills/` contents
+2. Show version / source / last-updated for each
+3. Verify dependency tools are installed
+4. Report any unmigrated skills (excluding self-managed dirs)

package/.agents/skills/managing-project-skills/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: managing-project-skills
+description: Use when the user asks to install, update, upgrade, uninstall, or check status of project skills and rules, or when setting up skills for a new project
+tree: root
+version: 1.0.0
+author: JiunianTV
+requires:
+  - installing-project-skills
+  - scheduling-project-skills
+  - generating-changelogs
+requires_tools:
+  - git
+platforms:
+  - cursor
+  - windsurf
+  - trae
+  - claude-code
+tags:
+  - core
+  - orchestrator
+  - lifecycle
+---
+
+# Managing Project Skills
+
+> 📍 **技能树位置：L0 — 根节点** — 所有技能调度的统一入口
+> 子节点：L1「生命周期管理」→ [installing-project-skills] / L1「任务调度」→ [scheduling-project-skills] / L1「版本发布」→ [generating-changelogs]
+
+## Overview
+
+Orchestration entry point for project skill management. Dispatches to the appropriate sub-skill based on the user's intent.
+
+## First-Load Detection
+
+### 1. Check INDEX.md
+If **`.agents/skills/INDEX.md` is missing or empty**, the project has not yet run skill installation.
+
+### 2. Check for Unextracted Rules
+If INDEX.md exists, check AGENTS.md and CLAUDE.md for version management or code standards rules that should have been extracted to `.agents/rules/`.
+
+Look for these patterns in AGENTS.md/CLAUDE.md:
+
+| Rule type | Detection keywords | Expected location |
+|-----------|-------------------|------------------|
+| 版本管理 | 版本管理、版本更新、版本号、versioning、changelog、更新日志 | `.agents/rules/version-management-rules.md` |
+| 代码规范 | 代码规范、编码规范、提交规范、code style、commit convention | `.agents/rules/code-standards-rules.md` |
+
+If patterns found but rule files missing, warn the user:
+> "检测到 AGENTS.md/CLAUDE.md 中包含版本管理/代码规范规则，但未提取到 `.agents/rules/`。建议运行 `npx psm install --yes` 来自动提取。"
+
+### 3. Bootstrap hint
+If INDEX.md missing, print:
+> "检测到技能尚未安装。在 IDE 中输入「安装技能和规则」即可自动扫描项目并安装匹配的技能。"
+> 或运行 `node scripts/bootstrap.js` 查看项目检测报告和引导信息
+
+### 4. Proceed
+Then proceed to [installing-project-skills] when the user confirms.
+
+## 技能树调度（L0 → L1 → L2）
+
+> 使用树形分层调度：先匹配 L1 类别（用户意图所属域），再分派到 L2 具体技能。
+> 完整的技能树结构见 `.agents/skills/INDEX.md`
+
+### 技能树结构
+
+```
+L0: managing-project-skills（根节点 — 统一入口）
+  │
+  ├── L1: 🔧 生命周期管理
+  │     └── L2: [installing-project-skills] — 安装/更新/卸载/查看
+  │
+  ├── L1: 📋 任务调度
+  │     └── L2: [scheduling-project-skills] — 编排/难度分级/场景映射
+  │
+  └── L1: 📦 版本发布
+        └── L2: [generating-changelogs] — 更新日志生成
+```
+
+### L0 → L1 匹配规则
+
+| 用户意图 | 匹配的 L1 类别 | 匹配后再加载的 L2 技能 |
+|---------|---------------|----------------------|
+| "安装技能和规则" / "setup skills" / 首次配置 | 🔧 生命周期管理 | [installing-project-skills] — full install flow |
+| "更新技能" / "升级技能" / "同步技能" | 🔧 生命周期管理 | [installing-project-skills] — upgrade flow |
+| "卸载技能 xxx" | 🔧 生命周期管理 | [installing-project-skills] — uninstall flow |
+| "查看技能" / "技能状态" | 🔧 生命周期管理 | [installing-project-skills] — status check |
+| 技能执行时编排任务 | 📋 任务调度 | [scheduling-project-skills] |
+| "更新更新日志为 vx.x.x" / "changelog" | 📦 版本发布 | [generating-changelogs] |
+| "版本管理规则" / "版本规范" / "版本号" | 📦 版本发布 | 检查 .agents/rules/version-management-rules.md |
+
+## Cross-references## Cross-references
+
+- **REQUIRED SUB-SKILL:** [installing-project-skills] — lifecycle management
+- **REQUIRED SUB-SKILL:** [scheduling-project-skills] — task orchestration
+- **REQUIRED SUB-SKILL:** [generating-changelogs] — changelog generation
+- **REQUIRED RULES:** `.agents/rules/version-management-rules.md` — 版本管理（缺失时提示）
+- **REQUIRED RULES:** `.agents/rules/code-standards-rules.md` — 代码规范（缺失时提示）

package/.agents/skills/scheduling-project-skills/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: scheduling-project-skills
+description: Use when orchestrating multiple skills for a task — determining execution order, parallelism, and difficulty grading. Also use when the user asks how skills are dispatched
+tree: schedule/orchestrate
+version: 1.0.0
+author: JiunianTV
+requires: []
+requires_tools: []
+platforms:
+  - cursor
+  - windsurf
+  - trae
+  - claude-code
+tags:
+  - orchestration
+  - scheduling
+  - difficulty
+---
+
+# Scheduling Project Skills
+
+> 📍 **技能树位置：L1/L2 — 任务调度/编排** — 受 managing-project-skills（根节点）分派
+
+## Overview
+
+Defines how skills are selected, ordered, and executed: difficulty grading (L1-L4), scenario-to-skill mapping, and serial/parallel orchestration.
+
+## Difficulty Grading
+
+| Level | Difficulty | Max parallel skills | Examples |
+|---|---|---|---|
+| L1 | Simple | 1 | Translation, formatting, simple fixes |
+| L2 | Medium | 2 | Feature implementation, unit tests |
+| L3 | Complex | 3 | Architecture design, multi-module coordination |
+| L4 | Expert | 5 | Performance audit, security review, deep refactor |
+
+**L3/L4 special rule:** If `brainstorming` skill is installed, call it first to decompose the task before dispatching other skills.
+
+## 技能调度（参考技能树）
+
+> 技能选择按树形分层：先在 INDEX.md 中匹配 L1 类别，再加载对应 L2 技能。
+> 完整的调度映射表见 `.agents/skills/INDEX.md` 的导航指南和树形结构。
+
+当 L2 技能被选中后，本技能负责其编排策略：决定串行/并行、难度分级、执行顺序。
+
+## Skill Selection Priority
+
+1. **Project-local first:** `.agents/skills/` over global skills
+2. **Specialized over generic:** e.g. `vue-skill` before `frontend-generic`
+3. **Higher version over lower:** same-function skills
+4. **CLI over MCP:** prefer CLI tools over MCP server calls
+
+## Orchestration Patterns
+
+| Complexity | Pattern | Example |
+|---|---|---|
+| L1 | Single skill, direct execution | Translate a string |
+| L2 | Main + helper, serial | Implement login → write tests → security check |
+| L3 | Parallel + merge | Understand code + check coverage + analyze deps → merge → plan → refactor |
+| L4 | Multi-agent + cross-verify | Coordinator dispatches sub-agents, results cross-checked |
+
+## Pre-execution Checklist
+
+- [ ] Task type identified
+- [ ] Difficulty assessed
+- [ ] Relevant skills installed
+- [ ] Dependency tools available
+- [ ] Call order correct (prerequisites first)
+- [ ] Results verified
+- [ ] Multi-skill output merged