如何把一整份代码交给编程 Agent：Prompt-Path 模式

你电脑上有一个跑通了的项目。朋友想让你发过去让他试试。2024 年你会写一份 README。2026 年你写两行：

"请读取 ./news-refiner-kit-v1/ 下的所有文件，安装依赖，
设置隔离环境，然后运行最小可用示例。"

然后你把它粘贴到 Claude Code、Cursor、Cline、Aider，或任何能读文件、跑 shell 的编程 Agent。六十秒后项目就跑起来了。

这就是整个模式。这篇文章讲它为什么有效，以及为什么比 README 更适合交付代码。

1. 编程 Agent 真正需要什么

任何合格的编程 Agent 要在新机器上跑通代码库，只需要三样东西：

• 目标。「让这个项目跑通最小可用示例。」
• 一个具体的读取位置。 一个目录路径，不是一篇博客链接。
• 安装和执行的权限。 任何有终端权限的 Agent 已经具备这个；用户启动 Agent 时一次性授权。

README 给了目标但没给目录。GitHub 链接给了目录但没给目标。Prompt-Path 模式一次性把两者都给齐，只需一次复制粘贴。

2. 两部分的 payload

OpenKitMule 每个套件的详情页都提供同样的两个字段：

• Agent 提示词。 一段用户原样复制的短文字。它告诉 Agent 领域（「Python 数据工程助手」）、目标（「安装 Ollama，拉取模型，运行第一次抓取」），以及占位符 {{CODE_PATH}}。
• 代码路径。 一个具体的目录，如 kits/news-refiner-kit-v1/，出现在下载的 zip 中。

页面在渲染时把 {{CODE_PATH}} 替换成实际路径，所以用户看到的提示词永远是可以直接粘贴的，无需手动编辑。

来自 News Refiner Kit 的真实示例：

你是一个 Python 数据工程助手。请阅读 kits/news-refiner-kit-v1/ 下的所有文件，
理解新闻抓取管道、本地 LLM 摘要器和输出格式，
然后帮助用户安装 Ollama、拉取模型并运行第一次抓取。

3. 为什么这比 README 更好

• README 会过时。 代码变了，README 没跟上。Agent 读取当前源码永远比滞后的文档更准确。
• README 假设单一环境。 它说「运行 pip install」，但不知道你用的是没有 pip 的 Python 3.13，或者 macOS 上 Homebrew 软链坏了。Agent 会检查并适配。
• README 跳过无聊的部分。 「设置 API 密钥」在 README 里是一行，对新用户却是 20 分钟的困惑。Agent 会一步步带用户完成 export 或 dotenv 编辑。
• 错误会被修复，而不是被记录。 如果依赖安装失败，Agent 会排查。README 只会告诉你「应该发生了什么」。

4. 如何设计一个好的 Agent 提示词

在交付了四个套件（News Refiner、Agent Scraper、Kronos、PromptForge）后，我们总结出了四条提示词设计规则。

1. 一句话定角色。 「你是一个 Python 数据工程助手。」这缩小了 Agent 的风格选择，但不过度约束。
2. 指向目录，不是文件。 Agent 一个工具调用就能列出目录。指向单个文件会迫使它猜测兄弟文件。
3. 命名可验证的目标。 「运行第一次回测」、「运行第一次抓取」、「打印示例 prompt 的 token 数」。可验证的目标把「聊天」变成「任务」。
4. 在危险边缘加警告。 交易套件会说「上线前请在模拟盘上验证策略」。爬虫套件会说「遵守 robots.txt」。提示词是 Agent 行动前读的最后一段文字，所以把护栏放这里。

5. 目前已支持哪些 Agent

• Claude Code — 终端原生，多文件编辑和长会话能力最强。
• Cursor — 基于 IDE；Agent 模式读取工作区并运行命令。
• Cline（开源） — VS Code 扩展，自带 API 密钥。
• Aider — Git 优先的 CLI Agent，特别适合「读这个仓库然后让它跑起来」。
• ZCode / Kimi Agent / GLM Coding — 中文市场带终端权限的编程 Agent。
• ChatGPT / Claude 网页版（高级数据分析或代码解释器） — 在沙盒中运行；同样的提示词仍然适用，只是针对上传的 zip。

这个模式刻意保持 Agent 无关。如果你的提示词要求特定 Agent，说明写错了。

6. 什么会破坏这个模式（避免这些）

• 硬编码的主目录。 代码路径中的绝对用户路径意味着每个其他用户都要先编辑再粘贴。永远使用与 zip 结构匹配的相对路径。
• 密钥放进仓库。 如果 Agent 需要密钥，提示词应该说「提示用户输入 API 密钥」，而不是假设已经存在。
• 过长的提示词。 四页的提示词告诉 Agent 的内容，它从代码里都能学到。保持在 80 词以内。
• 缺少可验证的目标。 「理解这个项目」不可验证。「运行第一次抓取并展示前三条结果」可以。

7. 60 秒试一试

下载 News Refiner Kit 的 zip，解压，然后把产品页渲染好的提示词粘贴到 Claude Code 或 Cursor。这就是整个流程。没有注册、没有支付、没有平台层。

如果想要一个更小、零依赖的示例，先试试 PromptForge — 一个 Python 文件，仅标准库，约一分钟就能用上。

8. 延伸阅读

• OpenKitMule 工作流原始教程 — 中文版。
• 上线前估算 LLM API 费用 — 姊妹文章，使用 PromptForge 作为工具。
• Ollama 本地新闻摘要 — Prompt-Path 模式在真实 Ollama 管道上的应用。
• Agent Scraper Kit — 更长的示例，Prompt-Path 模式应用于爬虫框架。
• Kronos — 模式同样适用于 OpenKitMule 只托管提示词、不托管代码的套件。