@liangjie559567/ultrapower 5.2.3 → 5.2.6

package/skills/project-session-manager/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/project-session-manager/
+
+## Purpose
+项目会话管理器 skill。使用 git worktree 和 tmux 管理隔离开发环境，支持多项目并行。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/project-session-manager/lib/AGENTS.md

@@ -0,0 +1,37 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/project-session-manager/lib/
+
+## Purpose
+PSM 核心库目录。包含 project-session-manager skill 的 shell 脚本库，提供配置解析、会话管理、tmux 集成和 git worktree 操作功能。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `config.sh` | 配置加载和解析，读取 projects.json |
+| `parse.sh` | 命令行参数解析工具函数 |
+| `session.sh` | 会话生命周期管理（创建、切换、销毁） |
+| `tmux.sh` | tmux 窗口和面板操作封装 |
+| `worktree.sh` | git worktree 创建和管理操作 |
+
+## Subdirectories
+
+| Directory | Purpose |
+|-----------|---------|
+| `providers/` | 代码托管平台集成（GitHub、GitLab 等） |
+
+## For AI Agents
+
+### 修改此目录时
+- 所有脚本使用 bash，保持 POSIX 兼容性
+- 参见 `skills/project-session-manager/SKILL.md` 了解整体工作流
+- 参见 `providers/` 了解平台集成接口
+
+## Dependencies
+
+### Internal
+- `skills/project-session-manager/` — 父级 PSM skill
+
+<!-- MANUAL: -->

package/skills/project-session-manager/lib/providers/AGENTS.md

@@ -0,0 +1,32 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/project-session-manager/lib/providers/
+
+## Purpose
+PSM 代码托管平台集成目录。包含各主流代码托管平台的 shell 脚本适配器，实现统一的 issue/PR 查询接口。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `interface.sh` | 平台接口规范，定义所有 provider 必须实现的函数 |
+| `github.sh` | GitHub API 集成，支持 issue 和 PR 查询 |
+| `gitlab.sh` | GitLab API 集成 |
+| `bitbucket.sh` | Bitbucket API 集成 |
+| `azure-devops.sh` | Azure DevOps API 集成 |
+| `gitea.sh` | Gitea API 集成（自托管 Git） |
+| `jira.sh` | Jira 项目管理集成 |
+
+## For AI Agents
+
+### 修改此目录时
+- 新增 provider 必须实现 `interface.sh` 中定义的所有函数
+- 参见 `interface.sh` 了解必须实现的接口规范
+
+## Dependencies
+
+### Internal
+- `skills/project-session-manager/lib/` — 父级库目录
+
+<!-- MANUAL: -->

package/skills/project-session-manager/templates/AGENTS.md

@@ -0,0 +1,29 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/project-session-manager/templates/
+
+## Purpose
+PSM 会话模板目录。包含不同开发场景的预定义会话模板，用于快速启动标准化的开发环境。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `feature.md` | 新功能开发会话模板 |
+| `issue-fix.md` | Bug 修复会话模板 |
+| `pr-review.md` | PR 代码审查会话模板 |
+| `projects.json` | 项目配置示例文件 |
+
+## For AI Agents
+
+### 修改此目录时
+- 模板使用 Markdown 格式描述会话结构
+- 参见 `skills/project-session-manager/SKILL.md` 了解模板使用方式
+
+## Dependencies
+
+### Internal
+- `skills/project-session-manager/` — 父级 PSM skill
+
+<!-- MANUAL: -->

