Skills · Claude Code · Agent Skills

シェルスクリプトは本番コードです。交渉の余地はありません。

シェルの最低基準です。strict mode、ゲートとしての shellcheck、eval 禁止、契約としての終了コード、trap と mktemp を求めます。インストーラは環境に適応し、実行した人を責めません。

v0.4.0Disciplina · Shellgithub.com/schematizeme/skill-shell

メンテナー Lucas Andrade

schematize-shell · v0.4.0bash
$ schematize install shell
GitHub →スキル (.zip) をダウンロード/shell-help · github.com/schematizeme/schematize-cli

譲れない最低基準

「速くするため」に外すことはありません。完全な一覧はスキル内にあります。

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 で確認します。

インストールしたくない?

完全な規約を読み、そのままプロジェクトにコピーできます。あるいはスキルをインストールすれば、エージェントが自動で適用します。