psmgr 1.0.0

package/.agents/rules/changelog-rules.md

@@ -0,0 +1,38 @@
+# 更新日志规则
+
+> 按需加载 — 用户说"更新更新日志为 vx.x.x"时加载
+
+## 流程
+
+1. 获取上一个 tag 到最新提交的 commit
+2. 按提交类型分类（feat/fix/docs/refactor/style/perf/config）
+3. 按格式输出到 CHANGELOG.md
+4. 更新所有版本号相关文件
+
+## 分类标准
+
+| 分类 | emoji | 关键词 |
+|------|-------|--------|
+| 新功能 | 🎉 新增 | feat:, feature, 新增, add |
+| 体验优化 | ✨ 优化 | improve, optimize, enhance, perf |
+| bug 修复 | 🔧 修复 | fix:, bug, patch, 修复 |
+| 配置调整 | ⚡ 调整 | config, setting, param, env |
+| 代码重构 | 🏗️ 重构 | refactor:, restructure, 重构 |
+| 文档图表 | 📊 文档 | docs:, doc, readme, 文档 |
+| 样式调整 | 🎨 样式 | style, css, ui, theme, 样式 |
+
+## 输出格式
+
+```markdown
+## v{x.y.z} - {YYYY-MM-DD}
+
+### 🎉 新增
+- 功能点 1
+
+### ✨ 优化
+- 优化点 1
+```
+
+## CHANGELOG.md
+
+默认在项目根目录。已有则追加到最上方，没有则创建。

package/.agents/rules/code-standards-rules.md

@@ -0,0 +1,74 @@
+<!-- psm:auto-generated version=1.0 -->
+<!-- 本文件由 psm install 生成。安装时检测到 AGENTS.md/CLAUDE.md 有代码规范规则，会提取到此文件 -->
+
+# 代码规范规则
+
+> 按需加载 — 修改源代码时自动加载
+> 关联区块：`.agents/rules/project-rules.md` 中的「代码规范」章节
+
+---
+
+## 🎯 触发条件
+
+| 场景 | 触发动作 | 加载方式 |
+|------|---------|---------|
+| 修改任何源代码文件 | 自动应用本规则 | 全量加载 |
+| 新增文件 | 检查是否符合项目编码风格 | 按需 |
+| 提交前 | 检查是否符合提交规范 | 按需 |
+| 用户说「代码风格」「格式」「lint」「规范」 | 加载完整代码规范 | 按需 |
+
+---
+
+## 默认提交规范
+
+> 使用 Conventional Commits 格式
+
+```
+<type>: <简短描述（中文，不超过50字）>
+
+<详细描述（可选，中文）>
+```
+
+### 提交类型
+
+| 类型 | 用途 |
+|------|------|
+| `feat:` | 新功能 |
+| `fix:` | Bug 修复 |
+| `docs:` | 文档更新 |
+| `refactor:` | 代码重构（不修 bug 不加功能） |
+| `style:` | 样式/UI 调整 |
+| `perf:` | 性能优化 |
+| `test:` | 测试相关 |
+| `chore:` | 构建/CI/配置 |
+
+---
+
+## 默认编码规范
+
+- 遵循项目已配置的 linter/formatter（ESLint / Prettier / Ruff / golangci-lint）
+- 无 linter 时遵循：一致缩进、语义化命名、函数单一职责
+- 用户输入必须校验（trim + sanitize + 参数化）
+- 错误处理分三级：用户可见友好提示 / 控制台警告 / 静默容错
+- 不硬编码密钥，通过环境变量注入
+- 不输出未验证的 HTML/URL/脚本（XSS 防护）
+
+---
+
+## ⚠️ 冲突处理
+
+> 以下场景由 psm install 检测并交互处理
+
+| 检测到的冲突 | 处理方式 |
+|------------|---------|
+| AGENTS.md 已有「代码规范」「编码规范」「Code Style」章节 | 询问：提取到本文件并替换为引用 / 保留原有 / 合并 |
+| CLAUDE.md 已有「行为约束」「工具调用」等规则 | 询问：保留 / 合并到对应规则文件 |
+| 项目已有 `.editorconfig` / `ESLint` / `Prettier` 配置 | 自动识别，不覆盖，在规范中引用"由工具强制执行" |
+| 项目已有 Git commit template / commitlint | 引用已有工具，不覆盖 |
+
+---
+
+## 📝 项目自定义
+
+<!-- psm:project-custom -->
+<!-- 安装后，项目专属的编码规范（如特定命名约定、架构模式）写在此处 -->

