Skip to content

知らない分野を、原文にたどりつくまで芋づる式に掘る Claude Code のスキル

Python

docs: Codex CLIでの入れ方と呼び方をREADMEに追加する

Nagi-Inaba7ab86eff2b83
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 94ed2cf..b9b37f6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ mainにコミットが入るたびに、使っている人へ更新が届きま
### 追加
+- Codex CLIでの入れ方と呼び方を、日本語・英語のREADMEに追加しました。
- ダッシュボードで文書を開くとき、読み込みに0.8秒以上かかると、枠の中に「読み込んでいます」の札を出すようにしました。これまでは読み込み中もサーバーが止まっているときも枠が白いままで、どちらなのか見分けられませんでした。
- 文書を開けなかったときは、札に理由と次の行動を出します。理由は「サーバーが止まっている」「PCに届かない」「合言葉を確かめられない」「文書が見つからない」に分けます。札のボタンで読み直せます。
- 10秒を超えても読み終わらないときは、サーバーが動いているかを確かめてから、まだ読み込んでいるのか止まっているのかを札に出します。
diff --git a/README.en.md b/README.en.md
index 5540f6b..0f113db 100644
--- a/README.en.md
+++ b/README.en.md
@@ -71,6 +71,44 @@ npx skills add MaryCache/imozuru
To install by hand, copy `skills/imozuru/` to `~/.claude/skills/imozuru/`.
+### Codex CLI
+
+Copy `skills/imozuru/` to `~/.agents/skills/imozuru/`, or link it there.
+To use it in just one repository, put it in that repository's `.agents/skills/imozuru/`.
+
+On macOS / Linux, you can create a link like this.
+
+```sh
+git clone https://github.com/MaryCache/imozuru ~/src/imozuru
+mkdir -p ~/.agents/skills && ln -s ~/src/imozuru/skills/imozuru ~/.agents/skills/imozuru
+```
+
+On Windows (PowerShell), replace `<clone-path>` with the absolute path to your clone.
+Creating a junction does not require administrator rights.
+
+```powershell
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
+New-Item -ItemType Junction -Path "$env:USERPROFILE\.agents\skills\imozuru" -Target "<clone-path>\skills\imozuru"
+```
+
+If you installed with a link, run `git pull` in the clone to update.
+
+In Codex's interactive screen, use `$imozuru` instead of `/imozuru`.
+You can list skills with `/skills`, and Codex can also select the skill automatically when a request matches its description.
+
+```text
+$imozuru dig into this field: state management in React
+$imozuru watch react
+```
+
+Use `codex exec` to run without the interactive screen.
+Web search and network access for the scripts that fetch sources are needed.
+This example enables both and saves results to `./research/react/` inside the working directory.
+
+```sh
+codex --search exec -s workspace-write -c sandbox_workspace_write.network_access=true '$imozuru dig into this field: state management in React. Save results to ./research/react'
+```
+
## Requirements
The scripts run on the Python 3.10+ standard library alone, and use the following commands when they are installed.
@@ -87,7 +125,7 @@ The scripts run on the Python 3.10+ standard library alone, and use the followin
## Usage
-Ask Claude Code something like this.
+Ask Claude Code something like this. In Codex CLI, you can prefix the request with `$imozuru`.
```
芋づる式に調べて: 歌ってみたの MIX で、上手い人がどういう順番で処理しているか
diff --git a/README.md b/README.md
index 301885e..37bc352 100644
--- a/README.md
+++ b/README.md
@@ -68,6 +68,44 @@ npx skills add MaryCache/imozuru
手動の場合は、`skills/imozuru/` を `~/.claude/skills/imozuru/` にコピーしてください。
+### Codex CLI
+
+`skills/imozuru/` を `~/.agents/skills/imozuru/` にコピーするか、リンクを作ります。
+リポジトリごとに使いたい場合は、そのリポジトリの `.agents/skills/imozuru/` に置いてください。
+
+macOS / Linuxでは、次のようにリンクを作れます。
+
+```sh
+git clone https://github.com/MaryCache/imozuru ~/src/imozuru
+mkdir -p ~/.agents/skills && ln -s ~/src/imozuru/skills/imozuru ~/.agents/skills/imozuru
+```
+
+Windows(PowerShell)では、`<clone先>` をcloneした場所の絶対パスに置き換えてください。
+ジャンクションは管理者権限なしで作れます。
+
+```powershell
+New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
+New-Item -ItemType Junction -Path "$env:USERPROFILE\.agents\skills\imozuru" -Target "<clone先>\skills\imozuru"
+```
+
+リンクで入れた場合は、clone先で `git pull` を実行すると更新できます。
+
+Codexの対話画面では、`/imozuru` の代わりに `$imozuru` を使います。
+一覧は `/skills` で見られ、スキルの説明に合う頼み方なら自動でも選ばれます。
+
+```text
+$imozuru 芋づる式に調べて: Reactの状態管理
+$imozuru watch react
+```
+
+対話画面を開かずに動かすときは `codex exec` を使います。
+Web検索と、原文を取得するスクリプトのネットワーク接続が必要です。
+次の例は両方を有効にし、結果を作業フォルダ内の `./research/react/` に保存します。
+
+```sh
+codex --search exec -s workspace-write -c sandbox_workspace_write.network_access=true '$imozuru 芋づる式に調べて: Reactの状態管理。保存先は ./research/react にして'
+```
+
## 必要なもの
スクリプトはPython 3.10以上の標準ライブラリだけで動き、次のコマンドは入っていれば使います。
@@ -84,7 +122,7 @@ npx skills add MaryCache/imozuru
## 使い方
-Claude Codeで、次のように頼みます。
+Claude Codeで、次のように頼みます。Codex CLIでは、頼み方の先頭に `$imozuru` を付けられます。
```
芋づる式に調べて: 歌ってみたのMIXで、上手い人がどういう順番で処理しているか