Digest format
Digest format
Format the workspace digest as a short markdown list, largest files first when it helps. Keep it under ~15 lines unless the user asks for the full listing. Group by top-level directory when there are many files.
约定内容:
- 输出为简短 markdown 列表,必要时按大文件优先排序;
- 控制在约 15 行以内,除非用户要求完整清单;
- 文件很多时按顶层目录分组。
这个文件的价值在于**解耦**:格式规范不写死在脚本里,模型与脚本都可以通过 `ctx.files` 读取这份契约,未来想调整输出风格只需改这一个文件,无需改动代码。这也是 Skill 目录布局的通用模式——`references/` 放非代码资产,`scripts/` 放可执行脚本。
## 四、底层机制:SkillRunContext 与技能脚本运行器
### 4.1 ctx.workspace 从哪来:共享工作区代理
`workspace-digest` 能盘点"同一个用户在多个聊天中共享的工作区",靠的是示例应用精心设计的共享工作区链路:
- 在 <a href="https://link.gitcode.com/i/7e0dcb5cb6b8c353653031ea41589842" target="_blank">AssistantDirectory(目录 Agent)</a> 中,`workspace = new Workspace({ sql: this.ctx.storage.sql, ... })` 用目录自身的 SQLite 支撑工作区,并注册 `onChange` 钩子把文件变更广播给所有客户端,实现跨聊天、跨标签页的实时文件浏览。
- 每个聊天对应的 `MyAssistant` 通过 <a href="https://link.gitcode.com/i/096b726aa32c00daeb05595539a7a080" target="_blank">SharedWorkspace</a> 代理访问这份共享工作区——代理把 `readFile`、`glob`、`stat` 等全部调用转发到父目录的 RPC 方法,从而让技能脚本的 `ctx.workspace.glob()` 透明地读到共享文件。
从源码看,`SharedWorkspace` 实现了 `@cloudflare/shell` 的 `WorkspaceFsLike` 接口(它是 Think 内部 `WorkspaceLike` 的严格超集),因此它既能满足 Think 内置工具的读写需要,也能支撑技能脚本的只读扫描。由于父子是同一 Durable Object 机器上的 facet,每次调用只是一次进程内 RPC 跳转,成本很低。
### 4.2 run_skill_script 与 getSkillScriptRunner
技能脚本能被执行,依赖 Think 的 `run_skill_script` 工具。在 <a href="https://link.gitcode.com/i/1ccfe2f0cf74980bc3d2467536f9f068" target="_blank">MyAssistant.agent.ts</a> 中可以看到启用方式:
```ts
getSkills() {
return [bundledSkills];
}
getSkillScriptRunner() {
return skills.runner({
loader: this.env.LOADER,
workspaceInstance: this.workspace
});
}
登录后查看全文