package/.agents/rules/project-rules.md

@@ -0,0 +1,126 @@
+<!-- psm:auto-generated version=1.0 -->
+<!-- 本文件由 psm install 生成，非模板部分不会被覆盖 -->
+
+# 项目通用规则
+
+> 全量加载 — 每次对话开始时自动注入
+
+---
+
+## 📋 通用规范（适用于所有项目）
+
+### 技能使用
+
+- 优先使用 `.agents/skills/` 下的项目级技能
+- 复杂任务先拆解再执行
+- 多技能任务执行后必须汇总结果
+
+### 提交消息
+
+- 遵循 Conventional Commits 格式：`<type>: <简短描述>`
+- 类型：`feat:` / `fix:` / `docs:` / `refactor:` / `style:` / `perf:` / `test:` / `chore:`
+- 描述不超过 50 字，说明**做了什么**而非**为什么做**
+
+### 架构约束
+
+- 新增依赖前检查是否与现有技术栈兼容
+- 不引入不必要的构建工具或框架
+
+---
+
+## ⚡ 规则按需加载决策表（强制执行）
+
+> 本表是"按需加载"的执行机制。**每次收到用户消息后，先匹配下表，再决定加载哪些规则文件。**
+> 本文件始终全量加载，所以此决策表始终可见。
+
+### 决策流程
+
+```
+收到用户消息
+  ↓
+匹配「触发条件」列 → 匹配 → 加载对应规则文件（按需）
+  ↓ 不匹配
+仅使用本文件（project-rules.md）执行任务
+```
+
+### 触发条件 → 规则加载映射
+
+| 触发条件（用户说/场景） | 按需加载的规则文件 | 关联技能 |
+|------------------------|-------------------|---------|
+| "更新更新日志""发布新版本""打 tag""release""版本号" | `.agents/rules/version-management-rules.md` | `generating-changelogs` |
+| "修改代码""新增""实现""写代码""编码" | `.agents/rules/code-standards-rules.md` | — |
+| "安装技能""更新技能""卸载技能""查看技能" | `.agents/rules/skill-lifecycle-rules.md` | `installing-project-skills` |
+| 技能执行时编排/调度任务 | `.agents/rules/skill-scheduling-rules.md` | `scheduling-project-skills` |
+| "更新更新日志为 vx.x.x" | `.agents/rules/changelog-rules.md` | `generating-changelogs` |
+| 未匹配以上任何条件 | 不额外加载，仅使用本文件 | — |
+
+### 加载方式说明
+
+| 加载方式 | 含义 | 文件 |
+|---------|------|------|
+| **全量加载** | 每次对话开始时自动注入上下文 | `project-rules.md`（本文件） |
+| **按需加载** | 匹配左侧触发条件时加载，否则不加载 | `version-management-rules.md`, `code-standards-rules.md`, `skill-lifecycle-rules.md`, `skill-scheduling-rules.md`, `changelog-rules.md` |
+
+> **注意：** 按需加载的文件存放在 `.agents/rules/` 目录。Agent 在匹配触发条件后，应主动读取对应规则文件的内容并应用到当前任务。
+
+---
+
+## 🔧 代码规范（项目专属）
+
+> 触发条件：修改源代码时自动应用。以下为 psm 默认规范，安装时检测到项目已有规范则会询问是否替换。
+
+<!-- psm:code-standards-placeholder -->
+<!-- 安装时如检测到同名规则，注入引用到此处 -->
+
+- 遵循项目已有代码风格（由 linters/formatters 强制执行）
+- 优先使用 ES6+ 语法（如项目支持）
+- 错误处理分级：用户可见错误 / 控制台日志 / 静默容错
+- 用户输入必须校验（trim + encodeURIComponent / 参数化查询）
+- 不硬编码密钥，通过环境变量注入
+
+---
+
+## 📦 版本管理规则
+
+> 触发条件：用户说「更新更新日志为 vx.x.x」「发布新版本」「打 tag」时加载
+> 关联技能：`generating-changelogs`
+
+<!-- psm:version-management-placeholder -->
+<!-- 安装时如检测到 AGENTS.md/CLAUDE.md 中有版本管理/CHANGELOG 规则，提取到此文件 -->
+
+版本管理详细流程见 `.agents/rules/version-management-rules.md`（按需加载）
+
+---
+
+## 🎯 任务前置分类铁律（强制执行）
+
+> 每次收到改动请求后，在写任何代码之前，必须执行以下步骤
+
+### 第 0 步：加载规则文件
+
+- 本文件由 AGENTS.md 引用的技能树入口加载（全量加载）
+- 技能树导航见 `.agents/skills/INDEX.md`（优先读取，了解技能层级关系）
+- 如需技能调度细则，加载 `.agents/rules/skill-scheduling-rules.md`
+### 第一步：任务分类
+
+| 类别 | 判定标准 | 触发条件 |
+|------|---------|---------|
+| 🎨 UI/设计 | 修改外观、布局、样式、新建界面 | 用户描述涉及视觉/布局 |
+| 🔧 Bug 修复 | 排查报错、异常行为、逻辑错误 | 用户说"报错""bug""不工作" |
+| 🏗️ 新功能/复杂改动 | 新增模块、跨文件改动、架构调整 | 用户说"实现""添加""新增" |
+| 🧹 代码改进 | 重构、简化、去冗余、性能优化 | 用户说"优化""重构""清理" |
+| ✏️ 简单改动 | ≤10行、文案/配置/单文件样式微调 | 明显是微小改动 |
+
+### 第二步：调用对应的技能入口（按技能树分派）
+
+> 完整技能树见 `.agents/skills/INDEX.md`。先匹配 L1 类别，再由 L2 技能执行。
+
+| 类别 | L1 树类别 | 分派说明 |
+|------|-----------|---------|
+| 🎨 UI/设计 | 🎨 设计技能（安装 psm-taste 后可用） | 调用 `frontend-design` 或 `redesign-existing-projects` |
+| 🔧 Bug 修复 | — | 不调用技能树，直接加载 `systematic-debugging` |
+| 🏗️ 新功能/复杂改动 | — | 不调用技能树，直接加载 `brainstorming` 或 `writing-plans` |
+| 🧹 代码改进 | 📋 任务调度 | 加载 `scheduling-project-skills` 进行编排 |
+| ✏️ 简单改动 | — | 直接执行，不调用技能
+> 如果任务跨多个类别，按最高优先级执行（UI/设计 > Bug修复 > 新功能 > 代码改进 > 简单改动）
+> 技能调用后，按技能返回的指导执行。不得以"跳过"或"太简单"为由绕过分类步骤。

