小节一:项目入口怎么设计——Coding Agent 进入陌生项目以后,第一件事不是改代码

这一节最容易踩的坑,就是一看到任务就立刻改代码。其实更稳的做法,是先确认工作区边界、扫描项目结构、读取 AGENTS.md,再识别规则和测试入口。这样做的意义很直接:先知道什么能动、什么不能动、测试怎么跑,后面每一步才不会越界。

图片[1]-小节一:项目入口怎么设计——Coding Agent 进入陌生项目以后,第一件事不是改代码-大赛人网

一个常见实现会直接从:

“请修这个 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
喜欢就支持一下吧
点赞5 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容