mcpField
S
skill-installer

skill-installer

github.com/codeartsagentAgent 工作流541 次安装12 周前更新
代码仓库

关于 skill-installer

skill-installer 是管理 CodeArts 技能和工具安装器的统一入口。它会先校验目标、命令和作用域是否受支持，再交由对应的适配模块执行。

主要功能

  1. 01列出受支持的目标
  2. 02初始化、更新和删除目标
  3. 03检查目标状态
  4. 04自动识别项目或用户作用域
  5. 05执行前校验目标能力

适用场景

  1. 01为项目安装 OpenSpec 技能
  2. 02从源更新受支持的目标
  3. 03检查各目标的安装状态
  4. 04移除已安装的目标

MCP 相关

office-mcp 目标会安装 MCP 服务、对应技能和 MCP 配置。安装器也能与其他受支持目标一并管理它。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/codeartsagent/codeartsskills --skill skill-installer

安装后在 Claude Code 中输入/skill-installer确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

assets/manifests/
.gitignore
scripts/
installer.js
scripts/lib/
exec.js
manifest.js
paths.js
status-file.js
scripts/targets/
azure-devops-cli.js
index.js
office-mcp.js
openspec.js
playwright-cli.js
superpowers.js

详细介绍

Skill 安装器

CodeArts 所有 Skill/工具安装器的统一入口。通过 --target <name>（或位置参数）传入目标名称，并指定命令（init/update/delete/status）。分发器会先验证各目标支持的作用范围和命令，再调用对应目标的适配器。

这是 CodeArts 唯一公开的安装器 Skill。四个独立安装器（superpowers-installer、office-mcp-installer、playwright-cli-installer、openspec-installer）已整合为 scripts/targets/ 下的内部适配器模块。

快速开始

node scripts/installer.js list                              # list supported targets
node scripts/installer.js init   --target openspec         # install a target (auto-detect scope)
node scripts/installer.js status --target openspec         # status of one target
node scripts/installer.js status                           # status of all targets
node scripts/installer.js delete --target openspec         # uninstall a target

位置参数简写：init openspec ≡ init --target openspec。

命令

命令描述
list列出支持的目标及其作用范围、命令和描述
init --target <name>将目标安装到解析出的作用范围中
update --target <name>从最新来源重新生成/刷新目标
delete --target <name>卸载目标（进行清理；适用时通过清单跟踪）
status [--target <name>]检查单个目标的运行状况；若省略 --target，则检查所有目标

支持的目标

目标作用范围命令安装内容
superpowersproject、userinit、update、delete14 个 Superpowers Skill（头脑风暴、TDD、调试，……）+ 引导程序
office-mcpprojectinit、update、delete、statusMCP 服务（39 个 Word/Excel/PPT/PDF/OCR 工具）+ Skill + MCP 配置
playwright-cliproject、userinit、update、delete、statusplaywright-cli Skill + @playwright/cli + chromium 浏览器
openspecproject、userinit、update、delete、statusOpenSpec SDD Skill（propose/explore/apply/sync/archive）

能力校验会提前拒绝不支持的组合——例如，init --target office-mcp --user 会报错（“office-mcp 仅支持 project 作用范围”）；status --target superpowers 会报错（“superpowers 没有 status 命令”）。

作用范围

标志作用范围Skill 路径状态文件
--project单个项目<project>/.codeartsdoer/skills/ProjectSkillStatus.txt
--user所有项目~/.codeartsdoer/skills/UserSkillStatus.txt
(省略)自动检测若当前工作目录中存在 .codeartsdoer/，则为项目；否则为用户—

此外，你也可以使用自然语言让此 Skill 为你安装/更新/删除任何受支持的目标——只需说出目标名称（例如，“install openspec”“更新 office-mcp”“uninstall superpowers”）。

要求

Node.js（openspec 需 ≥ 20.19.0；其他情况需 ≥ 18）、npm 和 git——这些都是 CodeArts 已要求的依赖。各个目标可能会安装全局软件包（openspec CLI、@playwright/cli）或自动下载浏览器。支持 Windows、Linux 和 macOS。

目录结构

skill-installer/
├── SKILL.md
├── scripts/
│   ├── installer.js          # dispatcher: parse, validate capabilities, delegate
│   ├── lib/                  # shared helpers (exec, paths, status-file, manifest)
│   └── targets/              # one adapter per target
│       ├── index.js
│       ├── superpowers.js
│       ├── office-mcp.js
│       ├── playwright-cli.js
│       └── openspec.js
└── assets/manifests/         # runtime manifests (gitignored)

评论

支持 Markdown