package/.agents/rules/skill-lifecycle-rules.md

@@ -0,0 +1,34 @@
+# 技能生命周期规则
+
+> 按需加载 — 仅在用户说"安装/更新/升级/卸载/查看技能和规则"时加载
+
+## 安装流程
+
+见 [installing-project-skills] 技能文件，按以下阶段执行：
+1. 检测项目信息（读取依赖文件确定技术栈）
+2. 扫描现有技能（搜索所有 SKILL.md）
+3. 整合上游仓库（ECC、GitNexus、codegraph、superpowers、karpathy）
+4. 技术栈适配筛选
+5. 冲突处理
+6. 安装与迁移
+7. 清理旧目录
+8. MCP→CLI 改造
+9. 生成 INDEX.md
+
+## 升级流程
+
+1. 对比已安装版本与上游仓库最新版本
+2. 识别新增适用技能
+3. 下载更新，合并自定义规则（不覆盖用户定制）
+4. 更新 INDEX.md，清理过期条目
+
+## 卸载流程
+
+1. 确认技能名称
+2. 从 `.agents/skills/<name>/` 删除
+3. 从 INDEX.md 移除记录
+4. 检查规则引用，询问是否清理
+
+## 状态检查
+
+列出 `.agents/skills/` 下所有技能，显示版本/来源/更新时间，检查依赖工具是否安装，报告未迁移技能。

