Agent Compass

为项目建立一份 Agent 可以真正遵循的导航地图。针对不同项目个性化、规范化你的 Agent 。

Agent Compass 是一个 Skill，用来在项目启动或重组时，根据项目需求，帮你寻找合适的工具（Skill/MCP），建立专属于该项目的 Agent 工具链，明确 Agent 的正常工作和调用工具时的原则，帮你把“项目规则、工具分工、使用边界、输出位置、验证标准”等关键信息整理成未来 Agent 能稳定读取和执行的工作契约。

它尤其适合这样的时刻：项目刚开始、工具很多、资料很散、团队规则还没成形，或者你希望后续 Agent 不再反复问同样的问题、不再混用 Skill、不再凭感觉改动项目。

它解决什么问题

在特定的项目中，有时候 Agent 不是缺乏能力，而是缺少合适的工具。同时，Agent 还缺少一份清楚的“项目导航规则”。没有这层规则时，Agent 容易遇到这些问题：

• 不知道哪些文档、代码、数据或讨论才是权威来源。
• 多个 Skill/MCP/tool 职责重叠，导致工作流混乱。
• 不清楚什么能改、什么不能改、什么时候必须先问用户。
• 输出文件散落在项目根目录，后续很难追踪。
• 后来的 Agent 没读到前人总结，又从零开始猜项目背景。

Agent Compass 的目标，就是在项目早期把这些边界一次性立好。

适合哪些项目

Agent Compass 适用于任何需要长期协作、工具编排或上下文沉淀的项目，例如：

• 软件仓库：Web app、CLI、后端服务、前端原型、库和工具包。
• 数据项目：数据分析、指标体系、实验记录、数据处理流水线。
• 研究项目：论文、毕业设计、文献综述、实验复现、学术图表。
• 内容项目：课程材料、知识库、报告、写作项目、团队文档。
• 产品项目：PRD、原型、用户研究、运营自动化、跨角色协作。

它会产出什么

使用本 Skill 后，Agent 通常会帮助你生成或更新这些内容：

• AGENTS.md 入口规则：让后续 Agent 知道进入项目后先读哪里。
• Agent master guideline：项目身份、核心事实、禁止事项、工作原则和验证标准。
• 项目级 Skill/MCP/tool policy：定义每个工具在本项目中负责什么、不负责什么、何时停下来问用户。
• 稳定输出目录：例如 docs/agent_guidelines/、docs/agent_policies/、docs/project_context/、docs/project_checks/。
• 针对特殊项目的附加边界：例如研究项目中的引用、CNKI、Zotero、私有数据、下载和版权规则。

快速使用

可以直接调用：

 $agent-compass 理解本项目的特点，明确本项目的需求（必要时可询问我）。为这个项目建立 Agent guideline、工具 policy 和 AGENTS.md 入口规则。

也可以直接描述你的目标：

请帮我为这个软件仓库初始化 Agent 工作规则，明确哪些工具负责开发、测试、文档和发布，并写入 AGENTS.md。

请为这个数据分析项目制定 Skill/MCP 分工，说明哪些数据源可信、输出保存到哪里、完成前需要哪些验证。

请为这个论文项目建立 Agent 使用约束，明确文献工具、写作 Skill、引用证据和导师反馈的优先级。

推荐工作流

1. 让 Agent Compass 先读取项目现状：仓库结构、已有文档、配置、脚本、旧 AGENTS.md。
2. 回答少量高影响问题：项目目标、权威资料、可用工具、禁止事项、验收标准。
3. 让它盘点已有 Skill/MCP/tool，而不是一上来安装新工具。
4. 如果已有 Skill/MCP/tool 还不能满足项目需求，考虑安装新工具。
5. 为重要工具写项目级 policy，避免多个工具互相抢主责。
6. 写入简洁的 Agent master guideline 和根目录 AGENTS.md 入口。
7. 后续任务让 Agent 先读这些规则，再执行具体开发、研究、写作或数据处理。

为什么叫 Agent Compass

因为它不是替你完成某一个具体任务的“锤子”，而是给整个项目定方向的“罗盘”。

它帮助 Agent 回答三个最关键的问题：

• 我现在在哪个项目里？
• 我应该相信哪些信息、使用哪些工具？
• 我完成工作前必须留下什么证据？

方向清楚之后，后续每个 Agent 才能更快、更稳、更少返工。

文件结构

Agent-Compass/
├── SKILL.md              # Skill 主入口，包含触发描述和核心英文流程
├── agents/openai.yaml    # Codex UI metadata
└── references/zh-CN.md   # 中文复刻版说明

进一步阅读

• 想了解 Skill 的正式执行规则：阅读 SKILL.md。
• 想用中文完整理解流程：阅读 references/zh-CN.md。
• 想直接在项目中使用：在对话里调用 $agent-compass，并告诉它你的项目目标和当前材料。