shell-history について
shell-historyは、atuinで最近のシェルコマンドを検索するワークフロースキルです。履歴にタイムスタンプを付けてキーワードで絞り込み、結果が見つからない場合は検索期間を広げます。
主な機能
- 01タイムスタンプ付きatuin履歴の検索
- 02grepによるキーワード絞り込み
- 03検索期間を最大7日まで段階的に拡張
- 04検索した期間の報告
活用シーン
- 01最近実行したコマンドの検索
- 02アクセスしたURLやツール実行の確認
- 03過去に使ったフラグや引数の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ gkwa/ volcanicviper --skill shell-historyインストール後、Claude Code で/shell-historyを入力して読み込まれたか確認します。
同梱ファイルtile.json
詳細
シェル履歴の検索
ユーザーがシェル履歴から何かを探したい場合は、タイムスタンプ付きの atuin を使い、grep で絞り込みます。
標準的な実行方法
atuin search --after "<N> days ago" --format "{time} {command}"
デフォルトの <N> は 1 です。
ユーザーが日数を指定した場合は、その数を使います。日数を指定する例:
- 「過去 2 日間のシェル履歴を検索して」
- 「3 日分の履歴を確認して」
- 「過去 2 日間」
これにより、過去 N 日間のシェルコマンドが、タイムスタンプ付きで返されます。
キーワードによる絞り込み
次に、関連する用語(URL、ツール名、フラグなど)を grep で検索します。
各コマンドは個別の Bash 呼び出しとして実行してください。1 回の呼び出しでパイプを使ってコマンドを連結しないでください。
ステップ 1:ジョブディレクトリが利用可能な場合は、履歴を一時ファイルに保存します。利用できない場合は、/tmp 配下に一意のファイル名で保存します。
ステップ 2:そのファイル内でキーワードを grep で検索します。
検索期間の拡大
デフォルトの 1 日間の検索で有用な結果が見つからない場合は、2 日間、3 日間と順に拡大し、諦めるかユーザーに追加情報を尋ねるまで、最大 7 日間まで試します。
検索のたびに対象期間をユーザーに伝え、どこまで遡って調べたかがわかるようにします。
このスキルを使う場面
- ユーザーが「シェル履歴を確認して」「履歴を見て」「実行したコマンドを探して」と言った場合
- ユーザーが curl/wget でアクセスした URL や、最近実行したツールを探している場合
- ユーザーが過去のコマンドで使ったフラグや引数を尋ねた場合
コメント
Markdown 対応