package/.agents/rules/skill-scheduling-rules.md

@@ -0,0 +1,119 @@
+<!-- psm:auto-generated version=1.0 -->
+<!-- 本文件由 psm install 生成 -->
+
+# 技能调度规则
+
+> 按需加载 — 技能执行任务时加载
+
+---
+
+## 调度原则
+
+1. **项目内技能优先：** 先使用 `.agents/skills/` 下的技能，再考虑全局技能
+2. **按需加载：** 仅加载当前任务相关的技能
+3. **单一职责：** 每个技能只执行单一任务
+4. **串行优先：** 同类型任务串行执行
+5. **Brainstorming 优先（如有）：** L3/L4 复杂任务先调 brainstorming 分析拆解
+
+---
+
+## 🎯 触发条件矩阵
+
+| # | 场景 | 用户触发词 | 调用链 | 说明 |
+|---|------|-----------|--------|------|
+| 1 | 新功能开发 | "实现""添加""新增功能" | `brainstorming` → `writing-plans` → `codegraph/gitnexus` → `tdd` → 验证 | 从设计到实现 |
+| 2 | Bug 修复 | "报错""bug""不工作""出错" | `systematic-debugging` → `test-driven-development` → 验证 | 先诊断再修复 |
+| 3 | 代码重构 | "重构""优化代码""重写" | `codegraph/gitnexus`(影响分析) → `writing-plans` → `tdd` → 验证 | 改前分析影响范围 |
+| 4 | 代码审查 | "审查""review""检查代码" | `codegraph/gitnexus` → `requesting-code-review` → 验证 | 分析变更影响 |
+| 5 | 安全审查 | "安全审查""安全检查""security" | `codegraph impact` → `security-review` → 验证 | ECC 安全协议 |
+| 6 | 技术调研 | "调研""怎么看""查一下" | `search-first` → `writing-plans` → 编码 | 先找现成方案 |
+| 7 | UI/UX 设计 | "设计""改界面""新页面" | `brainstorming` → 设计技能 → 实现 → 验证 | 参考设计技能选择指南 |
+| 8 | E2E 验证 | "验证""测试流程""e2e" | `e2e-testing` → `verification-before-completion` | 核心链路验证 |
+| 9 | 性能优化 | "性能""优化""太慢" | `web-perf` → `codegraph/gitnexus` → `writing-plans` → 验证 | 先测量再优化 |
+| 10 | API/外部集成 | "接入""API""集成" | `search-first` → `codegraph` → `tdd`(mock) → 验证 | 调研→实现 |
+| 11 | 版本发布 | "发布""新版本""更新日志" | `generating-changelogs` → 版本号更新 → git tag | 加载 version-management-rules.md |
+| 12 | 技能管理 | "安装技能""更新技能""卸载" | `managing-project-skills` → 对应子技能 | 加载 skill-lifecycle-rules.md |
+
+---
+
+## 难度分级
+
+| 级别 | 最大并行 | 典型任务 |
+|------|---------|---------|
+| L1 | 1 | 翻译、格式化、简单修复 |
+| L2 | 2 | 功能实现、单元测试 |
+| L3 | 3 | 架构设计、多模块协调 |
+| L4 | 5 | 性能优化、安全审计、深度重构 |
+
+## 任务难度判断
+
+根据任务复杂度选择不同的技能组合：
+
+```
+任务开始
+  ↓
+判断难度
+  ├─ 简单（单步操作）
+  │    直接执行 + 代码规范规则
+  │
+  ├─ 中等（2-5 步）
+  │    writing-plans → 编码 + test-driven-development → 验证
+  │                                                                        ↓
+  │    遇到问题 → systematic-debugging
+  │
+  └─ 复杂（多模块/跨文件）
+       brainstorming → writing-plans → codegraph/gitnexus
+            → test-driven-development → 验证
+                                          ↓
+                 遇到问题 → systematic-debugging
+  ↓
+完成任务
+```
+
+| 难度 | 判断标准 | 示例 |
+|------|---------|------|
+| **简单** | 单文件改动 ≤ 20 行，无逻辑分支 | 文案修改、样式调整、配置更新 |
+| **中等** | 2-5 步操作，涉及单模块 | 添加一个搜索过滤条件、修改行为 |
+| **复杂** | 多模块跨文件，需设计方案 | 新增搜索源、重构核心模块、性能优化 |
+
+---
+
+## 技能选择优先级
+
+项目内 > 专用技能 > 高版本 > CLI 优先于 MCP
+
+## 编排模式
+
+| 复杂度 | 方式 |
+|--------|------|
+| L1 | 单一技能直接执行 |
+| L2 | 主技能 + 辅助技能串行 |
+| L3 | 多技能并行 + 结果汇总 |
+| L4 | 多 Agent 协作 + 交叉验证 |
+
+---
+
+## 并行执行原则
+
+对于独立操作，优先使用并行调度：
+
+```
+✅ 正确：并行执行
+  Agent 1：codegraph 影响分析
+  Agent 2：search-first 技术调研
+  Agent 3：e2e-testing 跑回归
+
+❌ 错误：不必要的串行
+  先 Agent 1、再 Agent 2、再 Agent 3
+```
+
+---
+
+## 开发工作流
+
+1. **规划** → `brainstorming` 或 `writing-plans`
+2. **开发** → `tdd` 或直接编码（简单任务）
+3. **审查** → `codegraph/gitnexus` + `requesting-code-review`
+4. **安全** → `security-review`（涉及输入/API时）
+5. **验证** → `verification-before-completion`
+6. **提交** → 提交规范（加载 code-standards-rules.md）

