Imported from ymkz/harness (
AGENTS.md). Install upstream withnpx skills add ymkz/harness. Copyright stays with the author.
AGENTS.md
このリポジトリの位置づけ
このリポジトリ(harness)は、~/.agents/skills/ や ~/.codex/ などのグローバル設定を管理・配布するためのAPMパッケージのソースです。作業用のプロジェクトではありません。
絶対にしないこと
- リポジトリ内で素の
apm install/apm updateを実行しない。 デプロイ成果物が.agents/skills/や.codex/に展開され、グローバル側と重複する。グローバルに反映するときは必ず--globalを付ける。 - 生成物(
.agents/、.codex/、apm_modules/)をコミットしない。 これらは.gitignore済みのデプロイ成果物であり、ソースではない。 - 手書きのスキルをこのリポジトリにコピーしない。
~/.agents/skills/側を正とする。
スキルの追加・更新
- 外部スキルは
apm.ymlの dependencies に追加し、apm install <パッケージ指定> --globalでグローバルへ反映する- 注意:
apm install --global(引数なし)はプロジェクトのapm.ymlではなく~/.apm/apm.ymlを読むため、apm.ymlに追加しただけの依存はエラーなく無視される apm install <owner/repo/.../skill> --globalを実行すると~/.apm/apm.ymlも自動更新され、以降は引数なしの--globalでも解決される- 実行後は
ls ~/.agents/skills/で配置を必ず確認する
- 注意:
- 手書きスキルは
~/.agents/skills/に直接置く(このリポジトリでは管理しない) - 設定ファイルの再生成は
apm compile --global
