# AI Agent 使用方法文档集

> 面向产品、研发和个人工作流的 Agent 使用指南精选集。
>
> 收集范围：Anthropic/Claude、OpenAI/GPT，以及其他模型与 Agent 工具公司员工或官方发布的原始资料。
>
> 更新时间：2026-08-22

## 这套文档解决什么问题

不是整理“如何写一个更长的 Prompt”，而是回答：

- 什么任务值得交给 Agent，什么任务不值得？
- 如何给 Agent 足够上下文，又不让上下文失控？
- 如何让 Agent 能验证自己的工作，而不是只生成看起来合理的结果？
- 什么时候使用单 Agent、工作流、多个专职 Agent 或人工审批？
- 如何把一次性对话升级成可复用、可审计的工作系统？

## 阅读顺序

1. [综合提炼：Agent 工作方法论](./synthesis/agent-work-methodology.md)
2. [AI 自主开发与自我纠错](./synthesis/ai-self-development-and-correction.md)
3. [AI 项目开发建议](./synthesis/ai-project-development-recommendations.md)
4. [跨公司高质量原始资料总表](./sources/extended-agent-sources.md)
5. [Anthropic：Building Effective Agents](./sources/anthropic-building-effective-agents.md)
6. [Claude Code：Best Practices](./sources/anthropic-claude-code-best-practices.md)
7. [OpenAI：A Practical Guide to Building Agents](./sources/openai-practical-guide.md)
8. [OpenAI：Agents SDK 文档](./sources/openai-agents-sdk.md)
9. 其他公司资料与链接（Google、Microsoft、Cursor、Windsurf/Devin）见 `extended-agent-sources.md`

## 资料筛选标准

- 优先原始来源：官方工程博客、开发者文档、官方 Cookbook、员工署名文章。
- 每条资料标注来源类型：官方规范、工程经验、产品文档或案例。
- 不把厂商宣传数字直接当作普遍结论。
- 只做摘要和方法提炼，不大段复制原文；需要完整细节时请打开原始链接。

## 目录

- `sources/`：按来源整理的资料卡片
- `synthesis/`：跨来源归纳后的方法论、检查清单和模板
