AIコーディングエージェントに、再利用と最小限の実装を優先し、必要なコードだけを書かせるプロンプト型スキル。
wquguru/harness-books
Claude CodeやCodexなど、コードを書くモデルのエージェントハーネスの設計と制御を解説する無料のオンライン書籍2冊。
- スター
- 3,194
- フォーク
- 387
- 未解決の Issue
- 6
- 最終コミット
- 6 か月前
これは何?
Harness Booksは、ハーネスエンジニアリングに関する2冊の書籍です。ここでいうハーネスとは、コードを書くモデルがターミナル、リポジトリ、権限システム、チームのワークフロー内で動作するときに、そのモデルを制御する周辺システムを指します。書籍では、プロンプトの階層化、クエリループ、ツールの権限、コンテキストのガバナンス、エラーリカバリー、複数エージェントによる検証、チームのルールを取り上げ、システムの動作範囲を適切に制限し、説明責任を保つ方法を解説します。
1冊目の『A Design Guide to Claude Code』では、Claude Codeを題材に、ランタイムの構造を掘り下げ、コントロールプレーン、クエリループ、リカバリーパスといったコンポーネントがなぜシステムに加わるのかを説明します。2冊目の『The Harness Design Philosophies of Claude Code and Codex』では、2つのツールを比較し、サンドボックス、ポリシー言語、スキル、フックなど、実行制御の配置をそれぞれ検証します。
2冊とも英語と中国語でオンライン閲覧でき、PDFとしてダウンロードすることもできます。リポジトリには、サイトをローカルで生成するためのPythonビルドスクリプトも含まれています。
主な機能
- 01エージェントシステムにおけるクエリループ、ツールの権限、コンテキストのガバナンス、エラーリカバリーを解説します。
- 02コントロールプレーンの設計、サンドボックス、ポリシー言語についてClaude CodeとCodexを比較します。
- 03スキル、フック、ローカルルールによって、チームの慣習をエージェントシステムに反映する方法を解説します。
- 04英語と中国語でオンライン閲覧でき、PDFもダウンロードできます。
- 052言語対応の書籍サイトをローカルでビルドするPythonスクリプトが含まれています。
ユースケース
- 独自のコーディングエージェントを構築しており、その制御レイヤーを理解したい開発者。
- チームでAIコーディングツールをどのように管理するか検討しているエンジニアリングリード。
- ツールを選ぶ前にClaude CodeとCodexのアーキテクチャを比較したいエンジニア。
クイックスタート
- 1
書籍をオンラインで読む
- 2
書籍をローカルでビルドする(Book 1、英語)
python3 tools/book-kit/build_honkit.py book1-claude-code --locale en - 3
統合されたPagesサイトを構築する
python3 tools/book-kit/build_pages_site.py
使う前に知っておきたいこと
- このプロジェクトはソフトウェアではなく書籍のセットで、ライセンスは記載されていません。
- ローカルビルドにはPythonのビルドスクリプトの実行が必要で、出力先はdist/です。
トピック
よくある質問
- harness-books とは?
- Claude CodeやCodexなど、コードを書くモデルのエージェントハーネスの設計と制御を解説する無料のオンライン書籍2冊。 Harness Booksは、ハーネスエンジニアリングに関する2冊の書籍です。ここでいうハーネスとは、コードを書くモデルがターミナル、リポジトリ、権限システム、チームのワークフロー内で動作するときに、そのモデルを制御する周辺システムを指します。書籍では、プロンプトの階層化、クエリループ、ツールの権限、コンテキストのガバナンス、エラーリカバリー、複数エージェントによる検証、チームのルールを取り上げ、システムの動作範囲を適切に制限し、説明責任を保つ方法を解説します。
- harness-books は無料で使えますか?ライセンスは?
- harness-books にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。
- harness-books は今もメンテナンスされていますか?
- 半年以上コミットなし。harness-books の最終コミットは 2026年4月19日 です。
- harness-books は何に使えますか?
- 独自のコーディングエージェントを構築しており、その制御レイヤーを理解したい開発者。 チームでAIコーディングツールをどのように管理するか検討しているエンジニアリングリード。 ツールを選ぶ前にClaude CodeとCodexのアーキテクチャを比較したいエンジニア。
- harness-books のインストール方法は?
- 書籍をオンラインで読む 書籍をローカルでビルドする(Book 1、英語): python3 tools/book-kit/build_honkit.py book1-claude-code --locale en 統合されたPagesサイトを構築する: python3 tools/book-kit/build_pages_site.py
- harness-books はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/wquguru/harness-books
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIらしい文章の特徴を取り除き、小説の構成を整え、文書の種類に応じたルールを適用するポータブルなAgent Skill。
Claude CodeやCodexなどのコーディングエージェントを1つの会話に集めるVS Code拡張機能。
Claude Code、Claude.ai、Codex、Cursor、Gemini CLIなどのコーディングエージェント向けに、1000件以上のClaude Skillsとプラグインを厳選してまとめたディレクトリ。
AnthropicのClaude Codeを使うための、サブエージェント、コマンド、スキル、フック、メモリ、ワークフローを網羅した、厳選・継続更新型のベストプラクティスガイド兼リファレンス集。
Codex CLIやAPIでコーディング、生産性向上、データ関連のワークフローを自動化する実用的なCodexスキルをまとめた厳選GitHubリストです。