用途：AgentSys 将 agent-sh 插件安装到 Claude Code、OpenCode、Codex CLI、Cursor 和 Kiro。插件位于各自仓库，本仓库负责市场清单、安装器、转换与文档。此技能用于定位跨平台问题所在位置及应运行的命令。
主要能力与位置：市场清单在 .claude-plugin/marketplace.json，每个插件按 tag 和 commit 固定，可用 node scripts/pin-marketplace.js [--dry-run] 重新固定（需 gh）。安装器在 bin/cli.js，含 installForClaude、installForOpenCode、installForCodex、installForCursor、installForKiro；Claude Code 从市场安装，其余平台将插件源码取到 ~/.agentsys/plugins/<name> 并转换。转换逻辑在 lib/adapter-transforms.js，lib/ 由 agent-sh/agent-core 同步，应在上游修改。适配器在 adapters/ 下，scripts/gen-adapters.js 保持生成文件最新。开发安装用 node bin/dev-cli.js dev-install [tool]。版本以 package.json 为准，npx agentsys-dev bump X.Y.Z 会更新多处文件。
平台差异：插件根路径在 Claude Code 为 ${CLAUDE_PLUGIN_ROOT}，OpenCode 与 Codex 为 ${PLUGIN_ROOT}，Cursor 与 Kiro 内联安装路径；require() 路径需规范化反斜杠。状态目录应使用 AI_STATE_DIR。OpenCode 默认剥离 model 字段，工具转为 permission 条目，AskUserQuestion 标签超过 30 字符会失败。Codex 无命令与代理，命令变为以 $name 调用的技能，技能描述需触发短语。Kiro 命令变为 ~/.kiro/prompts/ 中的提示，代理变为 JSON，技能目录整体复制到 ~/.kiro/skills/<name>/。
检查命令：npm run validate、npm test、npm run gen-docs:check、node scripts/expand-templates.js --check、node scripts/gen-adapters.js --check、npx agentsys-dev preflight [--all|--release]、node bin/dev-cli.js validate opencode-install、npm pack --dry-run。发布前需冒烟测试安装器。若技能或清单与代码不符，应在同一次变更中修复。限制：具体平台配置格式、frontmatter、环境变量与标签限制以 checklists/cross-platform-compatibility.md、docs/CROSS_PLATFORM.md、checklists/release.md 和 agent-docs/release.md 为准，资料未提供其完整内容。