package/.agents/rules/templates/code-standards-go.md

@@ -0,0 +1,14 @@
+<!-- psm:tech-stack-rules -->
+<!-- 由 psm install 根据项目技术栈自动生成 -->
+
+### Go 规范
+
+- 代码风格由 `gofmt` / `go vet` 强制执行，无需额外配置
+- 错误处理：始终显式检查 `err != nil`，避免忽略错误
+- 使用 `errors.Is()` / `errors.As()` 进行错误链比较
+- 接口设计：小接口（≤3 方法），接受接口返回结构体
+- 并发：使用 `sync.WaitGroup` / `errgroup` 管理 goroutine，避免泄露
+- 测试：标准 `testing` 包，使用 `testify/assert` 辅助断言
+- 依赖管理：使用 Go modules，定期 `go mod tidy`
+- 上下文（context）：所有阻塞/网络操作接受 `context.Context` 作为第一个参数
+- 日志：使用结构化日志（`slog` / `zerolog` / `zap`），避免 `fmt.Println`

package/.agents/rules/templates/code-standards-node.md

@@ -0,0 +1,14 @@
+<!-- psm:tech-stack-rules -->
+<!-- 由 psm install 根据项目技术栈自动生成 -->
+
+### Node.js / TypeScript 规范
+
+- 使用 ES6+ 语法：`async/await`、解构赋值、可选链、空值合并
+- TypeScript 项目启用 `strict` 模式
+- 优先使用 `import/export`（ESM），避免 `require`
+- 错误处理：使用 `try/catch` 或 `Result` 模式，避免回调地狱
+- 异步操作优先使用 `Promise.all` / `Promise.allSettled` 并行化
+- 路径别名：使用模块别名而非深层相对路径（`@/` 代替 `../../../`）
+- 测试框架：Jest / Vitest，测试文件与源码同目录（`*.test.ts`）
+- 代码风格由 ESLint + Prettier 强制执行
+- 依赖管理：定期运行 `npm audit`，避免引入冗余依赖

