关于 token-efficient-workflow
面向编码 Agent 的工作技能，帮助减少无关上下文，同时保留必要推理与验证。它规范证据收集、代码检索、结果摘要和任务沟通。
主要功能
- 01从最小证据入手
- 02聚焦代码与文件检索
- 03摘要大型输出
- 04不省略必要验证
- 05维护精简进度摘要
适用场景
- 01调查特定故障或行为
- 02为任务定位大型代码库
- 03处理大型文档或数据文件
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/token-efficient-workflow确认已加载。
附带文件agents/openai.yaml
详细介绍
高效利用 Token 的工作流
目标
正确完成任务，同时尽量减少不必要的上下文增长。节省 Token 的方式是少读取无关数据，而不是跳过必要的推理、验证或面向用户的功能。
默认操作规则
- 从范围最小且有用的证据入手。
- 优先进行有针对性的读取，而不是扫描整个项目。
- 继续分析前，先总结较大的输出。
- 只有当前证据不足时，才扩大范围。
- 保持质量：不要为了节省 Token 而省略必要的验证。
任务接收
使用工具前，先确定：
- 正在调查的确切产物或行为。
- 可能最有价值的文件、路由、日志、配置或 UI 元素。
- 能确认下一项事实的最小命令或读取操作。
如果请求范围较广，先将其转化为范围较窄的初步调查。例如，将“全面了解此项目”转化为“确定框架、入口点、配置、路由，以及最可能与所请求任务相关的文件”。
代码库搜索
搜索文本或文件时，先使用 rg，但要限制范围：
- 优先使用
rg -n "specific term" path\to\likely\dir，而不是搜索整个仓库。 - 优先使用
rg --files path\to\likely\dir，而不是在项目根目录运行rg --files。 - 使用错误、路由名称、表名、函数名称、类名、配置键或可见 UI 标签中的具体关键词。
- 除非搭配较窄的路径或其他关键词，否则避免递归搜索
token、config、admin、index、error或install等通用词。 - 如果命令可能产生大量行，请使用明确的路径、更严格的匹配模式或少量后置过滤来限制输出。
必要时可以进行广泛扫描，但要说明原因，并且只运行一次。用户每次发消息后，都不要重复完整扫描。
文件读取
在适用时，按以下顺序读取文件：
- 较小的元数据文件：包清单、composer 文件、框架配置、路由定义。
- 入口文件和引导文件。
- 与任务相关的特定控制器、模型、服务、视图、迁移或脚本。
- 相关时间戳或错误附近的日志。
- 仅当以上内容无法解释问题时，再查看更广泛的项目结构。
对于较大的文件，请先读取文件头、结构定义、特定章节或抽样行。除非任务需要完整分析，否则不要将完整的 Excel、Word、SQL 转储、JSON 导出、日志或生成文件加载到上下文中。
工具输出规范
在任何大型工具输出后：
- 提取关键事实、路径、行号和后续操作。
- 不要向用户粘贴或复述大量原始输出。
- 只要简洁的工作摘要足以支撑后续步骤，就不要基于完整原始输出继续操作。
如果输出被截断，应将其视为缩小下一条命令范围的信号，而不是再次运行相同的广泛命令。
浏览器调试
使用应用内浏览器或浏览器自动化时：
- 只检查当前任务相关的页面状态、元素、控制台错误、网络请求或表单值。
- 如果 URL 和目标区域未发生变化，避免反复截取整个页面。
- 对于 UI 问题，只收集最少的证据：当前 URL、可见错误文本、相关元素状态、控制台或网络错误，以及复现步骤。
- 浏览器检查后，简要总结当前状态，再继续操作。
长对话处理
对于较长的任务，应定期维护简洁的工作摘要：
- 当前目标。
- 已确认的事实。
- 已更改或检查的文件。
- 已作出的决定。
- 尚未确定的问题。
- 下一条命令或编辑操作。
用户说“继续”时，根据此摘要恢复操作。除非摘要已过时或与新信息矛盾，否则不要重新扫描整个项目。
PHP/ThinkPHP 和部署任务
针对用户常见的 PHP/ThinkPHP 和部署工作：
- 在进行大范围源码搜索前，先检查框架版本、入口文件、路由配置、环境配置、数据库配置、运行时日志和 Web 服务器配置。
- 对于 404、安装、管理后台或登录问题，先检查路由、public 文档根目录、重写规则、控制器路径和近期日志。
- 对于部署问题，检查必需的环境变量、数据库连通性、运行时版本、构建和启动命令，以及一段相关的失败日志。
- 除非确有必要，否则不要输出所有路由、所有控制器、所有数据库行或所有日志。
大型文档和数据文件
对于 Excel、Word、PDF、SQL、JSON、CSV 和日志量较大的任务：
- 先检查文件大小、工作表名称、标题、架构、行数或文档结构。
- 只读取相关的工作表、范围、章节或错误时段。
- 如有可用工具，请使用脚本或结构化解析器。
- 提取的数据摘要应简洁，并与任务相关。
与用户沟通
默认使用简洁的中文。及时更新有助于用户了解进展：
- 说明正在收集哪些范围明确的证据。
- 说明何时扩大范围以及原因。
- 在最终回复中，说明原因、变更或检查内容、验证结果和后续步骤（如有）。
不要让用户在质量和节省 Token 之间做选择。工作流程应通过避免无关工作来节省 Token，同时仍需完成并验证任务。