Skills · Claude Code · Agent Skills

期限内に応答し、prd 以外では沈黙するボット。交渉の余地はありません。

トークンは金庫に置き、すべてのインタラクションを署名で検証し、プラットフォームの期限内に ack を返して残りはキューで処理し、429 に対応し、権限は最小限にします。本番以外で実メッセージは送りません。

v0.1.0Disciplina · Bots de chatgithub.com/schematizeme/skill-bots

メンテナー Lucas Andrade

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

譲れない最低基準

「速くするため」に外すことはできません。全リストはスキルをご覧ください。

prd 以外で実メッセージを送らない

テスト用のサーバー、ワークスペース、チャンネル、番号を使います。環境が未設定なら prd 以外とみなし、本番トークンは prd にだけ置きます。

トークンは秘密情報

環境ごとに金庫で管理し、リポジトリ、イメージ、ログ、URL には置きません。漏えい時はまずローテーションし、履歴の消去は後です。

何より先に署名を検証

Discord は Ed25519、Telegram は secret_token、Slack は再送ウィンドウ付き signing secret、WhatsApp は X-Hub-Signature-256。失敗は 401 です。

期限内に ack、残りはキュー

プラットフォームの期限内(Discord なら 3 秒など)に応答し、残りはキューで処理します。遅い応答はインタラクションのトークンを失います。

レート制限を守る

ヘッダーを読み、429 は Retry-After に従い、ジッタ付きバックオフと送信キューを使います。429 を無視する送信ループは作りません。

冪等性

update_id、インタラクション ID、event_id、メッセージ ID で重複排除します。プラットフォームのリトライは通常動作です。

intent と権限は最小限

特権 intent は理由を記録した場合のみ。ボットの権限を Administrator にしません。

ユーザー入力は信用しない

allowed_mentions を制限し、markdown をエスケープし、許可リストなしでリンクを解決せず、破壊的コマンドはサーバー側で権限を確認します。

コマンド

.claude/commands/ にインストールされます。いつでも /bot-help を実行できます。

/bot-ccContext compact: handoff をアーカイブに書き出し、/compact を実行します。
/bot-claudeボットの基本ルールを定めた常時有効な CLAUDE.md をリポジトリのルートに作成またはマージします(他のスキルのブロックは上書きしません)。
/bot-commandsスラッシュコマンド、intent、最小権限をバージョン管理されたレジストリとして設計します。
/bot-handoffコンテキストの handoff(context.md + checklist.md)を、圧縮せずにアーカイブへ出力します。
/bot-helpすべてのコマンドと、それぞれの役割を一覧表示します。
/bot-loadボットの規範を強制的にすべて読み込み、このセッションで適用します。
/bot-moderationボットのモデレーション、不正利用対策、メンション、リンク、メッセージのプライバシーを設計します。
/bot-new新しいボットの雛形を作ります。最初のハンドラの前に、プラットフォーム、トランスポート、トークン、コマンド、環境、ゲートを整えます。
/bot-reviewボットを基準に照らしてレビューします。ゲートを実行し、機械では読めない部分を人が読みます。
/bot-webhookボットのインタラクション/Webhook 受信側を作成または監査します。署名、再送、ack、キュー、重複排除を扱います。

AIエージェント向け

人手を介さずにインストールできます。メタデータは llms.txt にあります。

  • 実行: git clone https://github.com/schematizeme/skill-bots.git && ./skill-bots/install.sh
  • またはダウンロード: https://github.com/schematizeme/skill-bots/releases/latest/download/skill-bots.zip を .claude/skills/ に展開
  • assets/CLAUDE.md をリポジトリのルートにコピー(常時オンのルール)。
  • /bot-help で確認。

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

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