附录 A：实用速查表
最小 AGENTS.md 模板
---
# Project Stack
stack: Python 3.11, FastAPI, PostgreSQL, Redis
# Core Conventions
conventions:
- Use type hints everywhere
- Follow PEP 8 style guide
- Prefer composition over inheritance
# Hard Rules
hard_rules:
- Never commit secrets or API keys
- Always use async for database operations
- Require tests for all new endpoints
# Workflow
workflow:
- Run tests before commit
- Use conventional commits format
- PR reviews required for production code
---光谱模型五维度速查
| 维度 | Vibe Coding | Agentic Engineering |
|---|---|---|
| 意图说明 | 随意自然语言 prompt | 正式规范、架构文档、memory 文件 |
| 验证 | “看起来能工作？” | 自动化测试套件、CI/CD 门禁、LLM 评委 |
| 代码库理解 | 最小 | 全面审查架构 |
| 错误处理 | 复制粘贴错误信息回 AI | Agent 自我诊断（定义范围内） |
| 适用范围 | 原型、脚本、个人项目 | 生产系统、团队规模开发 |
Harness 六层组成速查
| 组成 | 说明 | 关键文件/工具 |
|---|---|---|
| Instructions and Rule Files | 定义 Agent 身份和行为 | AGENTS.md、CLAUDE.md、GEMINI.md |
| Tools | Agent 可调用的 API 和服务 | MCP 服务器、函数定义 |
| Sandboxes | Agent 代码运行环境 | Docker、隔离执行环境 |
| Orchestration Logic | Sub-agent 生成、模型路由 | Workflow 定义、路由规则 |
| Guardrails / Hooks | 特定生命周期点的确定性代码 | Pre-commit hooks、工具调用前验证 |
| Observability | Logs、traces、评估 | 监控系统、评估套件 |
Conductor vs Orchestrator 速查
| 特征 | Conductor | Orchestrator |
|---|---|---|
| 工作模式 | 实时、手把手指导 | 异步、多 Agent 委托 |
| AI 角色 | 强大乐器，开发者指导每个移动 | 异步工作，定期检查和路线纠正 |
| 适用场景 | 复杂逻辑、调试棘手问题、不熟悉代码库 | 明确定义任务：bug 修复、特征实现、迁移 |
| 支持工具 | GitHub Copilot、Cursor、Windsurf | Google Jules、Claude Code、Cursor background agents |
| 需要技能 | 传统工程技能（syntax、idioms） | Specification、Decomposition、Evaluation、System design |
Coding Agents 三层次速查
| 层次 | 特征 | 工具示例 | 适用工作类型 |
|---|---|---|---|
| In the Editor | Inline completion、chat panels | GitHub Copilot、Cursor | 编写代码时需要建议、快速编辑、解释 |
| In the Terminal | 命令行启动、全文件系统访问 | Claude Code、Codex CLI | 多文件工作、探索不熟悉代码库 |
| In the Background | Cloud-hosted sandboxes、异步运行 | Google Jules、Copilot agent mode | 明确定义任务、可离开 |