package/skills/psm/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/psm/
+
+## Purpose
+PSM 别名 skill。project-session-manager 的简写别名，功能完全相同。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ralph/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ralph/
+
+## Purpose
+Ralph 循环 skill。自我循环直到任务完成并经过 architect 验证，包含 ultrawork 并行执行。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ralph-init/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ralph-init/
+
+## Purpose
+Ralph 初始化 skill。初始化 PRD（产品需求文档）以进行结构化 ralph 循环执行。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ralplan/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ralplan/
+
+## Purpose
+共识规划 skill。/plan --consensus 的别名，与 Planner、Architect、Critic 迭代规划直至达成共识。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/receiving-code-review/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/receiving-code-review/
+
+## Purpose
+接收代码审查 skill。接收代码审查反馈时使用，确保技术严谨性和验证，而非盲目实施。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/release/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/release/
+
+## Purpose
+发布 skill。ultrapower 的自动化发布工作流，处理版本号、changelog 和 npm 发布。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/release/SKILL.md

@@ -54,19 +54,35 @@ git push origin main
 git push origin v<version>
 ```
 
-### 5. 刷新本地 marketplace 缓存
+### 4b. GitHub Actions 自动接管（推荐）
+
+执行 `git push --tags` 后，GitHub Actions 自动接管后续步骤：
+- **npm 发布**（`publish` job）
+- **GitHub Release 创建**（`github-release` job）
+- **marketplace.json 版本同步**（`marketplace-sync` job）
+
+在 GitHub Actions 页面查看进度：https://github.com/liangjie559567/ultrapower/actions
+
+如需手动执行（紧急发布或 CI 不可用）：
+```bash
+npm run release:local          # 完整流水线
+npm run release:dry-run        # 预检（不实际执行）
+npm run release:local -- --start-from=publish  # 从 publish 步骤重试
+```
+
+### 5. 刷新本地 marketplace 缓存（CI 已自动完成，手动备用）
 ```bash
 claude plugin marketplace update ultrapower
 ```
 > 推送到 GitHub 后必须执行此步，否则本地安装器仍读取旧版 `marketplace.json`。
 
-### 6. 发布到 npm
+### 6. 发布到 npm（CI 已自动完成，手动备用）
 ```bash
 npm publish --access public
 ```
 > ⚠️ npm 不允许覆盖已发布版本，版本号必须先升级再发布。
 
-### 7. 创建 GitHub Release
+### 7. 创建 GitHub Release（CI 已自动完成，手动备用）
 ```bash
 gh release create v<version> --title "v<version> - <title>" --notes "<release notes>"
 ```

package/skills/requesting-code-review/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/requesting-code-review/
+
+## Purpose
+请求代码审查 skill。完成任务或合并前使用，验证工作是否满足需求和质量标准。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/review/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/review/
+
+## Purpose
+审查 skill。/plan --review 的别名，对现有计划进行批判性审查和改进建议。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/sciomc/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/sciomc/
+
+## Purpose
+科学分析 skill。编排并行 scientist agent 进行综合分析，支持 AUTO 模式自动选择分析策略。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/security-review/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/security-review/
+
+## Purpose
+安全审查 skill。触发 security-reviewer agent 对代码运行全面安全审查，检测 OWASP Top 10 漏洞。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/skill/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/skill/
+
+## Purpose
+Skill 管理 skill。管理本地 skill——列出、添加、删除、搜索、编辑、设置向导。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/subagent-driven-development/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/subagent-driven-development/
+
+## Purpose
+子 agent 驱动开发 skill。在当前 session 中执行包含独立任务的实施计划。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/swarm/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/swarm/
+
+## Purpose
+Swarm skill。N 个协调 agent 共享任务列表，team 的兼容性外观，保留 /swarm 语法。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/systematic-debugging/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/systematic-debugging/
+
+## Purpose
+系统化调试 skill。遇到 bug、测试失败或意外行为时使用，在提出修复方案之前进行系统分析。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/team/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/team/
+
+## Purpose
+Team skill。N 个协调 agent 使用 Claude Code 原生 team 工具共享任务列表，支持阶段感知路由。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/test-driven-development/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/test-driven-development/
+
+## Purpose
+测试驱动开发 skill。实现任何功能或 bug 修复时使用，在编写实现代码之前先编写测试。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/trace/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/trace/
+
+## Purpose
+追踪 skill。显示 agent 流程追踪时间线和摘要，用于调试和性能分析。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->