はじめて AI エージェント向けの CLI ツールを作ってみて気づいたこと

最近、Claude Code から使うことを前提にした小さな CLI ツールを Go でつくりました。 きっかけは「過去に似た実装がないか、複数のリポジトリを横断して探したい」という場面がちょこちょこ出てきたことです。 GitHub を毎回探しに行くのが地味に大変だったので、自然言語で投げたら良い感じに探してくれるとうれし〜と思ったのがはじまりでした。 で、実際につくってみると人間向けの CLI とは違う設計判断があり面白いな〜と思ったので、気づいたことをまとめてみます。 1. Skill の内容は CLI への参照だけに留めて、使い方は CLI に同梱する Claude Code 用に Skill を書くとき、ツールの説明をこんな感じで Skill ファイルに書きたくなります。 --- name: super-cli-tool description: ... --- super-cli