From da9e54d96d1dc6c384d6e4d37691ab4826c30994 Mon Sep 17 00:00:00 2001 From: kicer Date: Fri, 25 Sep 2026 16:42:14 +0800 Subject: [PATCH] =?UTF-8?q?prompt=E4=B8=AD=E6=8A=80=E8=83=BD=E5=88=97?= =?UTF-8?q?=E5=87=BA=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- app/server/tools/skills.js | 13 +++++++++---- docs/ARCHITECTURE.md | 2 +- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/app/server/tools/skills.js b/app/server/tools/skills.js index fb1409a..feaa7ed 100644 --- a/app/server/tools/skills.js +++ b/app/server/tools/skills.js @@ -70,14 +70,19 @@ async function listSkills(ctx) { } // ---------- system prompt 注入:可用技能列表 ---------- -// 把技能列表格式化成 “## Available Skills” 段落(仅名字,每行一个,省 token; -// 描述查 op=list,参数查 op=get)。 +// 把技能列表格式化成 “## Available Skills” 段落(每行 `- 名字: 描述`; +// listSkills 已按名字 localeCompare 排序,行序恒定,不破坏前缀缓存; +// 参数查 op=get,执行 op=run;描述如需实时复核仍可查 op=list)。 // 由 llm.setSkillListText 拼入 system prompt:启动时快照(server.js)与技能变更后 // (routes/skills.js 的创建/重命名/删除/文件变更)调用,让模型直接感知已装技能, -// 省掉先 op=list 探索的往返;op=list 保留作实时描述/兼容性查询。 +// 省掉先 op=list 探索的往返。 function formatSkillListForPrompt(list) { if (!list || !list.length) return ''; - const lines = list.map(s => '- ' + s.name); + const lines = list.map(s => { + // 描述压成单行:YAML 块标量可能带换行,不能让它撞破列表结构 + const desc = String(s.description || '').replace(/\s*\n\s*/g, ' ').trim(); + return '- ' + s.name + (desc ? ': ' + desc : ''); + }); return '## Available Skills\n' + lines.join('\n'); } diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 85d6fda..e4c7a1e 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -323,7 +323,7 @@ stateDiagram-v2 - init 的 pip 步骤先离线探测(`pip install --no-index --dry-run <逐行>`,不联网):镜像已带的包直接跳过,只把缺的装进 `deps/`;`.deps_installed` marker(requirements/install.sh 两份 hash)也在那里维护。 - 外挂层可见性:`skills/deps` 由 compose 放进 executor 容器 env 的 `PYTHONPATH`(`server.js` 白名单同步放行),技能入口与 AI 终端命令都能 import;运行期 skills 与 deps 均 `:ro`,**加包只需改 `requirements.txt` 后 `docker compose up -d`(重跑 init),不需重建镜像**。 - `runSkill` 流程:`input_args` 类型守卫(非对象早拒,免得在 Object.entries 里静默错位) → `skillDir` 校验 → `absolutizeArgs`(按任务目录 + 启发式判断路径类参数) → `validateArgs`(按 front matter `input_schema.required`,缺项报错点名字段) → 选 `python3 run.py ''` 或 `bash run.sh ''` → `runEntry`。 -- system prompt 注入(`formatSkillListForPrompt`)只列名字省 token;描述查 op=list、参数查 op=get、执行 op=run(`skill` 工具),op 间依赖写进工具 description。 +- system prompt 注入(`formatSkillListForPrompt`)按 `- 名字: 描述` 每行一个(listSkills 已按名字排序,行序恒定不破坏前缀缓存;描述压单行);参数查 op=get、执行 op=run(`skill` 工具),op 间依赖写进工具 description。 - **走 executor**:命令拼成 `shq` 转义后的单条 shell 行(`shellLine`);env 不额外传,依赖层由容器 env 提供。 - **cwd 分两类**:`skill` op=run 传会话任务目录(`ctx.taskDir`),命中 executor 的 session 隔离与虚拟视图,技能在 `/workspace/tasks/` 看到的就是本会话数据,`absolutizeArgs` 产出的绝对路径因此有效;入口脚本一律用绝对路径(cwd 已不是技能目录)。