Documentation v0.28.0

v0.19.3 -> v0.19.4

Summary

Token-efficient tool prompts (description and parameter-schema hygiene across 8 built-in tools), explicit tool registration across the registry, and download_page split into separate fetch_page / save_page_to_file handlers.

翻譯 壓縮 8 個內建 tool 的 description 與 parameter schema(省 token),tool registry 改全面顯式註冊,並將原 `download_page` 拆為 `fetch_page` 與 `save_page_to_file` 兩支獨立 handler。

Changes

UPDATE

翻譯
  • 壓縮 search_webfetch_google_rssfetch_yahoo_financeanalyze_youtubesend_http_requestlist_filesglob_filesrun_command 的 description 與 parameter schema —— 砍 Use to ...Supports ... for user home(Optional) ... 等填充句型,enum/default 交回 JSON schema,並以 JSON 欄位名稱(titleurldescription)自述輸出結構。多 provider 路由下可觀降低 prompt cache 內 tool context 的 token 消耗。
  • run_command description/command 參數明寫禁止 cd 前綴,避免 agent 持續預綴 cd <workdir> && 被 sandbox allowlist 擋下並誤判錯誤訊息。
  • 拆分 fetch_page(回傳 markdown 內容)與 save_page_to_file(寫檔)為兩支獨立 tool;原本由單一 download_page 兼任。
  • 放寬 invoke_subagent 參數預設,避免最小引數呼叫被 validator [RETRY_REQUIRED] 彈回。

REFACTOR

翻譯
  • internal/tools/register.gocmd/app/main.go 全面改以顯式 Register() 取代 scanner 自動探測,calculator/external agent/fetch-page/file tool 註冊路徑靜態可追。
  • 註冊名 download_page 改為 save_page_to_file;實作重分佈於新檔 fetchPage/fetchPage.gofetchPage/savePageToFile.gofetchPage/check.go,移除舊 download.goload.go
  • subagent 註冊從 internal/agents/subagent/ 搬至 internal/tools/subagent/,調整 blank-import 位置。

Files Changed

File Status Tag
cmd/app/main.go Modified REFACTOR
internal/tools/register.go Modified REFACTOR
internal/tools/calculator/register.go Modified REFACTOR
internal/tools/externalAgent/register.go Modified REFACTOR
internal/tools/file/register.go Modified REFACTOR
internal/tools/runCommand.go Modified UPDATE
internal/tools/external/toolAdapter.go Modified UPDATE
internal/tools/external/googleRSS/register.go Modified UPDATE
internal/tools/external/googleRSS/fetch.go Modified REFACTOR
internal/tools/external/searchWeb/register.go Modified UPDATE
internal/tools/external/searchWeb/fetch.go Modified REFACTOR
internal/tools/external/yahooFinance/register.go Modified UPDATE
internal/tools/external/yahooFinance/fetch.go Modified REFACTOR
internal/tools/external/youtube/register.go Modified UPDATE
internal/tools/external/youtube/fetch.go Modified REFACTOR
internal/tools/file/listFiles.go Modified UPDATE
internal/tools/file/globFiles.go Modified UPDATE
internal/tools/fetchPage/fetchPage.go Added REFACTOR
internal/tools/fetchPage/savePageToFile.go Added REFACTOR
internal/tools/fetchPage/check.go Added REFACTOR
internal/tools/fetchPage/download.go Deleted REFACTOR
internal/tools/fetchPage/load.go Deleted REFACTOR
internal/tools/fetchPage/register.go Modified REFACTOR
internal/tools/fetchPage/skipped.go Modified REFACTOR
internal/tools/fetchPage/embed/skipped.md Modified UPDATE
internal/tools/subagent/subagent.go Renamed REFACTOR
configs/prompts/system_prompt.md Modified DOC
configs/prompts/skill_execution.md Modified DOC
doc/architecture.md Modified DOC
doc/architecture.zh.md Modified DOC
doc/doc.md Modified DOC
doc/doc.zh.md Modified DOC

Generated by SKILL