harness-engineering-zh
AIエージェントが効率的に機能するよう、コードベースの設計や改善を行い、エージェントの出力品質に関する問題を解決するためのSkill。
📜 元の英語説明(参考)
为 AI Agent 友好的代码库搭建和改进 Harness 工程（包括 AGENTS.md、docs/、Lint 规则、Eval 系统、项目级 Prompt 工程）。触发场景：为 AI Agent 设置新项目/空项目，创建 AGENTS.md 或 CLAUDE.md，关于 Harness 工程的问题，让 Agent 在代码库上更高效地工作。当用户感到沮丧或抱怨 Agent 质量时也会触发（例如：'Agent 总是无视规范'、'它从不听从指令'、'为什么它总是做错 X'、'Agent 坏了'）— 因为 Agent 输出质量差几乎总是意味着 Harness 缺失，而不是模型问题。涵盖：Context 工程、架构约束、多 Agent 协作、评估、长运行任务 Harness 以及 Agent 质量问题诊断。
🇯🇵 日本人クリエイター向け解説
AIエージェントが効率的に機能するよう、コードベースの設計や改善を行い、エージェントの出力品質に関する問題を解決するためのSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o harness-engineering-zh.zip https://jpskill.com/download/6037.zip && unzip -o harness-engineering-zh.zip && rm harness-engineering-zh.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/6037.zip -OutFile "$d\harness-engineering-zh.zip"; Expand-Archive "$d\harness-engineering-zh.zip" -DestinationPath $d -Force; ri "$d\harness-engineering-zh.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
harness-engineering-zh.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
harness-engineering-zhフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
ハーネスエンジニアリング
ハーネスとは、プロジェクトで作業する AI Agent に提供されるオペレーティングシステムのことです。Model は CPU、Context ウィンドウは RAM、ハーネスはオペレーティングシステムです。
核心原則
シンプルなものから始め、必要な場合にのみ複雑さを増してください。 各ハーネスコンポーネントは、モデルが単独ではタスクを完了できないという仮定を表しています。これらの仮定をストレステストしてください。モデルの能力が向上するにつれて、これらの仮定は無効になります。「削除」のために構築してください。
この Skill をいつアクティブにするか
| 信号 | 行動 |
|---|---|
| 空のプロジェクト/新規プロジェクト | → 完全なプロジェクトセットアップを実行 (セクション 1) |
| ユーザーが Agent に不満を感じている | → ハーネスの欠落を診断し修正 (セクション 7) |
| 既存のプロジェクトを改善する必要がある | → 評価し、段階的に改善 |
| 明確なハーネスの問題 | → 関連するセクションを参照 |
ワークフロー
新規プロジェクトの場合
- 評価 (Assess) — プロジェクトとは何か？技術スタックは？チーム規模は？Agent はどのように使用されるか？
- セットアップ (Setup) — 基本的なハーネスファイルを作成 →
references/01-project-setup.mdを読む - Context — 情報アーキテクチャを設計 →
references/02-context-engineering.mdを読む - 制約 (Constraints) — ガードレールと Linters を追加 →
references/03-constraints.mdを読む - 評価 (Evaluate) — フィードバックループを設定 →
references/05-eval-feedback.mdを読む - プロジェクトが複数 Agent または長時間のタスクを含む場合 →
references/04-multi-agent.md、references/06-long-running.mdを読む
診断の場合 (Agent のパフォーマンスが低い)
- 直ちに
references/07-diagnosis.mdを読む - ハーネスのどの層に問題があるかを特定する
- 関連する参照ドキュメントから的を絞った修正を適用する
段階的な改善の場合
現在のハーネスの成熟度を評価し、最も弱い層を特定し、一度に1つの層を改善します。
ハーネス層 (クイックリファレンス)
| 層 | 内容 | 参考ドキュメント |
|---|---|---|
| プロジェクトセットアップ (Project Setup) | AGENTS.md, docs/, ディレクトリ規約 | 01-project-setup.md |
| Context エンジニアリング (Context Engineering) | Agent が見る情報、段階的な表示、作業状態 | 02-context-engineering.md |
| 制約とガードレール (Constraints & Guardrails) | Linters、型システム、アーキテクチャ強制、安全な自律性 | 03-constraints.md |
| マルチ Agent アーキテクチャ (Multi-Agent Architecture) | Agent 分離、コラボレーションプロトコル、委任パターン | 04-multi-agent.md |
| 評価とフィードバック (Eval & Feedback) | テスト、スコアリング、GC Agent、可観測性 | 05-eval-feedback.md |
| 長時間のタスク (Long-Running Tasks) | 進捗追跡、Context リセット、成果物 | 06-long-running.md |
| 診断 (Diagnosis) | Agent が失敗した場合 — モデルではなく、ハーネス内の根本原因を特定 | 07-diagnosis.md |
自己更新プロトコル
プロジェクトで新しい再利用可能なハーネスパターンを発見した場合：
- それがどの参照ファイルに属するか（または新しいファイルが必要か）を特定する
- そのパターンを追加する。これには、何を解決するか、いつ使用するか、そしてそれをどのように実装するかが含まれる
- 簡潔に保つ — 無駄を省き、パターンのみを残す
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Harness Engineering
Harness = 为项目中工作的 AI Agent 提供的操作系统。Model 是 CPU，Context 窗口是 RAM，Harness 则是操作系统。
核心原则
从简单开始，仅在必要时增加复杂度。 每一个 Harness 组件都代表了对模型无法独立完成任务的一种假设。要对这些假设进行压力测试 — 随着模型能力的提升，这些假设会失效。为"删除"而构建。
何时激活此 Skill
| 信号 | 行动 |
|---|---|
| 空项目/新项目 | → 进行完整的项目设置 (Section 1) |
| 用户对 Agent 感到沮丧 | → 诊断并修复 Harness 缺失 (Section 7) |
| 现有项目需要改进 | → 评估并逐步改进 |
| 明确的 Harness 问题 | → 参考相关章节 |
工作流
对于新项目
- 评估 (Assess) — 项目是什么？技术栈？团队规模？Agent 将如何被使用？
- 设置 (Setup) — 创建基础 Harness 文件 → 阅读
references/01-project-setup.md - Context — 设计信息架构 → 阅读
references/02-context-engineering.md - 约束 (Constraints) — 添加护栏和 Linters → 阅读
references/03-constraints.md - 评估 (Evaluate) — 设置反馈循环 → 阅读
references/05-eval-feedback.md - 如果项目涉及多 Agent 或长任务 → 阅读
references/04-multi-agent.md,references/06-long-running.md
对于诊断 (Agent 表现不佳)
- 立即阅读
references/07-diagnosis.md - 识别是哪一层 Harness 出现了问题
- 从相关参考文档中应用针对性修复
对于逐步改进
评估当前 Harness 的成熟度，识别最薄弱的层级，一次改进一个层级。
Harness 层级 (快速参考)
| 层级 | 内容 | 参考文档 |
|---|---|---|
| 项目设置 (Project Setup) | AGENTS.md, docs/, 目录规范 | 01-project-setup.md |
| Context 工程 (Context Engineering) | Agent 看到的信息、渐进式展示、工作状态 | 02-context-engineering.md |
| 约束与护栏 (Constraints & Guardrails) | Linters、类型系统、架构强制执行、安全自主权 | 03-constraints.md |
| 多 Agent 架构 (Multi-Agent Architecture) | Agent 分离、协作协议、委派模式 | 04-multi-agent.md |
| Eval 与反馈 (Eval & Feedback) | 测试、评分、GC Agent、可观测性 | 05-eval-feedback.md |
| 长运行任务 (Long-Running Tasks) | 进度跟踪、Context 重置、交付产物 | 06-long-running.md |
| 诊断 (Diagnosis) | 当 Agent 失败时 — 在 Harness 中识别根因，而非模型 | 07-diagnosis.md |
自我更新协议
当你在项目中发现新的可复用 Harness 模式时：
- 识别它属于哪个参考文件（或者是否需要一个新文件）
- 添加该模式，包括：它解决了什么问题，何时使用，以及如何实现它
- 保持简洁 — 拒绝废话，只保留模式