mirror of
https://github.com/shareAI-lab/analysis_claude_code.git
synced 2026-10-30 18:24:05 +08:00
docs(s02): explain why specialized tools matter (#562)
Clarify that specialized tools structure the model-harness interface for safer arguments, precise permissions, and shared logging. Keep the English, Chinese, and Japanese lessons in sync and regenerate the web content.\n\nRefs #549
This commit is contained in:
@@ -17,6 +17,14 @@ s01 の Agent には bash 一つのツールしかない。ファイルを読む
|
||||
|
||||
---
|
||||
|
||||
## Bash だけでできるのに、なぜツールを追加するのか?
|
||||
|
||||
これらのツールは Agent の素の能力を増やすものではない。同じ操作は Bash でも実行できる。改善するのは、モデルと Harness の間のインターフェースだ。`path` 引数を持つ `read_file` 呼び出しなら、モデルは意図を shell 構文へ変換する必要がなく、引用符やエスケープのミスを減らせる。
|
||||
|
||||
Harness が受け取るのも、不透明な command string ではなく、名前付きの操作と構造化された input になる。そのため後の policy をより正確に適用できる。s03 では tool と path ごとに許可・拒否を判断し、s04 では共通の hook point で操作を log できる。s02 は、これらの章が利用する dispatch structure を先に用意している。
|
||||
|
||||
---
|
||||
|
||||
## 概要:ツールディスパッチ
|
||||
|
||||

|
||||
|
||||
@@ -17,6 +17,14 @@ The model thinks "read this file" but has to spell out `cat path/to/file`. An ex
|
||||
|
||||
---
|
||||
|
||||
## Why Add Tools If Bash Can Already Do It?
|
||||
|
||||
These tools do not give the Agent new raw capabilities — Bash can perform the same operations. They improve the interface between the model and the Harness. A `read_file` call with a `path` argument avoids translating intent into shell syntax, reducing quoting and escaping mistakes.
|
||||
|
||||
The Harness also sees a named operation and structured inputs instead of an opaque command string. That makes later policies more precise: s03 can approve or reject operations per tool and path, while s04 can log them at a shared hook point. s02 establishes the dispatch structure those chapters build on.
|
||||
|
||||
---
|
||||
|
||||
## Overview: Tool Dispatch
|
||||
|
||||

|
||||
|
||||
@@ -17,6 +17,14 @@ s01 的 Agent 只有一个 bash 工具。读文件要 `cat`,写文件要 `echo
|
||||
|
||||
---
|
||||
|
||||
## Bash 已经能做这些事,为什么还要加工具?
|
||||
|
||||
这些工具没有给 Agent 增加新的原始能力——同样的操作 Bash 都能完成。它们改善的是模型与 Harness 之间的接口。调用带有 `path` 参数的 `read_file` 时,模型不必把意图翻译成 shell 语法,因此能减少引号和转义错误。
|
||||
|
||||
Harness 看到的也不再是一整条不透明的命令字符串,而是具名操作和结构化参数。这样后续策略可以更精确:s03 能按工具和路径决定放行或拒绝,s04 能在统一 hook 点记录操作。s02 先搭好这些章节依赖的分发结构。
|
||||
|
||||
---
|
||||
|
||||
## 全局视角:工具分发
|
||||
|
||||

|
||||
|
||||
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user