Documentation v0.28.0

v0.18.1 -> v0.18.2

Summary

Improve tool-call reliability by correctly handling stub tools and streamed function-call arguments, while tightening absolute-path guidance and file path resolution across prompts, schemas, and filesystem helpers.

翻譯 改善工具呼叫穩定性,正確處理 stub 工具與串流函式參數,同時在提示詞、工具 schema 與檔案系統輔助邏輯中強化絕對路徑指引與路徑解析。

Changes

FEAT

翻譯
  • 新增 TUI 輸入模式切換,可透過 Tab 鍵在命令執行與 agent 訊息模式間切換。

FIX

翻譯
  • 透過 search_tools 自動載入 stub 工具 schema,之後再以實際參數重新呼叫工具。
  • 改為從工具 schema 驗證必要參數,不再使用硬編碼規則,並補強無效 JSON 與缺欄位錯誤訊息。
  • 從 Codex SSE 事件重建串流函式呼叫參數,確保工具呼叫能以正確 payload 完成。
  • 在絕對路徑解析中允許使用者家目錄根路徑,而不再把 home 目錄本身誤判為非法。
  • 啟動 app 時改為同步執行 skill 同步流程,而非非同步派發。

UPDATE

翻譯
  • 在 system prompt 與 skill execution prompt 中明確說明檔案工具優先使用絕對路徑,且相對路徑會以工作目錄為基準解析。
  • 新增 prior-summary context prompt,明確標示摘要內容僅供參考,且不可在回覆中重述。
  • 擴充 glob_files,支援 ~、絕對路徑 pattern、無 glob 字元時的直接檔案比對,以及未使用 ** 時的更快匹配路徑。
  • 更新 skill-creator 指令,改用明確的 python3 scripts/init_skill.py 指令格式。

Files Changed

File Status Tag
cmd/app/main.go Modified FIX
configs/prompts/skill_execution.md Modified UPDATE
configs/prompts/summary_context.md Added UPDATE
configs/prompts/system_prompt.md Modified UPDATE
extensions/skills/skill-creator/SKILL.md Modified UPDATE
internal/agents/exec/toolCall.go Modified FIX
internal/agents/provider/openaiCodex/send.go Modified FIX
internal/filesystem/absPath.go Modified FIX
internal/session/summary.go Modified CHORE
internal/tools/file/globFiles.go Modified UPDATE
internal/tools/file/listFiles.go Modified CHORE
internal/tools/file/patchEdit.go Modified CHORE
internal/tools/file/readFile.go Modified CHORE
internal/tools/file/readImage.go Modified CHORE
internal/tools/file/writeFile.go Modified CHORE
internal/tui/commandMode.go Modified FEAT
internal/tui/globalShortcut.go Modified FEAT
internal/tui/new.go Modified FEAT

Generated by SKILL