高效 AI 协作指南
·
刚接手了一个新项目
请先不要修改任何代码。
你现在只需要阅读项目结构,并告诉我:
- 这个项目是做什么的
- 使用了哪些技术栈
- 入口文件在哪里
- 启动和构建命令是什么
- 如果我要新增一个页面,应该从哪里开始
你刚才对项目的理解里,有哪些地方是不确定的?
请列出来,并说明你还需要查看哪些文件。
刚接手了一个新需求
请按照以下步骤为项目创建一个新的借出还回周期监控模块:
1. 首先分析当前项目代码风格和组件库规范,参考现有历史代码的实现模式。
2. 然后仔细阅读 demo.html 执行监控菜单下的库存滞销监控模块的 UI 设计和功能要求(原型为 .html 文件)。
3. 基于 demo 设计创建新的模块,文件路径为 inventory-slow-moving-monitoring(手动创建好文件夹)。
4. 模块应包含完整的列表页面,包括统计卡片、筛选栏、数据表格和分页功能。
5. 暂时使用 mock 数据实现,待后续提供接口文档后再进行后端联调。文档.md 是接口文档,根据接口文档联调一下。
请确保代码风格与现有项目保持一致,使用相同的组件库规范和数据处理模式。
五大模板
1. 读项目模板
请先阅读当前项目,不要修改任何代码。帮我总结:
- 项目是做什么的
- 技术栈是什么
- 目录结构如何组织
- 启动、构建、测试命令是什么
- 新增一个页面应该从哪里开始
- 当前项目有哪些明显维护风险
2. 修 bug 模板
我遇到了一个 bug:XXX。请先阅读相关代码,不要修改。输出:
- 可能原因
- 涉及文件
- 你需要进一步确认的信息
- 修复计划
3. 执行修改模板
请按刚才确认的计划修改代码。要求:
- 修改范围只限于 XXX
- 不要引入新依赖
- 不要重构无关代码
- 完成后运行相关测试
- 最后总结修改内容和风险
4. Review 模板
请 review 当前 git diff。重点关注:
- 是否破坏现有功能
- 是否有边界情况遗漏
- 是否有错误处理缺失
- 是否有类型问题
- 是否有安全风险
- 是否需要补测试
只输出问题,不要修改代码。
5. 任务收尾模板
请总结这个任务。包括:
- 目标是什么
- 最终改了什么
- 已验证什么
- 还有什么风险
- 后续继续做应该从哪里开始
总结:
- 先读。
- 再计划。
- 再执行。
- 再验证。
- 再总结。
AI 不是神。它是一个非常强的工具。
但越是这种工具,越需要你会用。
新手最容易犯的错误,就是给一个模糊任务,然后期待它一次性做完。除非有参考的已经做好的文件让他参考着做。
- 把常用规则写进
AGENTS.md。 - 把重复标准做成 skills。
- 把外部工具通过 plugins 和 MCP 接进来。
- 把重复巡检交给自动化模块。
- 复杂任务再拆给多个 agent 并行做。
然后自己负责方向、判断和验收。
更多推荐



所有评论(0)