Skills · Claude Code · Agent Skills
シェルスクリプトは本番コードです。交渉の余地はありません。
シェルの最低基準です。strict mode、ゲートとしての shellcheck、eval 禁止、契約としての終了コード、trap と mktemp を求めます。インストーラは環境に適応し、実行した人を責めません。
schematize-shell · v0.4.0bash
$ schematize install shell譲れない最低基準
「速くするため」に外すことはありません。完全な一覧はスキル内にあります。
strict mode か、明記した例外
実行可能なスクリプトはすべて set -euo pipefail。正当な例外はコメントで宣言した場合のみ有効です。
shellcheck はゲート
--severity=warning でマージを止めます。抑制するには、その行に理由付きの shellcheck disable が必要です。
eval は禁止
eval や、外部データから組み立てた文字列での bash -c は禁止です。コマンドは配列で組み立て、case で振り分けます。
終了コードは契約
0 は成功、1 は不合格、2 は検証できなかったことを意味します。何も検査せずに 0 を返してはいけません。
trap と mktemp
trap は EXIT INT TERM で後始末を行い、一時ファイルは mktemp で作ります。/tmp の予測可能な名前は使いません。
冪等性とクォート
二度実行しても同じ結果になり、すべての展開はクォートし、ls の出力はパースしません。
環境に適応するインストーラ
sudo 配下の実ユーザー、パッケージマネージャ、既存の状態を検出し、失敗時は今すべきことを伝えます。秘密情報はコマンド引数に渡しません。
コマンド
.claude/commands/ にインストールされます。いつでも /shell-help を実行できます。
/shell-ccコンテキスト圧縮:ハンドオフ(コンテキスト+チェックリスト)をアーカイブに書き出し、/compact を実行します。/shell-claudeschematize-shell の常時有効な CLAUDE.md をリポジトリ直下に作成またはマージします。他スキルのブロックは上書きしません。/shell-handoff圧縮せずにコンテキストのハンドオフをアーカイブに書き出します。セッション終了やタスク切り替え時に使います。/shell-helpスキルの全コマンドを一覧表示します。/shell-loadschematize-shell の規範本体をすべて強制ロードし、セッション中適用します。/shell-review.sh(新規・既存)を基準に照らしてレビューします。ゲートを実行し、機械が読めない点を読みます。AIエージェント向け
人手を介さずにインストールできます。メタデータは llms.txt にあります。
- 実行:git clone https://github.com/schematizeme/skill-shell.git && ./skill-shell/install.sh
- または https://github.com/schematizeme/skill-shell/releases/latest/download/skill-shell.zip をダウンロードして .claude/skills/ に展開します。
- assets/CLAUDE.md をリポジトリ直下にコピーします(常時有効ルール)。
- /shell-help で確認します。
ディスカッション
読み込み中…