@liangjie559567/ultrapower 5.2.2 → 5.2.4

package/skills/omc-setup/SKILL.md

@@ -382,6 +382,40 @@ claude plugin install ultrapower
 
 > ⚠️ 仅清除插件缓存不够，必须同时清除 `npm-cache`。
 
+## 步骤 3.55：同步 installed_plugins.json 注册表
+
+检测并修复 `installed_plugins.json` 中的版本漂移问题（k-046）。
+
+**背景**：本地开发安装后，`~/.claude/plugins/installed_plugins.json` 中的 `installPath` 可能仍指向旧 npm 缓存路径，导致 hook 文件 `MODULE_NOT_FOUND`。
+
+```bash
+node -e "
+const p=require('path'),f=require('fs'),h=require('os').homedir();
+const d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');
+const pluginsJson=p.join(d,'plugins','installed_plugins.json');
+if(f.existsSync(pluginsJson)===false){console.log('installed_plugins.json not found');process.exit(0);}
+let data;
+try{data=JSON.parse(f.readFileSync(pluginsJson,'utf-8'));}catch(e){console.log('Parse error:',e.message);process.exit(0);}
+const key=data.ultrapower?'ultrapower':'@liangjie559567/ultrapower';
+const entry=data[key];
+if(entry==null){console.log('ultrapower not in installed_plugins.json');process.exit(0);}
+const installPath=entry.installPath||'';
+const isNpmCache=installPath.includes('npm-cache')||installPath.includes('plugins/cache');
+if(isNpmCache===false){console.log('installPath OK (local dev):',installPath);process.exit(0);}
+const cacheBase=p.join(d,'plugins','cache','omc','ultrapower');
+let bestPath='';
+try{const vs=f.readdirSync(cacheBase).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));if(vs.length)bestPath=p.join(cacheBase,vs[vs.length-1]);}catch{}
+if(bestPath===''){console.log('No local cache path found, skipping');process.exit(0);}
+let newVersion=entry.version||'';
+try{newVersion=JSON.parse(f.readFileSync(p.join(bestPath,'package.json'),'utf-8')).version||newVersion;}catch{}
+data[key].installPath=bestPath;data[key].version=newVersion;
+f.writeFileSync(pluginsJson,JSON.stringify(data,null,2));
+console.log('✅ installed_plugins.json synced — installPath:',bestPath,'version:',newVersion);
+"
+```
+
+> ⚠️ 此步骤仅在 `installPath` 指向 npm 缓存路径时才修改注册表。
+
 ## 步骤 3.6：检查更新
 
 如果有新版本可用，通知用户：
@@ -746,6 +780,40 @@ claude plugin install ultrapower
 
 > ⚠️ 仅清除插件缓存不够，必须同时清除 `npm-cache`。
 
+## 步骤 3.55：同步 installed_plugins.json 注册表
+
+检测并修复 `installed_plugins.json` 中的版本漂移问题（k-046）。
+
+**背景**：本地开发安装后，`~/.claude/plugins/installed_plugins.json` 中的 `installPath` 可能仍指向旧 npm 缓存路径，导致 hook 文件 `MODULE_NOT_FOUND`。
+
+```bash
+node -e "
+const p=require('path'),f=require('fs'),h=require('os').homedir();
+const d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');
+const pluginsJson=p.join(d,'plugins','installed_plugins.json');
+if(f.existsSync(pluginsJson)===false){console.log('installed_plugins.json not found');process.exit(0);}
+let data;
+try{data=JSON.parse(f.readFileSync(pluginsJson,'utf-8'));}catch(e){console.log('Parse error:',e.message);process.exit(0);}
+const key=data.ultrapower?'ultrapower':'@liangjie559567/ultrapower';
+const entry=data[key];
+if(entry==null){console.log('ultrapower not in installed_plugins.json');process.exit(0);}
+const installPath=entry.installPath||'';
+const isNpmCache=installPath.includes('npm-cache')||installPath.includes('plugins/cache');
+if(isNpmCache===false){console.log('installPath OK (local dev):',installPath);process.exit(0);}
+const cacheBase=p.join(d,'plugins','cache','omc','ultrapower');
+let bestPath='';
+try{const vs=f.readdirSync(cacheBase).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));if(vs.length)bestPath=p.join(cacheBase,vs[vs.length-1]);}catch{}
+if(bestPath===''){console.log('No local cache path found, skipping');process.exit(0);}
+let newVersion=entry.version||'';
+try{newVersion=JSON.parse(f.readFileSync(p.join(bestPath,'package.json'),'utf-8')).version||newVersion;}catch{}
+data[key].installPath=bestPath;data[key].version=newVersion;
+f.writeFileSync(pluginsJson,JSON.stringify(data,null,2));
+console.log('✅ installed_plugins.json synced — installPath:',bestPath,'version:',newVersion);
+"
+```
+
+> ⚠️ 此步骤仅在 `installPath` 指向 npm 缓存路径时才修改注册表。
+
 ## 步骤 3.6：检查更新
 
 如果有新版本可用，通知用户：

package/skills/pipeline/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/pipeline/
+
+## 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: -->

package/skills/plan/AGENTS.md

@@ -0,0 +1,28 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/plan/
+
+## Purpose
+规划 skill。通过可选访谈工作流进行战略规划，支持 --consensus 和 --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/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

@@ -33,6 +33,7 @@ description: ultrapower 的自动化发布工作流
 > ⚠️ `marketplace.json` 是安装器读取的入口，版本不同步会导致用户始终安装旧版本。
 > ⚠️ `docs/CLAUDE.md` 是 `/ultrapower:omc-setup` 下载的模板，版本不同步会导致用户安装后显示旧版本号。
 > ⚠️ `CLAUDE.md` 是开发规范文档，版本引用不同步会导致开发者参考错误的规范版本。
+> ⚠️ `docs/REFERENCE.md` 存在两处数量声明（TOC 第 12 行 + 正文第 280 行），新增 skill/agent/hook 时必须同步更新两处，否则会出现文档内部不一致（k-047）。
 
 ### 2. 运行测试
 ```bash
@@ -86,6 +87,7 @@ gh release create v<version> --title "v<version> - <title>" --notes "<release no
 | `docs/CLAUDE.md` | `<!-- OMC:VERSION:X.Y.Z -->` |
 | `CLAUDE.md` | `ultrapower vX.Y.Z 规范体系位于 \`docs/standards/\`` |
 | `README.md` | 标题 + 版本徽章 |
+| `docs/REFERENCE.md` | TOC 第 12 行 `[Skills (N Total)]` + 正文 `## Skills（共 N 个）` 两处数量必须一致 |
 
 ## 语义化版本
 

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: -->