mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 14:27:30 +00:00
docs(skills): 按需插件 skill 对齐仓内规范 + 文件操作强制走 files 插件
## 1. 文件操作必须走 files 插件(用户明确要求) 旧 skill 写着「如果你已经有 run_shell / bash 之类的能力,优先用那个 —— 它更直接」, 与「文件操作必须走 files_*」相悖。改为: - 所有已知内容的读写一律 files_read/files_write/files_edit/files_edit_line; - 不用 cat/echo/sed/tee/重定向代替(shell 拼长文本会被引号转义吃掉, 且重定向会截断原文件,而本插件是原子写 + 写前留档); - 唯一例外:文件是命令的副产物(go build -o、git clone、日志重定向)。 cmd-tools skill 同步补一条:文件读写不要用 shell 代替。 ## 2. 三个新 skill 对齐 ai_image 等既有规范 - 结构统一为:什么时候用 / 先拉起插件(plugin_start 代码块)/ 工具表 / 用完可释放(plugin_stop)/ 注意 / 「plugin_stop vs plugin_disable」对照表; - 修正上一版的错误:把 `plugin_enable` 写成拉起方式 —— 那是**持久**解禁, 会改开机行为;按需拉起应使用 `plugin_start name=<插件>`。 - files skill 保持 auto_start=false(与「大部分插件不需要自启」一致), 但把「怎么拉起」写清楚。 ## 3. cmd_run 描述补充能力边界 「经完整 bash 执行,支持管道、分号、&&、命令替换、heredoc、重定向; 不支持交互(vim/ssh/top 用 terminal_create)」。 验证:四工程 hmapdev 构建通过;本机重装后 skills_registered=1; 问 agent 写文件时它先 plugin_start 再 files_write/files_read,未用 shell 代替。
This commit is contained in:
@ -105,7 +105,7 @@ func (p *Plugin) Start(s *sdk.PluginSDK) error {
|
||||
|
||||
s.RegisterTool("cmd_run", sdk.ToolDef{
|
||||
Name: "cmd_run",
|
||||
Description: "执行一条系统命令并返回输出。适用于查询系统信息、运行脚本、操作文件等单次命令场景。命令在临时 shell 中执行,不支持交互。如需交互式终端(如 vim、ssh、top),请使用 terminal_create 相关工具。",
|
||||
Description: "执行一条系统命令并返回输出。适用于查询系统信息、运行脚本、操作文件等单次命令场景。经完整 bash 执行,支持管道、分号、&&、命令替换、heredoc、重定向;不支持交互(vim/ssh/top 这类需要持续输入的程序请用 terminal_create,不要硬等它退出)。",
|
||||
NoMemory: true,
|
||||
Parameters: map[string]interface{}{
|
||||
"type": "object",
|
||||
|
||||
Reference in New Issue
Block a user