package/.agents/rules/templates/code-standards-python.md

@@ -0,0 +1,15 @@
+<!-- psm:tech-stack-rules -->
+<!-- 由 psm install 根据项目技术栈自动生成 -->
+
+### Python 规范
+
+- 遵循 PEP 8 编码风格（行长度 88 字符，Black 格式化）
+- 所有函数和类必须包含类型注解（PEP 484）
+- 使用 `pathlib` 替代 `os.path` 处理路径
+- 错误处理：使用特定异常类，避免裸 `except:`
+- 异步代码使用 `asyncio` / `anyio`，避免 `sync_to_async` 包装
+- 导入顺序：标准库 → 第三方 → 本地模块（isort 分组）
+- 测试框架：pytest，测试覆盖率 ≥ 80%
+- 代码风格由 Black + Ruff 强制执行
+- 依赖管理：使用 `pyproject.toml`，定期 `pip audit`
+- 类型检查：使用 `mypy` 或 `pyright` 严格模式

package/.agents/rules/templates/code-standards-rust.md

@@ -0,0 +1,14 @@
+<!-- psm:tech-stack-rules -->
+<!-- 由 psm install 根据项目技术栈自动生成 -->
+
+### Rust 规范
+
+- 代码风格由 `rustfmt` + `clippy` 强制执行
+- 所有公有项（`pub`）必须包含文档注释（`///` 或 `//!`）
+- 错误处理：使用 `Result<T, E>` 和 `?` 运算符，避免 `unwrap()` / `expect()`（除非有明确理由）
+- 所有权：优先使用引用 `&T` 而非克隆，善用借用检查器
+- 并发：使用 `Send + Sync` trait 边界，优先选用 `tokio` 或 `async-std`
+- 测试：单元测试放在模块内（`#[cfg(test)]`），集成测试放在 `tests/` 目录
+- 依赖管理：`cargo deny` / `cargo audit` 定期检查安全漏洞
+- 特性门控：可选功能使用 feature flags，避免条件编译扩散
+- 使用 `thiserror` 和 `anyhow` 做分层错误处理

package/.agents/rules/templates/project-rules-base.md

