Refine course progression and runtime safety

This commit is contained in:
Haoran
2026-08-11 15:13:13 +08:00
parent b36dbcd84f
commit ab35e59672
83 changed files with 5291 additions and 2267 deletions

View File

@@ -74,7 +74,7 @@ Harness = Tools + Knowledge + Observation + Action Interfaces + Permissions
- **知識のキュレーション。** Agent にドメイン専門性を与える。製品ドキュメント、アーキテクチャ決定記録、スタイルガイド、規制要件。オンデマンドで読み込みs07、前もって詰め込まない。Agent は何が利用可能か知った上で、必要なものを自ら取得すべき。
- **コンテキストの管理。** Agent にクリーンな記憶を与える。サブ Agent 隔離s06イズの漏洩を防ぐ。コンテキスト圧縮s08が履歴の氾濫を防ぐ。タスクシステムs12目標を単一の会話を超えて永続化する。
- **コンテキストの管理。** サブ Agent は明確な作業を別のメッセージリストに置く。コンテキスト圧縮s08は古い履歴を短くし、タスクシステムs12目標を単一の会話を超えて永続化する。
- **権限の制御。** Agent に境界を与える。ファイルアクセスのサンドボックス化。破壊的操作への承認要求。Agent と外部システム間の信頼境界の実施。安全工学と Harness 工学の交差点。
@@ -172,7 +172,7 @@ Claude Code = 一つの agent loop
>
> **s05**   *"計画のないエージェントは行き当たりばったり"* — まずステップを書き出し、それから実行
>
> **s06**   *"大きなタスクを分割し、各サブタスクにクリーンなコンテキストを"* — サブ Agent が作業し、結果だけを持ち帰る
> **s06**   サブタスクに新しい `messages[]` を与え、最終テキストを 1 つの tool result として返す
>
> **s07**   *"必要な知識を、必要な時に読み込む"* — スキルはまず一覧だけ、必要な時に展開する
>
@@ -194,11 +194,11 @@ Claude Code = 一つの agent loop
>
> **s16**   *"能力不足? MCP でプラグイン"* — 外部ツールを同じツールプールに接続する
>
> **s17**   *"仕組みは多く、ループは一つ"* — すべての仕組みを 1 つの Harness に戻す
> **s17**   *"仕組みは多く、ループは一つ"* — 統合例で使う仕組みを 1 つの Harness に戻す
>
> **s18**   *"編成の形が固定なら、コードにする"* — 再開可能なジャーナルを持つ決定的 Workflow
>
> **s19**   *"本当に終われる時を目標が決める"* — 独立した evaluator が conversation から目標達成を確認するまで継続する
> **s19**   *"本当に終われる時を目標が決める"* — 停止候補ごとに独立 evaluator が確認し、不可能、失敗、継続上限の場合は user に制御を返す
---
@@ -229,7 +229,7 @@ def agent_loop(messages):
messages.append({"role": "user", "content": results})
```
各セッションはこのループの上に 1 つの Harness メカニズムを重ねる -- ループ自体は変わらない。ループは Agent のもの。メカニズムは Harness のもの。
各セッションはこの loop の周りで 1 つの Harness mechanism を分けて扱う。s17 で累積 runtime を再統合し、s18 と s19 で Workflow 編成と goal closure を個別に扱う。loop は Agent のもので、mechanism は Harness のものである
## バージョン状況
@@ -262,7 +262,7 @@ def agent_loop(messages):
## コースの範囲
これは Harness 工学を 0 から組み立てるコースである。各セッションで一つの仕組みを分けて扱い、s17 で一つの Agent loop に戻す。チームランタイムは JSONL メールボックスを使い、その後のセッションで Workflow 編成と目標による継続ループを追加する
これは Harness 工学を 0 から組み立てるコースである。各セッションで一つの仕組みを分けて扱い、s17 で累積 runtime を一つの Agent loop に戻す。s18 はその loop に Workflow 編成を追加する。s19 はより小さな tool pool で goal-controlled continuation に集中する mechanism example であり、もう一つの累積 runtime ではない
## クイックスタート
@@ -317,7 +317,7 @@ flowchart TD
direction LR
S1["<b>第1段階Agent が動ける</b><br/>━━━━━━━━━━━━━<br/><b>s01 Agent Loop</b><br/>└─ 1つのループ + bash<br/><br/><b>s02 Tool Use</b><br/>└─ 1つのツールから複数へ<br/><br/><b>s03 Permission</b><br/>└─ 実行してよいか判断する<br/><br/><b>s04 Hooks</b><br/>└─ ツール前後に拡張入口を作る"]:::stage1
S2["<b>第2段階複雑な仕事をこなす</b><br/>━━━━━━━━━━━━━<br/><b>s05 TodoWrite</b><br/>└─ 先に計画し、それから実行<br/><br/><b>s06 Subagent</b><br/>└─ サブ Agent が結果を返す<br/><br/><b>s08 Context Compact</b><br/>└─ 長いコンテキストに空きを作る"]:::stage2
S2["<b>第2段階複雑な仕事をこなす</b><br/>━━━━━━━━━━━━━<br/><b>s05 TodoWrite</b><br/>└─ 先に計画し、それから実行<br/><br/><b>s06 Subagent</b><br/>└─ 新しい messages、最終テキストを返す<br/><br/><b>s08 Context Compact</b><br/>└─ 長いコンテキストに空きを作る"]:::stage2
S3["<b>第3段階記憶して回復する</b><br/>━━━━━━━━━━━━━<br/><b>s09 Memory</b><br/>└─ セッションを越えて保存・想起<br/><br/><b>s10 Context Assembly</b><br/>└─ 実行時状態からモデル入力を組み立てる<br/><br/><b>s11 Error Recovery</b><br/>└─ 再試行し、別の道へ"]:::stage3
@@ -369,8 +369,8 @@ flowchart TD
| [s14](./s14_cron_scheduler/) | Cron Scheduler | 永続スケジューリング / セッション限定トリガー |
| [s15](./s15_agent_teams/) | Agent Teams | 永続チームメイト / 原子的認領 / タスクに紐付く Worktree / 型付きプロトコル |
| [s16](./s16_mcp_plugin/) | MCP Plugin | ツール発見 / 名前空間 / ツールプール組み立て |
| [s17](./s17_integrated_harness/) | Integrated Harness | すべての仕組みを 1 つのループへ |
| [s18](./s18_workflow_runtime/) | Workflow Runtime | スクリプト編成 / バックグラウンド実行 / ジャーナル再開 |
| [s17](./s17_integrated_harness/) | Integrated Harness | tools、runtime context、tasks、teams、scheduling、MCP を 1 つの loop へ |
| [s18](./s18_workflow_runtime/) | Workflow Runtime | スクリプト編成 / lifecycle event / ジャーナル再開 |
| [s19](./s19_goal_loop/) | Goal Loop | 目標ゲート / conversation の評価 / 自動継続 |
## プロジェクト構成