[{"data":1,"prerenderedAt":1258},["ShallowReactive",2],{"knowledge:ja:\u002Fknowledge\u002Fai\u002Fagents\u002Frepository-centered-agent-harness":3,"knowledge-locales:\u002Fknowledge\u002Fai\u002Fagents\u002Frepository-centered-agent-harness":1257},{"id":4,"title":5,"appliesTo":6,"body":11,"description":1237,"extension":1238,"meta":1239,"navigation":1240,"path":1241,"publishedAt":1242,"seo":1243,"status":1244,"stem":1245,"tags":1246,"technologies":1252,"updatedAt":1255,"__hash__":1256},"knowledge_ja\u002Fknowledge\u002Fai\u002Fagents\u002Frepository-centered-agent-harness.md","モデルを入れ替えても機能するAgent Harness設計",[7,8,9,10],"RAGの判定位置と代替モデルの評価条件は2026-10-01確認","ローカル判断モデルとmlx-serveは2026-09-29確認","2026-09-03時点の公開情報","Jevの判断分担・資料選別は2026-09-19時点の公開情報",{"type":12,"value":13,"toc":1214},"minimark",[14,18,22,25,28,31,66,70,73,76,102,119,122,126,129,196,199,209,212,216,219,225,242,245,329,332,336,339,357,386,408,493,496,499,502,567,580,586,596,600,603,606,629,637,640,658,661,674,724,733,742,781,790,793,811,819,823,826,903,906,909,912,933,945,954,958,961,967,970,973,976,985,988,994,997,1000,1008,1011,1014,1022,1025,1028,1034,1037,1054,1057,1060,1063,1089,1092,1117,1120],[15,16,17],"h2",{"id":17},"概要",[19,20,21],"p",{},"Coding Agentを選ぶときは、GPT、Claude、QwenなどのModelへ注目しがちです。しかし、実際の開発結果はModelだけでは決まりません。Repositoryの読み方、Toolの呼び方、権限、Context、Skill、Subagent、結果の確認方法をまとめて管理する実行環境も影響します。この記事では、この層をAgent Harnessと呼びます。",[19,23,24],{},"Harnessごとに専用の知識を作ると、製品を変えるたびにルールと手順を移植しなければなりません。反対に、長く残す知識をRepositoryへ置き、Harness固有の設定を薄く保てば、ModelとHarnessを別々に評価できます。",[19,26,27],{},"この記事は、特定製品の優劣を決めるものではありません。Agentic Codingの環境を段階的に育てながら、将来ローカルLLMも試せる構成を整理します。",[15,29,30],{"id":30},"結論",[32,33,34,38,41,44,51,54,57,60,63],"ul",{},[35,36,37],"li",{},"Kev、SemIf、Laya、Tev1で判断のローカル実行を比較できますが、出力方式、校正、ライセンス、APIの対応範囲は別々に確認します。",[35,39,40],{},"Modelは推論を担当し、HarnessはContext、Tool、権限、実行Loop、人間への確認を担当します。",[35,42,43],{},"共有したい知識と手順はRepositoryを正本にし、製品固有のMemoryや設定だけに閉じ込めません。",[35,45,46,50],{},[47,48,49],"code",{},"AGENTS.md","は長い説明書ではなく、必要な文書や検証へ案内する軽量な入口にします。",[35,52,53],{},"Docs、Skill、Script、CI、Memoryは役割が異なります。同じ内容をすべてへ複製しません。",[35,55,56],{},"Harness間で共有できるのは主に知識の意味です。Skillの探索場所、Agent定義、認証、権限は薄いAdapterが必要になる場合があります。",[35,58,59],{},"Model Routingは、先に役割を固定するのではなく、同じ課題で品質、時間、再試行、人間の修正量を測ってから広げます。",[35,61,62],{},"知識の自動蓄積は候補の生成までとし、Repositoryの正本へ入れる前に人間の確認と決定的な検証を挟みます。",[35,64,65],{},"Skillや資料の選別は専用モデルへ分担できますが、必須規則、権限、正本の更新はHarnessとコード側で管理します。",[15,67,69],{"id":68},"agent-harnessとは何か","Agent Harnessとは何か",[19,71,72],{},"LLMは、入力されたContextから次の文章やTool Callを提案します。それを開発作業として成立させるには、提案を実行し、結果を再びModelへ返すLoopが必要です。",[19,74,75],{},"Harnessが扱う範囲は製品ごとに異なりますが、主に次の要素を含みます。",[32,77,78,81,84,87,90,93,96,99],{},[35,79,80],{},"Repositoryや作業ディレクトリの読み書き",[35,82,83],{},"Terminal、Browser、外部ServiceなどのTool",[35,85,86],{},"Modelへ渡すInstructionとContext",[35,88,89],{},"Tool実行、ファイル変更、Network接続の権限",[35,91,92],{},"Taskの途中状態とContext圧縮",[35,94,95],{},"Skillや再利用可能なWorkflow",[35,97,98],{},"Subagentへの委譲と結果の統合",[35,100,101],{},"Diff、Log、Test結果を人間へ提示するReview Surface",[19,103,104,105,112,113,118],{},"OpenAIは",[106,107,111],"a",{"href":108,"rel":109},"https:\u002F\u002Fopenai.com\u002Findex\u002Funrolling-the-codex-agent-loop\u002F",[110],"nofollow","CodexのAgent Loop","を、ModelとToolを結び付けて作業を進めるHarnessとして説明しています。また、",[106,114,117],{"href":115,"rel":116},"https:\u002F\u002Fopenai.com\u002Findex\u002Fharness-engineering\u002F",[110],"OpenAI社内の運用","では、Application、Log、MetricをAgentが直接確認できる形へ整えることと、Repository上の構造化されたKnowledgeを正本にすることをHarness Engineeringの要素として挙げています。",[19,120,121],{},"したがって「同じModelを使った」という情報だけでは、Agentの能力を比較できません。利用できるTool、Contextの構成、権限、再試行、終了条件まで揃えて初めて、Model側の差を比較しやすくなります。",[15,123,125],{"id":124},"_4つの層を分ける","4つの層を分ける",[19,127,128],{},"Agentic Coding環境は、次の4層に分けると変更の影響を整理しやすくなります。",[130,131,132,148],"table",{},[133,134,135],"thead",{},[136,137,138,142,145],"tr",{},[139,140,141],"th",{},"層",[139,143,144],{},"主な責務",[139,146,147],{},"交換すると変わるもの",[149,150,151,163,174,185],"tbody",{},[136,152,153,157,160],{},[154,155,156],"td",{},"Model \u002F Provider",[154,158,159],{},"推論、文章生成、Tool Callの提案",[154,161,162],{},"判断品質、速度、料金、Privacy、Context Length",[136,164,165,168,171],{},[154,166,167],{},"Agent Harness",[154,169,170],{},"Agent Loop、Tool、Context、権限、委譲",[154,172,173],{},"作業方法、利用できる機能、安全境界、操作性",[136,175,176,179,182],{},[154,177,178],{},"Repository Contract",[154,180,181],{},"規則、設計知識、手順、Taskの根拠",[154,183,184],{},"Teamで共有する開発方法と正本",[136,186,187,190,193],{},[154,188,189],{},"Deterministic Enforcement",[154,191,192],{},"Test、Lint、Build、CI、承認",[154,194,195],{},"合否判定と変更を受け入れる条件",[19,197,198],{},"この分離では、Harnessを変えてもRepository Contractと検証方法を残せます。Modelだけを変える場合も、同じHarnessと課題を使えば比較条件を近づけられます。",[200,201,207],"pre",{"className":202,"code":204,"language":205,"meta":206},[203],"language-text","Model \u002F Provider\n       ↓\nAgent Harness\n       ↓\nRepository Contract\n       ↓\nTest \u002F CI \u002F Human Review\n","text","",[47,208,204],{"__ignoreMap":206},[19,210,211],{},"下の層が上の層を完全に信用する構造にはしません。Modelが正しい形式のTool Callを生成しても、その操作が現在のTaskで許可されるとは限りません。Harnessの権限と、ScriptやCIの合否判定を別に持たせます。",[15,213,215],{"id":214},"repositoryを正本にする","Repositoryを正本にする",[19,217,218],{},"Repositoryの中心には、Modelへ毎回すべてを渡す巨大なInstructionではなく、必要な情報へ辿り着ける地図を置きます。",[200,220,223],{"className":221,"code":222,"language":205,"meta":206},[203],"Repository\n├─ AGENTS.md          # 最初に読む短い規則と参照先\n├─ docs\u002F              # 設計、判断、運用の正本\n├─ .agents\u002Fskills\u002F    # 必要時に読む再利用手順\n├─ scripts\u002F           # 繰り返し処理を決定的に実行\n└─ tests \u002F CI         # 完了条件を機械的に確認\n",[47,224,222],{"__ignoreMap":206},[19,226,227,231,232,234,235,237,238,241],{},[106,228,230],{"href":115,"rel":229},[110],"OpenAIのHarness Engineering事例","でも、大きな",[47,233,49],{},"へ情報を集約すると、Taskに使えるContextを圧迫し、重要度が曖昧になり、内容が古くなりやすいと説明されています。同事例では、",[47,236,49],{},"を目次として使い、詳細なKnowledgeを",[47,239,240],{},"docs\u002F","へ分けています。",[19,243,244],{},"この構成で重要なのは、Repositoryへ何でも保存することではありません。情報の性質に応じて置き場所を変えます。",[130,246,247,260],{},[133,248,249],{},[136,250,251,254,257],{},[139,252,253],{},"保存先",[139,255,256],{},"向いている内容",[139,258,259],{},"避ける内容",[149,261,262,274,285,296,307,318],{},[136,263,264,268,271],{},[154,265,266],{},[47,267,49],{},[154,269,270],{},"常に必要な制約、詳細文書への案内",[154,272,273],{},"長い背景説明、実行履歴、製品ごとの全設定",[136,275,276,279,282],{},[154,277,278],{},"Docs",[154,280,281],{},"設計判断、運用、公開Knowledge、変更理由",[154,283,284],{},"毎回自動で変わる一時状態",[136,286,287,290,293],{},[154,288,289],{},"Skill",[154,291,292],{},"特定条件で呼び出す再利用可能な手順",[154,294,295],{},"一度しか使わないPrompt、真偽未確認の知識",[136,297,298,301,304],{},[154,299,300],{},"Script \u002F CI",[154,302,303],{},"同じ入力へ同じ判定を返したい処理",[154,305,306],{},"曖昧な設計判断、文章の最終評価",[136,308,309,312,315],{},[154,310,311],{},"Memory",[154,313,314],{},"個人設定や短い継続情報",[154,316,317],{},"Teamの唯一の正本、監査が必要な判断",[136,319,320,323,326],{},[154,321,322],{},"Issue \u002F PR",[154,324,325],{},"Taskの目的、状態、Review、変更への参照",[154,327,328],{},"長期的な設計知識の唯一の保存先",[19,330,331],{},"Memoryは便利ですが、AgentやProfileに依存し、誤った情報や古い前提が残る可能性があります。複数人と複数Harnessで共有する判断はDocsやIssueへ移し、Memoryには正本への参照や小さな個人設定を残します。",[15,333,335],{"id":334},"共有できるものとadapterが必要なもの","共有できるものとAdapterが必要なもの",[19,337,338],{},"Repository中心にしても、すべてのHarnessが同じファイルを同じ方法で読めるわけではありません。",[19,340,341,346,347,350,351,356],{},[106,342,345],{"href":343,"rel":344},"https:\u002F\u002Fopencode.ai\u002Fdocs\u002Fskills",[110],"OpenCode","は、Project内の",[47,348,349],{},".agents\u002Fskills\u002F\u003Cname>\u002FSKILL.md","を探索し、Skill本文を必要時に読み込みます。",[106,352,355],{"href":353,"rel":354},"https:\u002F\u002Fopencode.ai\u002Fv2\u002Fdocs\u002Fagents",[110],"Agentごと","にModelとTool権限を設定でき、Local Modelを含む複数Providerを扱います。",[19,358,359,360,365,366,371,372,377,378,381,382,385],{},"Qwen Codeも",[106,361,364],{"href":362,"rel":363},"https:\u002F\u002Fgithub.com\u002FQwenLM\u002Fqwen-code\u002Fblob\u002Fmain\u002Fdocs\u002Fusers\u002Ffeatures\u002Fskills.md",[110],"Project Skill","と",[106,367,370],{"href":368,"rel":369},"https:\u002F\u002Fgithub.com\u002FQwenLM\u002Fqwen-code\u002Fblob\u002Fmain\u002Fdocs\u002Fusers\u002Ffeatures\u002Fsub-agents.md",[110],"Subagent","を扱い、",[106,373,376],{"href":374,"rel":375},"https:\u002F\u002Fqwenlm.github.io\u002Fqwen-code-docs\u002Fen\u002Fusers\u002Fconfiguration\u002Fmodel-providers\u002F",[110],"OpenAI互換API","を通じてOllama、vLLM、LM StudioなどのLocal Serverへ接続できます。一方、現在の公式配置はSkillが",[47,379,380],{},".qwen\u002Fskills\u002F","、Subagentが",[47,383,384],{},".qwen\u002Fagents\u002F","です。",[19,387,388,393,394,396,397,401,402,407],{},[106,389,392],{"href":390,"rel":391},"https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fuser-guide\u002Ffeatures\u002Fcontext-files",[110],"Hermes Agent","は",[47,395,49],{},"をProject Contextとして読み、",[106,398,289],{"href":399,"rel":400},"https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fuser-guide\u002Ffeatures\u002Fskills\u002F",[110],"を必要時に読み込みます。標準のSkill保存先はProfile側ですが、外部Directoryの読込みや、作成先をGit管理されたDirectoryへ変える設定もあります。",[106,403,406],{"href":404,"rel":405},"https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fuser-guide\u002Ffeatures\u002Fmemory\u002F",[110],"MemoryとSkillの書込み","を人間の承認待ちにする機能もありますが、いずれも標準では自由に書き込む設定です。",[130,409,410,423],{},[133,411,412],{},[136,413,414,417,420],{},[139,415,416],{},"資産",[139,418,419],{},"共有のしやすさ",[139,421,422],{},"扱い方",[149,424,425,436,448,462,473,483],{},[136,426,427,430,433],{},[154,428,429],{},"Markdownの設計・運用文書",[154,431,432],{},"高い",[154,434,435],{},"Repository側を正本にする",[136,437,438,442,445],{},[154,439,440],{},[47,441,49],{},[154,443,444],{},"比較的高い",[154,446,447],{},"対応範囲と優先順位をHarnessごとに確認する",[136,449,450,456,459],{},[154,451,452,455],{},[47,453,454],{},"SKILL.md","の内容",[154,457,458],{},"中程度",[154,460,461],{},"正本を決め、必要なら配置同期や薄いWrapperを使う",[136,463,464,467,470],{},[154,465,466],{},"Agent \u002F Subagent定義",[154,468,469],{},"低い",[154,471,472],{},"Harness固有設定として最小限に保つ",[136,474,475,478,480],{},[154,476,477],{},"Provider認証とPermission",[154,479,469],{},[154,481,482],{},"Git管理せず、各Harnessで明示設定する",[136,484,485,488,490],{},[154,486,487],{},"Session、Memory、Task Queue",[154,489,469],{},[154,491,492],{},"永続判断をDocs、Issue、PRへ戻す",[19,494,495],{},"目標は「Adapterをゼロにすること」ではありません。共有する意味を一つにし、製品固有の接続部分を小さく保つことです。",[15,497,498],{"id":498},"製品ごとの重点を分けて見る",[19,500,501],{},"2026年9月3日時点では、各Harnessの用途を次のように整理できます。これは総合順位ではなく、公式に確認できる機能と導入目的の対応です。",[130,503,504,517],{},[133,505,506],{},[136,507,508,511,514],{},[139,509,510],{},"Harness",[139,512,513],{},"確認できる重点",[139,515,516],{},"試す目的",[149,518,519,532,546,557],{},[136,520,521,524,529],{},[154,522,523],{},"Codex",[154,525,526,528],{},[47,527,49],{},"、Skill、Sandbox、Toolを使った長時間Task",[154,530,531],{},"現在の基準結果を作り、人間Reviewを含む運用を測る",[136,533,534,536,543],{},[154,535,345],{},[154,537,538,539,542],{},"多数のProviderとLocal Model、",[47,540,541],{},".agents\u002Fskills\u002F","、Agent別のModelとPermission",[154,544,545],{},"同じRepository資産を使いながらModelを交換する",[136,547,548,551,554],{},[154,549,550],{},"Qwen Code",[154,552,553],{},"複数Provider、OpenAI互換のLocal Server、Project Skill、Subagent",[154,555,556],{},"QwenやLocal Modelを含む構成を比較する",[136,558,559,561,564],{},[154,560,392],{},[154,562,563],{},"永続Memory、Skill作成、Project Context、長期稼働するAgent",[154,565,566],{},"Taskをまたぐ学習とKnowledge候補の生成を検証する",[19,568,569,570,573,574,576,577,579],{},"OpenCodeは75以上のProviderとLocal Modelへの対応を案内しており、Agentごとに",[47,571,572],{},"provider\u002Fmodel","を選べます。既に",[47,575,49],{},"や",[47,578,541],{},"をRepository管理している場合、第二のCoding Harnessとして比較を始めやすい候補です。",[19,581,582,583,585],{},"Qwen Codeは名前にQwenを含みますが、公式資料ではOpenAI、Anthropic、GeminiのProtocolとOpenAI互換のLocal Serverを設定できます。ただし、既存のSkillを移す場合は",[47,584,380],{},"との同期方針を先に決めます。",[19,587,588,589,365,592,595],{},"Hermes Agentは、短いCoding Taskだけでなく、Memory、Skillの更新、Profile、長期稼働を含むAgent Platform寄りの機能を持ちます。自動でKnowledgeを書き換える前に、",[47,590,591],{},"memory.write_approval",[47,593,594],{},"skills.write_approval","を有効にし、作成候補をReviewする運用が安全です。また、公式資料はPermissionの拒否Ruleを誤操作へのGuardrailと位置付け、敵対的なProcessに対するSandboxではないと説明しています。必要に応じて隔離された実行環境を併用します。",[15,597,599],{"id":598},"model-routingは実測から決める","Model Routingは実測から決める",[19,601,602],{},"HarnessからModelを交換できても、最初から「調査はLocal」「実装はCloud」のように固定すると、Taskの難しさと言語品質の差を見落とします。",[19,604,605],{},"まず同じRepository、同じTask契約、同じ完了条件で結果を記録します。",[32,607,608,611,614,617,620,623,626],{},[35,609,610],{},"完了条件を満たした割合",[35,612,613],{},"人間が修正したDiffの量と重要度",[35,615,616],{},"Rule、許可範囲、対象Fileを守れたか",[35,618,619],{},"再試行回数と中断理由",[35,621,622],{},"経過時間、Token量、推論料金",[35,624,625],{},"Local実行時のMemory、GPU占有、他の作業への影響",[35,627,628],{},"Reviewで見つかった欠陥",[19,630,631,636],{},[106,632,635],{"href":633,"rel":634},"https:\u002F\u002Fwww.perplexity.ai\u002Fuk\u002Fhub\u002Fblog\u002Fa-local-first-agent-for-private-and-cost-effective-knowledge-work",[110],"Perplexity","は自社のLocal Knowledge Work Benchで、同じQwen 3.8 27BをPortable Computer、Pi、Hermesへ載せた結果に差が出たと報告しています。これは開発元が作成した非公開Benchmarkであり、一般的な優劣を証明するものではありませんが、Modelを固定してもHarnessが結果へ影響し得る事例です。",[19,638,639],{},"Model Routingは、次のように段階的に広げます。",[641,642,643,646,649,652,655],"ol",{},[35,644,645],{},"現在のHarnessとModelを基準に、境界が明確なTaskを数件記録する。",[35,647,648],{},"第二のHarnessで同じTask種別を実行し、出力だけでなく権限とReview負荷を比べる。",[35,650,651],{},"低Riskな文書整形、検索、定型検証からLocal Modelを試す。",[35,653,654],{},"成功率が安定した役割だけ、標準のRouting候補へ昇格する。",[35,656,657],{},"ModelまたはHarnessのVersionが変わったら、同じ評価Taskで再確認する。",[15,659,660],{"id":660},"限定的な判断を専用モデルへ分担する",[19,662,663,664,667,668,673],{},"Skillや参照資料の候補が決まっている場合、その選別だけを別のModelへ分担する構成も評価できます。TypeSafeのJevは、与えられた",[47,665,666],{},"state","に対する選択・評価を返すモデルです。",[106,669,672],{"href":670,"rel":671},"https:\u002F\u002Fdocs.typesafe.ai\u002Fconcepts\u002Fhow-to-build-with-system-one",[110],"公式の設計方針","は、狭い判断をモデルへ渡し、制御フロー、確定的な規則、実際の操作はコードへ残すものです。",[130,675,676,689],{},[133,677,678],{},[136,679,680,683,686],{},[139,681,682],{},"機能",[139,684,685],{},"返すもの",[139,687,688],{},"Harnessでの用途例",[149,690,691,702,713],{},[136,692,693,696,699],{},[154,694,695],{},"Choice",[154,697,698],{},"候補の選択と確率分布",[154,700,701],{},"Skill候補や依頼の分類",[136,703,704,707,710],{},[154,705,706],{},"Score",[154,708,709],{},"定義した段階に対する評価と確率分布",[154,711,712],{},"資料の関連度や情報充足度",[136,714,715,718,721],{},[154,716,717],{},"Noul",[154,719,720],{},"Yesの確率",[154,722,723],{},"候補の適合性や根拠の有無",[19,725,726,727,732],{},"これらの",[106,728,731],{"href":729,"rel":730},"https:\u002F\u002Fdocs.typesafe.ai\u002Fintroduction",[110],"型付きの質問","は同じstateに対して独立に評価されます。前の回答を次の質問へ渡す逐次推論ではありません。Jevは文章やコードを生成する担当ではなく、状況の取得、資料の検索、説明や実装は周辺コードと生成LLMが担当します。",[19,734,735,736,741],{},"具体例として、TypeSafeの",[106,737,740],{"href":738,"rel":739},"https:\u002F\u002Fdocs.typesafe.ai\u002Fcookbooks\u002Fskill_suggestion",[110],"Skill提案実験","は、全候補を順位付けし、上位3件を詳しく再評価する2回のAPI呼び出しで、最大1件のSkillをAgentへ提案しています。元のSkill一覧とAgent自身の判断は残した構成です。",[130,743,744,757],{},[133,745,746],{},[136,747,748,751,754],{},[139,749,750],{},"提供元が測定したエラー率",[139,752,753],{},"Agent単体",[139,755,756],{},"Jevの提案を追加",[149,758,759,770],{},[136,760,761,764,767],{},[154,762,763],{},"適合Skillがある依頼での誤選択・未読み込み",[154,765,766],{},"16.8%",[154,768,769],{},"7.3%",[136,771,772,775,778],{},[154,773,774],{},"適合Skillがない依頼での不要な読み込み",[154,776,777],{},"9.8%",[154,779,780],{},"4.0%",[19,782,783,784,789],{},"これはJev 1.12、Claude Haiku 4.5、Hermes由来の182種類のSkillと488依頼による提供元実験です。依頼には生成されたものが含まれ、測定対象はAgentの最初の応答でのSkill読み込みです。Jev 1.13、日本語、Copilotで同じ改善を示すものでも、作業全体の品質やトークン削減を証明するものでもありません。",[106,785,788],{"href":786,"rel":787},"https:\u002F\u002Fgithub.com\u002Ftypesafe-ai\u002Fskills",[110],"公式TypeSafe Skill","もAPIを使った設計・実装を支援する手順であり、インストールだけで既存AgentのSkill選択を置き換える機能とは区別します。",[19,791,792],{},"評価時は、候補の選択、Agentによる実際の読み込み、指示への追従、最終成果物を分けて測ります。単一候補の提案だけでなく、該当なし、情報不足、複数Skillが必要な依頼を含め、既存の選択方法と総時間・費用・見落とし率を比較します。必須の規則や権限確認は、候補として選ばれた場合だけ読む設計にしません。",[19,794,795,800,801,806,807,810],{},[106,796,799],{"href":797,"rel":798},"https:\u002F\u002Fdocs.typesafe.ai\u002Fconfidence",[110],"confidence","はChoiceやScoreの確率分布から算出される指標で、正解率として扱いません。閾値は自分のデータで調整し、モデルと質問文を記録します。",[106,802,805],{"href":803,"rel":804},"https:\u002F\u002Fdocs.typesafe.ai\u002Fmodels",[110],"モデル仕様","で確認した提供経路はクラウドAPIです。2026年9月19日時点のモデルIDは",[47,808,809],{},"jev-1.13.0","で、英語以外の精度には差があるとされています。ローカルLLM構成へ追加する場合も、送信するstateは外部へ出ます。顧客データの学習不使用と、保存・保持なしは別の条件です。",[19,812,813,818],{},[106,814,817],{"href":815,"rel":816},"https:\u002F\u002Fdocs.typesafe.ai\u002Fprimitives",[110],"複数質問の公式仕様","では、同じstateで独立に判定できる質問はまとめられます。一方、先の結果から取得資料や次の候補を決める場合は別リクエストが必要です。上記の「全候補→上位3件」の再評価は段階間に依存があり、そのまま1回へ統合できるとは扱いません。",[820,821,822],"h3",{"id":822},"ローカル判断モデルは出力方式と実行環境を分けて比較する",[19,824,825],{},"2026年9月29日確認。Jevで説明した判断の分担は、ローカルでも検証候補が増えています。以下はTypeSafe公式Jevのローカル版ではなく、独立した実装です。",[130,827,828,841],{},[133,829,830],{},[136,831,832,835,838],{},[139,833,834],{},"候補",[139,836,837],{},"判断の返し方",[139,839,840],{},"実行・評価時の注意",[149,842,843,858,873,888],{},[136,844,845,852,855],{},[154,846,847],{},[106,848,851],{"href":849,"rel":850},"https:\u002F\u002Fgithub.com\u002Fjaredpalmer\u002Fkev",[110],"Kev",[154,853,854],{},"Qwenを追加学習したpointer headで候補を評価",[154,856,857],{},"専用サーバー。CUDA \u002F ROCm、Apple SiliconではMLXを自動利用",[136,859,860,867,870],{},[154,861,862],{},[106,863,866],{"href":864,"rel":865},"https:\u002F\u002Fgithub.com\u002FTheoLeeCJ\u002FSemIf-OpenJev",[110],"SemIf",[154,868,869],{},"既存モデルの選択肢logitを直接読み、回答文の生成を省く",[154,871,872],{},"Backend、量子化、Prompt、確率校正を固定して比較",[136,874,875,882,885],{},[154,876,877],{},[106,878,881],{"href":879,"rel":880},"https:\u002F\u002Fhuggingface.co\u002Fconvaiinnovations\u002Flaya-multilingual",[110],"Laya multilingual",[154,883,884],{},"322Mのencoderと判断headでchoice \u002F score \u002F yes-noを評価",[154,886,887],{},"小型でも用途別の精度と校正が必要",[136,889,890,897,900],{},[154,891,892],{},[106,893,896],{"href":894,"rel":895},"https:\u002F\u002Fhuggingface.co\u002Ftogethercomputer\u002FTev1-4B-experimental",[110],"Tev1-4B-experimental",[154,898,899],{},"Qwenの通常のLM headで選択肢の文字を生成",[154,901,902],{},"非生成classifierではなく、2〜24候補から選ぶ実験モデル",[19,904,905],{},"KevのMLX対応は確認時点で実装済みです。通常のチャット用GGUFを読み込む構成とは区別します。APIの形式が似ていても、質問数、候補数、Context制限、精度、confidenceの意味までJevと同一とは限りません。切替時は自分の入力とエラー処理で契約を検証します。",[19,907,908],{},"SemIfの作者測定では、同じQwen3.5-4B、同じstateと21個の二値質問をRTX 3090で処理したとき、直接logitを読む方式は1.023秒、JSON配列の生成は5.332秒でした（各3回の中央値）。ただし回答の一致は18\u002F21件で、意味的に等価な処理を高速化した証明ではありません。速度と判断品質を別々に測ります。",[19,910,911],{},"Laya multilingualのモデルカードは、未校正で過信傾向があることと、typed-decisionsのzero-shot評価が0.342（ランダム0.318、最多クラス0.461）だったことを開示しています。多言語対応だけで日本語のSkill選択や資料評価が十分とは判断せず、用途に合わせた評価・追加学習・校正を検討します。Tev1も多言語、Prompt Injection、校正、分布外入力の包括的評価は未実施で、確認時点では重みのライセンスを確定中としています。ベースモデルのライセンスを派生Weightの配布条件として代用しません。",[19,913,914,919,920,923,924,927,928,932],{},[106,915,918],{"href":916,"rel":917},"https:\u002F\u002Fgithub.com\u002Fddalcu\u002Fmlx-serve\u002Freleases\u002Ftag\u002Fv26.9.6",[110],"mlx-serve v26.9.6","はLaya Checkpointを扱う",[47,921,922],{},"POST \u002Fv1\u002Fdecisions","を追加し、同時要求をまとめる処理を案内しています。このAPIとJevの",[47,925,926],{},"\u002Fv1\u002Fsystemone","を同じものとは扱いません。サーバーへ接続できることと、Skill選択やゲーム判断に使える品質であることも別です。",[106,929,931],{"href":930},"\u002Fknowledge\u002Fgame\u002Fllm\u002Fgame-npc-llm-adoption-boundaries","ゲームでの小規模実測","と合わせ、待ち時間を含む応答、誤判定、既存処理へのFallbackを比較します。",[19,934,935,940,941,944],{},[106,936,939],{"href":937,"rel":938},"https:\u002F\u002Fqiita.com\u002Fmoritalous\u002Fitems\u002F41c9402a5dd9d80fc7a9",[110],"Qwen3-VL-4Bを用いた個人の実装例","では、1トークンの出力と選択肢のlogprobから画像への判断を返しています。これはJev自体の画像対応ではなく、複数質問を複数回のモデル呼び出しで処理する別実装です。初回処理とキャッシュ利用時を分け、モデル、量子化、Runtime、入力の再利用条件を記録します。全候補の確率を取得できているかも確認し、",[47,942,943],{},"top_logprobs","から漏れた候補を確率ゼロとみなしません。画像からの資料分類やSkill提案は未検証の応用案です。",[19,946,947,948,953],{},"代替モデルは、形式の妥当性（パース、候補範囲、確率の合計）、人手の正解に対する判断品質、確率の校正、再試行込みの時間・費用を分けて評価します。",[106,949,952],{"href":950,"rel":951},"https:\u002F\u002Fqiita.com\u002Fnasuvitz\u002Fitems\u002F4d27833640ff36b5d8c5",[110],"Nova MicroとJevの個人比較","も出力検証とモデル間の一致率を区別しており、一致率は正解率ではありません。生成された確率値、トークン確率、専用判断モデルの確率を同じ性質として交換しません。Nova Microはクラウド候補であり、ローカル代替とは別枠です。",[15,955,957],{"id":956},"実装経験をknowledgeへ戻す","実装経験をKnowledgeへ戻す",[19,959,960],{},"AgentがTask中に再利用できそうな知識を見つけても、その場で正本を書き換える必要はありません。次のLoopへ分けます。",[200,962,965],{"className":963,"code":964,"language":205,"meta":206},[203],"実装・調査\n   ↓\nKnowledge候補を記録\n   ↓\n事実、判断、手順、一時情報へ分類\n   ↓\nDocs \u002F Skill \u002F Scriptの候補を作る\n   ↓\nTest・ValidationとHuman Review\n   ↓\nRepositoryの正本へ反映\n",[47,966,964],{"__ignoreMap":206},[19,968,969],{},"同じ説明を繰り返すならDocs、同じ複数Stepを繰り返すならSkill、同じ合否判定を繰り返すならScriptやCIが候補です。一度限りの出来事や未検証の推測は、無理にKnowledgeへ昇格させません。",[19,971,972],{},"この境界を設けると、Agentによる発見速度を活かしながら、誤った一般化、重複、古いKnowledgeの蓄積を抑えられます。",[15,974,975],{"id":975},"蓄積した知識を選んで再利用する",[19,977,978,979,984],{},"保存したノートを再利用するときは、検索、意味の評価、本文の取得、説明の生成を分けます。TypeSafeの",[106,980,983],{"href":981,"rel":982},"https:\u002F\u002Fdocs.typesafe.ai\u002Fcookbooks\u002Fclassifying_rag_passages",[110],"文書選別の公式例","では、検索済みの文書について関連性、回答に使える根拠、質問の前提との矛盾などを評価し、コードが回答用の資料を振り分けています。矛盾する情報も別枠で生成LLMへ渡す構成です。",[19,986,987],{},"Repositoryのノートへ応用するなら、次のように設計できます。これは構成案であり、funesなどの会話履歴検索とJevをつなぐ完成済みの公式連携や、本記事で実測したシステムではありません。",[200,989,992],{"className":990,"code":991,"language":205,"meta":206},[203],"現在の問題と作業状態\n   ↓\nノートの候補検索\n   ↓\nJevで関連性・根拠・矛盾を個別に評価\n   ↓\nコードで資料を選び、本文・出典・状態を取得\n   ↓\n生成LLMが説明し、現在の実装への適用を調査\n",[47,993,991],{"__ignoreMap":206},[19,995,996],{},"ノートにはID、対象機能・リビジョン、問題、原因、採用した対応、失敗した案、検証結果、採用済み・廃止・後継ありなどの状態、IssueやPRへの出典を持たせます。既存の欄を取り出す処理はコードで実行でき、複数資料を読み合わせた説明は生成LLMへ渡せます。Jevによる選別だけで、履歴が永続記憶へ保存されたり、正本が更新されたりする構成にはしません。",[19,998,999],{},"過去に成功した対応は、現在の正解とは限りません。現行仕様と対象リビジョンを併記し、失敗例や矛盾を単に関連度の低い資料として捨てないようにします。明示された廃止状態や日付比較はコードで処理します。検索で候補が見つからない場合は、会話履歴の検索や元のコードの確認へ戻れる経路を用意します。",[19,1001,1002,1007],{},[106,1003,1006],{"href":1004,"rel":1005},"https:\u002F\u002Fdocs.typesafe.ai\u002Fmodel-jaggedness\u002Fjev-1.13",[110],"Jev 1.13の既知の制約","には、数値・日時、多段階の判断、無関係な情報の多いstate、入力内の誘導的な文章への弱さがあります。文書選別は、資料の正しさやPrompt Injectionへの安全性を保証する検証ではありません。日本語の実データで重要資料の見落としや矛盾の保持を測り、既存検索・再順位付けに対する追加効果と総費用を確認してから採用範囲を広げます。",[820,1009,1010],{"id":1010},"判定位置と誤遮断を評価する",[19,1012,1013],{},"検索前の判定は「この検索先が扱う依頼か」、検索後・生成前の判定は「取得資料で回答を支えられるか」を扱います。前者には対象範囲と必要な会話履歴を渡し、不明なら検索継続や確認へ進めます。後者で根拠が不足したら検索拡張や原典・コード確認へ戻します。今回取得した資料に根拠がないことは、Repository全体に答えが存在しないことを意味しません。矛盾する資料は調査・説明へ回し、採用する根拠がゼロという理由だけで終了しません。",[19,1015,1016,1021],{},[106,1017,1020],{"href":1018,"rel":1019},"https:\u002F\u002Fqiita.com\u002Fkikuziro\u002Fitems\u002F2be9091b328d8b844640",[110],"Jev 1.13を使った個人のRAG検証","では、架空の400チャンク・120問による回答可否判定の正解率は99.2%でしたが、回答可能な質問の誤遮断も1.7%ありました。CompanyのSkill選択や日本語の実資料で同じ精度を保証する結果ではありません。回答可能な依頼の見落としを、処理削減の成果に数えない評価が必要です。",[19,1023,1024],{},"後続処理の単価を一定と仮定すれば、費用削減の簡易条件は「判定費用 \u003C 正当に省略できた割合 × 後続処理費用」です。実際には検索拡張・再試行・検証の追加費用も含めて比較します。処理を継続する依頼には判定時間が加わるため、回答した依頼と正当に省略した依頼を分けて待ち時間を記録します。",[15,1026,1027],{"id":1027},"最初に導入するなら何を試すか",[19,1029,1030,1031,1033],{},"既存の開発環境を置き換えず、第二のHarnessを比較対象として追加します。既にRepositoryへ",[47,1032,49],{},"とSkillを置いている場合は、OpenCodeを最初の候補にすると、共有資産とProvider切替を同時に確認できます。",[19,1035,1036],{},"最初の検証範囲は、次の程度に留めます。",[32,1038,1039,1042,1045,1048,1051],{},[35,1040,1041],{},"専用BranchまたはWorktreeを使い、同じFileを別Harnessから同時に編集しない。",[35,1043,1044],{},"最初は読み取り、調査、文書の小変更など、戻しやすいTaskを使う。",[35,1046,1047],{},"Gitへの書込み、Network、認証情報の扱いを明示的に制限する。",[35,1049,1050],{},"既存Harnessの結果を基準にし、完了率と人間の修正量を比較する。",[35,1052,1053],{},"Harnessの比較とLocal Modelの比較を同時に行わず、最初は片方を固定する。",[19,1055,1056],{},"長期Memoryや自動的なSkill候補の生成が必要になった段階で、Hermes Agentを別の比較対象にします。Local Qwenを優先して試す場合は、OpenCodeまたはQwen CodeからOpenAI互換のLocal Serverへ接続できます。採用判断は名前ではなく、同じ評価Taskの結果で行います。",[15,1058,1059],{"id":1059},"確認項目",[19,1061,1062],{},"Agent Harnessを追加する前に、次を確認します。",[32,1064,1065,1068,1071,1074,1077,1080,1083,1086],{},[35,1066,1067],{},"Repositoryの正本と、Harness固有設定を区別できている。",[35,1069,1070],{},"Secret、Token、個人用MemoryをGit管理対象から除外している。",[35,1072,1073],{},"Agentが読める範囲と、書ける範囲を別々に定義している。",[35,1075,1076],{},"自動生成されたSkillとMemoryを、人間が確認するまで有効にしない。",[35,1078,1079],{},"Test、Lint、Buildなど、決定的に判定できる処理をPromptだけへ任せていない。",[35,1081,1082],{},"並列Agentが同じFileを同時に所有しない仕組みがある。",[35,1084,1085],{},"Harness、Model、Version、推論量、結果を比較できる記録がある。",[35,1087,1088],{},"失敗時に変更を破棄し、認証情報や外部状態を復旧できる。",[15,1090,1091],{"id":1091},"注意点",[32,1093,1094,1097,1102,1105,1108,1111,1114],{},[35,1095,1096],{},"Harness、Skill形式、設定項目は更新されます。導入時は公式資料と対象Versionを再確認します。",[35,1098,1099,1101],{},[47,1100,454],{},"の形式が似ていても、探索場所、Frontmatter、Tool、権限の意味まで同一とは限りません。",[35,1103,1104],{},"Local実行は、無条件にPrivate、安価、高速という意味ではありません。外部Tool、Telemetry、Update確認、Hardware費用を含めて評価します。",[35,1106,1107],{},"Memoryと自動学習は誤りも再利用します。承認、出典、更新条件、削除方法を先に用意します。",[35,1109,1110],{},"Permissionの確認Dialogや拒否Ruleだけを、OS Levelの隔離と同じ安全境界として扱いません。",[35,1112,1113],{},"Multi-Agentは並列化できるTaskでのみ有効です。指示、結果確認、競合解決の負担も測ります。",[35,1115,1116],{},"VendorのBenchmarkは、そのModel、Harness、Hardware、Task Setでの開発元評価です。自分のRepositoryで同じ結果が出るとは限りません。",[15,1118,1119],{"id":1119},"関連資料",[32,1121,1122,1128,1134,1140,1146,1153,1159,1165,1171,1177,1183,1189,1196,1202,1208],{},[35,1123,1124],{},[106,1125,1127],{"href":115,"rel":1126},[110],"OpenAI: Harness engineering",[35,1129,1130],{},[106,1131,1133],{"href":108,"rel":1132},[110],"OpenAI: Unrolling the Codex agent loop",[35,1135,1136],{},[106,1137,1139],{"href":353,"rel":1138},[110],"OpenCode: Agents",[35,1141,1142],{},[106,1143,1145],{"href":343,"rel":1144},[110],"OpenCode: Agent Skills",[35,1147,1148],{},[106,1149,1152],{"href":1150,"rel":1151},"https:\u002F\u002Fdev.opencode.ai\u002Fdocs\u002Fproviders\u002F",[110],"OpenCode: Providers",[35,1154,1155],{},[106,1156,1158],{"href":374,"rel":1157},[110],"Qwen Code: Model Providers",[35,1160,1161],{},[106,1162,1164],{"href":362,"rel":1163},[110],"Qwen Code: Skills",[35,1166,1167],{},[106,1168,1170],{"href":368,"rel":1169},[110],"Qwen Code: Subagents",[35,1172,1173],{},[106,1174,1176],{"href":390,"rel":1175},[110],"Hermes Agent: Context Files",[35,1178,1179],{},[106,1180,1182],{"href":399,"rel":1181},[110],"Hermes Agent: Skills System",[35,1184,1185],{},[106,1186,1188],{"href":404,"rel":1187},[110],"Hermes Agent: Persistent Memory",[35,1190,1191],{},[106,1192,1195],{"href":1193,"rel":1194},"https:\u002F\u002Fhermes-agent.nousresearch.com\u002Fdocs\u002Fuser-guide\u002Fsecurity",[110],"Hermes Agent: Security",[35,1197,1198],{},[106,1199,1201],{"href":633,"rel":1200},[110],"Perplexity: A Local-First Agent for Private Knowledge Work",[35,1203,1204],{},[106,1205,1207],{"href":1206},"\u002Fknowledge\u002Fai\u002Fllm\u002Flocal-llm-landscape-2026","2026年時点の主要なローカルLLM",[35,1209,1210],{},[106,1211,1213],{"href":1212},"\u002Fknowledge\u002Fweb\u002Fgithub\u002Fgithub-projects-issues-prs-team-coordination","GitHub Projects、Issue、PRで複数Agentの作業を調整する",{"title":206,"searchDepth":1215,"depth":1215,"links":1216},2,[1217,1218,1219,1220,1221,1222,1223,1224,1225,1229,1230,1233,1234,1235,1236],{"id":17,"depth":1215,"text":17},{"id":30,"depth":1215,"text":30},{"id":68,"depth":1215,"text":69},{"id":124,"depth":1215,"text":125},{"id":214,"depth":1215,"text":215},{"id":334,"depth":1215,"text":335},{"id":498,"depth":1215,"text":498},{"id":598,"depth":1215,"text":599},{"id":660,"depth":1215,"text":660,"children":1226},[1227],{"id":822,"depth":1228,"text":822},3,{"id":956,"depth":1215,"text":957},{"id":975,"depth":1215,"text":975,"children":1231},[1232],{"id":1010,"depth":1228,"text":1010},{"id":1027,"depth":1215,"text":1027},{"id":1059,"depth":1215,"text":1059},{"id":1091,"depth":1215,"text":1091},{"id":1119,"depth":1215,"text":1119},"ModelとAgent Harnessを分離し、Repositoryを知識と手順の正本にして、複数のCoding AgentやローカルLLMを段階的に試す方法を整理します。","md",{},true,"\u002Fknowledge\u002Fai\u002Fagents\u002Frepository-centered-agent-harness","2026-09-03",{"title":5,"description":1237},"published","knowledge\u002Fai\u002Fagents\u002Frepository-centered-agent-harness",[1247,1248,1249,1250,1251],"agent-harness","agentic-coding","model-routing","agent-skills","knowledge-management",[1253,1254],"ai-agent","git","2026-10-01","9wwxQ__Uk24hW91US4Z1SFY_HNLx1rTuHe5dYMQ6EME",{"ja":1240,"en":1240},1791891818236]