@@ -0,0 +1,119 @@
+<!-- psm:auto-generated version=1.0 -->
+<!-- 本文件由 psm install 根据项目技术栈动态生成，非模板部分不会被覆盖 -->
+
+# 项目通用规则
+
+> 全量加载 — 每次对话开始时自动注入
+
+---
+
+## 📋 通用规范（适用于所有项目）
+
+### 技能使用
+
+- 优先使用 `.agents/skills/` 下的项目级技能
+- 复杂任务先拆解再执行
+- 多技能任务执行后必须汇总结果
+
+### 提交消息
+
+- 遵循 Conventional Commits 格式：`<type>: <简短描述>`
+- 类型：`feat:` / `fix:` / `docs:` / `refactor:` / `style:` / `perf:` / `test:` / `chore:`
+- 描述不超过 50 字，说明**做了什么**而非**为什么做**
+
+### 架构约束
+
+- 新增依赖前检查是否与现有技术栈兼容
+- 不引入不必要的构建工具或框架
+
+---
+
+## ⚡ 规则按需加载决策表（强制执行）
+
+> 本表是"按需加载"的执行机制。**每次收到用户消息后，先匹配下表，再决定加载哪些规则文件。**
+> 本文件始终全量加载，所以此决策表始终可见。
+
+### 决策流程
+
+```
+收到用户消息
+  ↓
+匹配「触发条件」列 → 匹配 → 加载对应规则文件（按需）
+  ↓ 不匹配
+仅使用本文件（project-rules.md）执行任务
+```
+
+### 触发条件 → 规则加载映射
+
+| 触发条件（用户说/场景） | 按需加载的规则文件 | 关联技能 |
+|------------------------|-------------------|---------|
+| "更新更新日志""发布新版本""打 tag""release""版本号" | `.agents/rules/version-management-rules.md` | `generating-changelogs` |
+| "修改代码""新增""实现""写代码""编码" | `.agents/rules/code-standards-rules.md` | — |
+| "安装技能""更新技能""卸载技能""查看技能" | `.agents/rules/skill-lifecycle-rules.md` | `installing-project-skills` |
+| 技能执行时编排/调度任务 | `.agents/rules/skill-scheduling-rules.md` | `scheduling-project-skills` |
+| "更新更新日志为 vx.x.x" | `.agents/rules/changelog-rules.md` | `generating-changelogs` |
+| 未匹配以上任何条件 | 不额外加载，仅使用本文件 | — |
+
+### 加载方式说明
+
+| 加载方式 | 含义 | 文件 |
+|---------|------|------|
+| **全量加载** | 每次对话开始时自动注入上下文 | `project-rules.md`（本文件） |
+| **按需加载** | 匹配左侧触发条件时加载，否则不加载 | `version-management-rules.md`, `code-standards-rules.md`, `skill-lifecycle-rules.md`, `skill-scheduling-rules.md`, `changelog-rules.md` |
+
+> **注意：** 按需加载的文件存放在 `.agents/rules/` 目录。Agent 在匹配触发条件后，应主动读取对应规则文件的内容并应用到当前任务。
+
+---
+
+## 🔧 代码规范（项目专属）
+
+> 触发条件：修改源代码时自动应用。
+
+<!-- psm:code-standards -->
+
+---
+
+## 📦 版本管理规则
+
+> 触发条件：用户说「更新更新日志为 vx.x.x」「发布新版本」「打 tag」时加载
+> 关联技能：`generating-changelogs`
+
+<!-- psm:version-management-placeholder -->
+<!-- 安装时如检测到 AGENTS.md/CLAUDE.md 中有版本管理/CHANGELOG 规则，提取到此文件 -->
+
+版本管理详细流程见 `.agents/rules/version-management-rules.md`（按需加载）
+
+---
+
+## 🎯 任务前置分类铁律（强制执行）
+
+> 每次收到改动请求后，在写任何代码之前，必须执行以下步骤
+
+### 第 0 步：加载规则文件
+
+- 本文件由 AGENTS.md 引用的技能树入口加载（全量加载）
+- 技能树导航见 `.agents/skills/INDEX.md`（优先读取，了解技能层级关系）
+- 如需技能调度细则，加载 `.agents/rules/skill-scheduling-rules.md`
+### 第一步：任务分类
+
+| 类别 | 判定标准 | 触发条件 |
+|------|---------|---------|
+| 🎨 UI/设计 | 修改外观、布局、样式、新建界面 | 用户描述涉及视觉/布局 |
+| 🔧 Bug 修复 | 排查报错、异常行为、逻辑错误 | 用户说"报错""bug""不工作" |
+| 🏗️ 新功能/复杂改动 | 新增模块、跨文件改动、架构调整 | 用户说"实现""添加""新增" |
+| 🧹 代码改进 | 重构、简化、去冗余、性能优化 | 用户说"优化""重构""清理" |
+| ✏️ 简单改动 | ≤10行、文案/配置/单文件样式微调 | 明显是微小改动 |
+
+### 第二步：调用对应的技能入口（按技能树分派）
+
+> 完整技能树见 `.agents/skills/INDEX.md`。先匹配 L1 类别，再由 L2 技能执行。
+
+| 类别 | L1 树类别 | 分派说明 |
+|------|-----------|---------|
+| 🎨 UI/设计 | 🎨 设计技能（安装 psm-taste 后可用） | 调用 `frontend-design` 或 `redesign-existing-projects` |
+| 🔧 Bug 修复 | — | 不调用技能树，直接加载 `systematic-debugging` |
+| 🏗️ 新功能/复杂改动 | — | 不调用技能树，直接加载 `brainstorming` 或 `writing-plans` |
+| 🧹 代码改进 | 📋 任务调度 | 加载 `scheduling-project-skills` 进行编排 |
+| ✏️ 简单改动 | — | 直接执行，不调用技能
+> 如果任务跨多个类别，按最高优先级执行（UI/设计 > Bug修复 > 新功能 > 代码改进 > 简单改动）
+> 技能调用后，按技能返回的指导执行。不得以"跳过"或"太简单"为由绕过分类步骤。

