DeepCode 怎么用 path 文件引用和 $skill 内联调用在一次对话中给 Agent 补上下文【免费下载链接】DeepCodeDeepCode: Open Agentic Coding (Agent Harness Loop Engineering Multi-Agent Orchestration)项目地址: https://gitcode.com/GitHub_Trending/deepc/DeepCode在 DeepCode 的终端 UITUI里对话时常见的问题是你要让 Agent 基于某个具体文件干活或按某个既定的 Skill 手册操作但默认情况下 Agent 要先花一轮工具调用去找文件、读文件。DeepCode 的输入层提供两种行内引用——path把文件内容直接附到消息里$skill-name在当前回合内联激活一个 Skill——两者可以在同一条消息里一起使用让 Agent 在下一轮开始时就直接拥有这些上下文。本文的前提你已按 Getting started 装好 DeepCode 并配好至少一个可用的模型连接你正在目标项目目录下运行deepcode进入 TUI。两种引用语法的完整说明在 The terminal UI 的 Inline references 一节Skill 的发现与存放规则在 Skills and memory。准备条件先确认环境满足两条已进入 TUI。安装与启动按 Getting started 走uv tool install --python 3.12 deepcode-hku deepcode init deepcode provider set my-openrouter --template openrouter --api-key deepcode provider models my-openrouter --refresh deepcode provider test my-openrouter --model deepseek/deepseek-v4-pro然后在项目目录启动cd your-project deepcode第一次指向某个文件夹时会询问Trust this folder? Type yes to continue:信任是按文件夹记住的。启动后的横幅会显示当前模型、session id 和访问权限级别如access default (ask)。your-project换成你自己的项目目录。要用的 Skill 已被发现。Skill 是一个包含SKILL.mdYAML frontmatter 说明的文件夹采用开放的 Agent-Skills 格式。发现位置repo/.agents/skills/ ← 项目 Skill随仓库走 ~/.agents/skills/ ← 用户 Skill所有项目可用在 TUI 里输入/skills会列出所有已发现的 Skill这是确认某个 Skill 当前是否可用的直接方式。用path把文件内容附进消息path的作用是attach a files content to your message输入后 Tab 补全会在工作区内按目录行走文件内容以 fenced block 形式随消息送达模型无需再走一轮 Read 工具调用就能读到它。文档示例› the parser in src/config/loader.py rejects valid YAML — why?后面跟的是相对工作区的路径路径 token 结尾的,、;、:会被去掉后再解析所以src/config/loader.py,这样的写法也能命中。解析行为有两个边界来自 cli/tui/input.py 中expand_file_refs的实现文件必须能解析到工作区内部且是普通文件大小不超过128 KB不满足的 token 不会被附加。解析不了的 token可能是邮箱、装饰器等原样保留发送前不做猜测式替换。用$skill-name在当前回合激活 Skill$skill-name用于invoke a skill inline, with completion over active skills输入$后补全候选来自状态为 active 的已发现 Skill。文档示例› $code-review the changes on this branch等价的替代路径是斜杠命令/skill id|name把某个 Skill arm 到下一回合/skills查看清单。注意 Skill 只加载一个回合——文档说明这是 progressive disclosure 设计Skill 全文不会常驻进每个请求所以$行内调用和/skill一样都只作用于紧随其后的那一轮。在同一条消息中组合两者两种引用由同一个输入层解析cli/tui/app.py 中每条提交的普通消息都会先经过expand_file_refs展开再连同选定的 Skill 一起发送因此可以在一条消息里同时使用。下面这条消息组合了上文两个文档示例中的 token仅作演示› $code-review the diff in src/config/loader.py and check the retry limits发送后期望看到的行为Agent 本轮直接拿到src/config/loader.py的完整内容和code-reviewSkill 的说明从第一个工具动作开始就针对这些内容工作而不是先搜索、再读文件。验证上下文是否真的送达文档给出的可核对信号Skill 选择有回显。通过/skill id|name激活时TUI 会输出形如selected skill-name for the next turn的状态行/skills列表中被选中的 Skill 行前带*标记。如果你用$行内调用且该 Skill 未被发现输入阶段就不会出现对应补全这是最简单的Skill 不存在/不可用信号。文件附加免去一轮工具往返。文档对path的说明是the file arrives as a fenced block, so the model reads it without a tool round-trip。对照判断回复卡片里不应先出现针对该文件的 Read 工具卡● Read src/...而应直接进入分析或编辑。Token 消耗可对照。每个回合结束时的浅色脚注如 Getting started 中示例的· 12s · 9.4k in · 210 out此为文档示例是 provider 返回的真实数值附加了文件内容后in的 prompt token 量应能反映附加进去的文件体积这是判断内容是否真的进了请求的量化旁证。限制与边界附加文件大小上限 128 KB超限文件不会被内联此时应让 Agent 自己读文件或只引用其中的片段路径所在的更小文件。只能引用工作区内的文件指向工作区外的路径解析失败后 token 原样保留。Skill 只影响 Agent 的指导内容they can never grant permissions or bypass trust — policy always wins$调用不会提升任何工具权限敏感操作仍按会话的 access 预设走审批。行内引用服务于补上下文这一件事会话中断恢复、权限切换等分别由/resume、/permissions处理不在本场景范围内。进一步阅读完整的 TUI 命令与快捷键见 The terminal UISkill 目录、AGENTS.md项目指令与 memory 机制见 Skills and memory。【免费下载链接】DeepCodeDeepCode: Open Agentic Coding (Agent Harness Loop Engineering Multi-Agent Orchestration)项目地址: https://gitcode.com/GitHub_Trending/deepc/DeepCode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考