調整したばかりの手順を DeepSeek Harness のスキルにする

プロジェクトの中に置きます。.agents/skills/<skill-name>/SKILL.md です。動画では声に出して説明されています。スキルはプロジェクトルート配下のこのパスから発見され、ランクはプロジェクトスコープ。あの回で作られた commit スキルは .agents/skills/commit/SKILL.md に着地し、補助スクリプトはその隣、.agents/skills/commit/scripts/check-commit-safety.sh にあります。

しません。セッション自身の報告が「スキルは有効になり、即座にこのセッションのスキルカタログに現れた」というもので、返信ストリームではファイル書き込みの直後に Context injection · skill-catalog の行が来ています。ファイルが着地した時点でカタログが読み直されているわけです。プラグインのインストールとは正反対で、あちらはサービスの再起動と強制再読込が必要になります。

name は呼び出しに使う識別子で、この例では commit です。description は何をして何を拒否するかを 1 行で書きます。Make a git commit of all working changes with a concise bulleted message; never pushes or deploys. whenToUse がトリガーの文で、ユーザーが実際に打つ言い回しを並べます。asks to commit changes、make a commit、check in work、wrap up a task など。この 3 つは関連度を判定するために読まれるので、フォルダを覗く人間ではなくモデルに向けて書きます。

構いません。動画の要点もそこです。スキルは大した仕組みではなく、Markdown のファイルに過ぎず、リポジトリに既にあるスキルフォルダはフォーマットが合えばそのまま読めます。フォーマットが違うなら指示を出すか形式を合わせることになります。頼む方が速く、たいてい丁寧に仕上がるので — 番号付きステップ、引用されたコマンド、ルール欄が揃ってきます — どちらでも構いませんが、あとから必ずファイルを開いて読んでください。あのファイルが契約書です。

機械が yes / no を出せるステップです。秘密情報、ファイルサイズ、パスのパターン、ブールで決まるものは全部。あの回の構築では、健全性チェックが「status を眺めて怪しいものを探す」から、「exit 0 は安全、exit 1 はフラグ、exit 2 は環境エラー」というスクリプトに置き換わり、SKILL.md も判定はスクリプトが権威で、上書きできるのはユーザーだけ、という書き方になりました。同じ入力に同じ出力が出るかどうかが基準です。

セッションの中で 2 か所を見ます。カタログが変わると返信ストリームに Context injection · skill-catalog の行が出ます。エージェントがファイルを書いた／読んだときは、その返信の下の成果物チップに SKILL.md が名指しされます。挙動そのものは、ルールが拾うはずの入力を渡して確かめます。偽のキーを入れた .env などです。出力にファイル名と、どのルールで拾われたかが出ていれば通っています。「従いました」とだけ返すスキルは、何も証明していません。