harness について
Harnessは、リポジトリを中心にプロジェクト状態を保存し、複数セッションにまたがる作業を導くスキルです。進捗や機能のファイルで優先度、検証証拠、引き継ぎを管理し、リポジトリ固有のルールを優先します。
主な機能
- 01リポジトリ内ファイルへの進捗記録
- 02機能と検証証拠の追跡
- 03セッション状態からの作業再開
- 04リポジトリ固有ルールの順守
- 05完了報告の独立検証
活用シーン
- 01永続的なプロジェクト管理の設定
- 02新しいセッションで未完了作業を再開
- 03記録した証拠による機能完了の検証
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ tomgrv/ devcontainer-features --skill harnessインストール後、Claude Code で/harnessを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
templates/clean-state-checklist.mdsession-handoff.mdprogress.mdfeatures.json詳細
リポジトリが唯一の信頼できる記録です。チャットはそうではありません。セッションをまたいで残す必要がある状態はファイルに保存します。新しいセッションでは、推測するのではなく、ファイルを読んで状態を復元します。Learn Harness Engineering に基づいています。
初期化(リポジトリごとに一度。すでに存在するファイルはスキップ)
このファイルの隣にある templates/ からコピーして、内容を調整します。プレースホルダーを残さないでください。
.agents/progress.md— セッションログと、現在検証済みの状態。.agents/features.json— ユーザーに見えるすべての機能について、id、priority、status、verificationの手順、evidenceを記載します。リポジトリの README、issues、コードに基づく実際の機能を記載し、すべてnot_startedから開始します。- 大規模なセッションでは省略可能です。
templates/session-handoff.mdを.agents/handoff.mdにコピーします。
依存関係はここではなく devcontainer の機能によってインストールされます。基準となるのは、リポジトリの開発フォージ(GitHub、GitLab、Azure DevOps)上の CI ステータスで、フックがそれを表示します。各機能の実際の検証手順を .agents/features.json に記載します。これらのファイルをまとめて一度にコミットします。.agents/progress.md または .agents/features.json が存在すると、SessionStart フックが状態を表示し、Stop フックが引き継ぎを確認します。
セッション開始
pwd— リポジトリのルートであることを確認します。- リポジトリ独自のルールを読みます。
CLAUDE.md、AGENTS.md、.agents/instructions/*.instructions.md(存在するファイルはSessionStartフックが一覧表示します)。コミット形式、PR のベースとタイトル、スコープの制限、ツールに関するルールは、引き続きこれらが優先されます。ハーネスはその周りにループを加えるだけで、上書きすることはありません。 .agents/progress.mdを読んでから、.agents/features.jsonを読みます。git log --oneline -5。SessionStartフックがすでに状態と、ブランチのフォージ CI ステータスを表示しています。- ブランチの CI が失敗していますか?それが基準状態です。まず修正してください。開始時点で壊れている状態のまま、新しい作業を始めないでください。
- 未完了の機能のうち、優先度が最も高いものを選びます。その機能を
in_progressに設定します。一度に一つだけ進めてください。
作業中
- 作業中はリポジトリのルール(最小限の変更を徹底すること、コミット/PR の形式、CI の命名規則)に従ってください。ハーネスのルールと競合する場合はリポジトリのルールを優先し、その内容を進捗ログに記録します。
- 選択した機能の範囲内で作業してください。ブロッカーがある場合に限り、範囲を絞ったサポート修正が認められることがあります。
passingにするには、その機能のverification手順を実際に実行し、証拠(「問題なさそう」ではなく、コマンドと結果)を記録する必要があります。- 合格させるために、機能やテストの文言を変更、削除、または弱体化してはいけません。機能の作業中に検証条件を緩めてはいけません。
- 完了と判断しましたか?
harness-evaluatorエージェントを実行します。新しいコンテキストで、その完了の主張に反証を試みます。
セッション終了
.agents/progress.mdを更新します。検証済みの状態、実行した内容、証拠、既知のリスク、次に行う最善の手順を記録します。.agents/features.jsonのステータスと証拠を更新します。templates/clean-state-checklist.mdの項目を一つずつ確認します。- リポジトリのルールにあるコミットと PR の規約に従い、作業を再開できる安全な状態になったらコミットします。ブランチの CI は成功しているか、その理由が進捗ログに記載されている必要があります。次のセッションは手動修復なしで開始できなければなりません。
境界
機能、証拠、検証結果を捏造してはいけません。実行せずに passing にしてはいけません。リストを編集して未完了の作業を隠してはいけません。