Prompt

Prompt 是当前任务说明：要解决什么问题、可以使用哪些上下文、边界在哪里、什么结果算完成。目标是降低误解、减少无效探索、让结果可验证。

这里的 Agent 泛指能理解任务、读取上下文、调用工具并产出结果的 AI 工具。界面、模型、文件引用语法和权限可以不同。

分工

长期项目规则 -> AGENTS.md / 项目规则
可复用任务流程 -> Skill / Workflow
外部工具与实时信息 -> MCP / 插件 / API
当前任务 -> Prompt

Agent 还会综合这些信息做决策：

• 当前 Prompt：目标、范围、约束、输出要求。
• 上下文：打开的文件、选中代码、对话历史、仓库文件、错误日志、截图、外部资料。
• 项目规则：AGENTS.md、团队规范、代码风格、测试要求、安全边界。
• 可用能力：文件读写、终端、浏览器、搜索、MCP、插件、子任务代理。
• 工具限制：能否联网、写文件、执行命令，是否需要人工确认。

Prompt 只写本次必须遵守的信息：目标明确、上下文足够、范围有限、约束可执行、验收可验证。

结构

目标 -> 背景 -> 范围 -> 约束 -> 验收标准 -> 输出要求

上下文已经明确、任务小、风险低时，一句话即可。需要猜测项目结构、业务目标或验收标准时，补全上述各项。

边界

放项目规则：包管理器与构建、测试命令，代码风格，提交规范，目录约定，生成文件与敏感文件，高风险操作，以及目录对应的规范。

放 Prompt：本次问题、允许修改的范围、必须保留的行为、本次风险、输出格式。

流程已在 Skill 中时，点明使用哪份流程，或只描述任务并要求遵循已有规范。步骤不整份抄入。

依赖仓库外信息时，写明要查什么、禁止什么。只授予本次需要的信息和权限。

易错点

• 目标写到具体模块和可观察结果。
• 范围限定在相关目录，并写明不修改的部分。
• 验收标准写成可验证行为，包含测试、lint 等检查。
• 先说明问题和约束。直接指定实现方式，可能掩盖真正的问题。