这一节最容易踩的坑,就是一看到任务就立刻改代码。其实更稳的做法,是先确认工作区边界、扫描项目结构、读取 AGENTS.md,再识别规则和测试入口。这样做的意义很直接:先知道什么能动、什么不能动、测试怎么跑,后面每一步才不会越界。
![图片[1]-小节一:项目入口怎么设计——Coding Agent 进入陌生项目以后,第一件事不是改代码-大赛人网](https://www.dsrw.com/wp-content/uploads/2026/11/image-1796.png)
一个常见实现会直接从:
“请修这个 Bug”
进入:
LLM 生成修改
这是最危险的设计之一。
第一件事:确认 Workspace
Agent 必须知道:
本次只允许操作哪个目录。
例如:
/workspaces/task_001/
然后所有文件 Tool 都限制在:
这个 workspace。
不能:
访问 /etc/
访问 ~/.ssh/
访问其他项目
这就是第 27 节建立的:
Workspace Boundary。
第二件事:读取项目规则
Agent 首先寻找:
AGENTS.md
例如:
# AGENTS.md
- Python 3.9
- 不允许修改 tests/
- 使用 pytest
- 修改后必须执行测试
- 不允许新增第三方依赖
这决定后面的:
修复策略
Tool 权限
测试方式
完成条件
所以 Coding Agent 的基本原则应该是,先读项目合同,再进入项目执行。
第三件事:扫描项目
第一版不用复杂 AST。
简单:
list_files
就很有价值。
Agent 先知道:
有哪些目录
有哪些 Python 文件
tests 在哪
配置文件在哪
避免上来猜:
app.py
config.py
requirements.txt
第四件事:尽早复现错误
如果任务说:
pytest 有失败
Agent 应尽早:
run_pytest(args="-q")
而不是先改。
因为真正的 Error Observation 是:
当前任务最有价值的信息。
没有复现,就无法判断后续修改是否真的解决问题。
一个合理的陌生项目启动流程
Workspace Validation
↓
AGENTS.md
↓
Project Tree
↓
Relevant Config
↓
Baseline Test
↓
Root Cause Analysis
这个顺序非常值得固定成:
Coding Agent Skill。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END
















请登录后查看评论内容