skill-installer

スキルインストーラー

CodeArts のすべてのスキル／ツールインストーラーを統合するエントリーポイントです。--target <name>（または位置引数）で対象名を渡し、コマンド（init／update／delete／status）を指定します。ディスパッチャーは実行前に、各対象がサポートするスコープとコマンドを検証し、その後、対象のアダプターに処理を委任します。

CodeArts に公開されるインストーラースキルはこれだけです。個別の4つのインストーラー（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>]	1つの対象、または --target を省略した場合はすべての対象の状態を確認します

サポート対象

対象	スコープ	コマンド	インストール内容
superpowers	project, user	init, update, delete	Superpowers スキル14種（ブレインストーミング、TDD、デバッグなど）＋ブートストラップ
office-mcp	project	init, update, delete, status	MCP サーバー（Word／Excel／PPT／PDF／OCR ツール39種）＋スキル＋MCP 設定
playwright-cli	project, user	init, update, delete, status	playwright-cli スキル＋@playwright/cli＋chromium ブラウザー
openspec	project, user	init, update, delete, status	OpenSpec の SDD スキル（propose／explore／apply／sync／archive）

機能の対応状況は事前に検証され、未対応の組み合わせは拒否されます。たとえば、init --target office-mcp --user はエラーになります（「office-mcp は project スコープのみをサポートします」）。status --target superpowers もエラーになります（「superpowers には status コマンドがありません」）。

スコープ

フラグ	スコープ	スキルのパス	ステータスファイル
--project	単一のプロジェクト	<project>/.codeartsdoer/skills/	ProjectSkillStatus.txt
--user	すべてのプロジェクト	~/.codeartsdoer/skills/	UserSkillStatus.txt
(omit)	自動検出	cwd に .codeartsdoer/ があればプロジェクト、なければユーザー	—

また、自然言語でこのスキルにサポート対象のインストール／更新／削除を依頼することもできます。対象名を指定してください（例：「openspec をインストール」「office-mcp を更新」「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)