package/.agents/rules/version-management-rules.md

@@ -0,0 +1,85 @@
+<!-- psm:auto-generated version=1.0 -->
+<!-- 本文件由 psm install 生成。安装时如检测到 AGENTS.md/CLAUDE.md 有版本管理规则，会提取到此文件 -->
+
+# 版本管理规则
+
+> 按需加载 — 用户说「更新更新日志为 vx.x.x」「发布新版本」「打 tag」时加载
+> 关联技能：`generating-changelogs`
+
+---
+
+## 概述
+
+本规则定义了项目的版本更新流程，包括 CHANGELOG 生成、版本号更新和发布流程。
+
+---
+
+## 🎯 触发条件
+
+| 用户指令 | 触发动作 | 加载的规则/技能 |
+|---------|---------|---------------|
+| 「更新更新日志为 vx.x.x」 | 加载本文件 + 调用 `generating-changelogs` | 全量 |
+| 「发布新版本」「打 tag」「release」 | 版本号更新 + CHANGELOG + git tag | 按需 |
+| 「查看版本历史」「changelog」 | 读取 CHANGELOG.md | 按需 |
+
+---
+
+## 🔄 默认流程（由 generating-changelogs 技能执行）
+
+### 1. 收集提交
+
+```bash
+git describe --tags --abbrev=0          # 获取上一个 tag
+git log <last-tag>..HEAD --oneline      # 获取期间提交
+```
+
+### 2. 按类型分类
+
+| 分类 | emoji | 关键词 |
+|------|-------|--------|
+| 新功能 | 🎉 新增 | feat:, feature, 新增, add |
+| 体验优化 | ✨ 优化 | improve, optimize, enhance, perf |
+| Bug 修复 | 🔧 修复 | fix:, bug, patch, 修复 |
+| 配置调整 | ⚡ 调整 | config, setting, param, env |
+| 代码重构 | 🏗️ 重构 | refactor:, restructure, 重构 |
+| 文档图表 | 📊 文档 | docs:, doc, readme, 文档 |
+| 样式调整 | 🎨 样式 | style, css, ui, theme, 样式 |
+
+### 3. 输出格式
+
+```markdown
+## v{x.y.z} - {YYYY-MM-DD}
+
+### 🎉 新增
+- 功能点 1
+
+### ✨ 优化
+- 优化点 1
+```
+
+### 4. 版本号更新
+
+更新 `package.json`、`pyproject.toml`、`VERSION` 等文件中的版本号。
+
+### 5. CHANGELOG.md
+
+默认在项目根目录。已有则追加到最上方，没有则创建。
+
+---
+
+## ⚠️ 冲突处理
+
+> 以下场景由 psm install 检测并交互处理
+
+| 检测到的冲突 | 处理方式 |
+|------------|---------|
+| AGENTS.md 已有版本管理章节（"版本管理规则""版本更新""Versioning"） | 询问：提取到本文件并替换为引用 / 保留原有 / 合并 |
+| CHANGELOG.md 已有不同格式 | 询问：使用 psm 格式 / 保留现有格式 |
+| 项目已有 `npm version` / `standard-version` 等工具 | 询问：集成到流程 / 跳过 |
+
+---
+
+## 📝 项目自定义
+
+<!-- psm:project-custom -->
+<!-- 安装后，项目专属的版本管理规则（如特殊版本号格式、发布流程）写在此处 -->