跳到主要内容

上下文与规则

后端团队给 AI 的最大帮助,不是“写一个更长的 prompt”,而是把 repo contract、运行命令、架构边界和风险点做成稳定上下文。只要上下文包不稳定,AI 每次都会重新猜 controller 该不该改、migration 该不该写、测试要不要补。

专题拆分阅读

这一页现在作为“后端机制总览”保留;更细的内容已经拆到几个专门子页:

方向对应子页
规则与规范文档规则与规范文档
Skills 与 MCPSkills 与 MCP
工具匹配与选型工具匹配与选型

如果你现在要治理仓库规则,优先看“规则与规范文档”;如果你正在组织真实任务输入,继续看 “Skills 与 MCP” 和 “工具匹配与选型” 会更直接。

让 agent 进入任务前先拿到什么

一个够用的后端任务上下文包通常包括:

  • 相关模块或服务边界说明。
  • 启动、测试、lint、migration、smoke 命令。
  • 请求/响应样例、错误码表、鉴权和幂等规则。
  • 关键环境变量、依赖服务和 fixture 数据位置。

这类信息最好写进仓库级说明文件,而不是散落在聊天记录里。可以从 仓库 instruction files 规范Prompt Contracts 两篇开始整理。

repo contract 和工具局部规则怎么分工

repo contract 负责稳定事实

适合写在 AGENTS.mdCLAUDE.md 或团队统一文档里的内容包括:

  • 目录边界和禁止跨层改动的规则。
  • migration、contract、测试和发布的最低门禁。
  • review 必须附带的证据。

工具局部规则负责入口习惯

Cursor、Cline、Claude Code 等工具的 rules 更适合承接:

  • 交互方式。
  • 输出格式。
  • 默认命令偏好。

不要把“仓库真实约束”只写在某个工具的本地 rules 里,否则其他 agent 根本看不到。

后端任务最适合什么样的 prompt 包

相比“帮我生成一个接口”,更有效的写法通常是:

  1. 变更目标:新增字段、修改鉴权、接入 provider、补队列消费。
  2. 受影响边界:controller、contract、migration、job、dashboard。
  3. 必过验证:lint、type-check、integration test、smoke、build。
  4. 不可破坏项:旧客户端兼容、幂等语义、PII 脱敏、超时预算。

当这些约束清楚后,再结合 Terminal-First Repo PairingBugfix / Refactor / Test 执行,通常会比自由对话稳定得多。

适合后端团队复用的知识入口

后端机制区的默认模板入口

如果你已经知道当前最缺的是“可复制模板”,最值得先去的是 模板与交付资产 以及下面几份子模板:

下一步