用途:在项目根目录创建或更新 GOAL.md,让未来的智能体与维护者理解项目要达成什么,以及有意不做什么。
主要能力:先确定项目根目录,优先使用 git 仓库根;若无 git 仓库则用当前工作目录。检查 README.md、GOAL.md、CONTRIBUTING.md、文档索引、包清单、配置文件与示例,并查看源码结构、测试、CLI 或应用入口、公共 API、构建与安装脚本,以及 issue、路线图、变更日志或规划文件。随后形成关于项目目的、主要用户、核心能力、成功信号、约束原则、显式非目标与未知项的简明工作假设。
使用方式:只询问会对最终 GOAL.md 产生实质影响的问题。存在 Ask User 工具时使用它,否则直接在聊天中提问。默认一次问一个问题,通常总问题数不超过 3 至 5 个;可从仓库推断时优先用确认式提问。文档足够准确后即停止提问,避免变成访谈。写入或更新 <project-root>/GOAL.md;若已存在,保留准确有用的内容并就地修订。用户回答与仓库证据冲突时以用户为准,并在最终回复中说明冲突。用户无法回答时,写出证据支持的最佳目标,并在文档中标记未解决的不确定性。最后报告写入路径并总结重要假设或未决项。
GOAL.md 内容:建议包含 North Star、Who This Is For、Core Goals、Success Looks Like、Non-Goals、Principles and Constraints、Current Focus、Open Questions 等章节,并按项目调整标题,保持实用。必须包含简短北极星陈述、目标受众、具体成果、核心目标列表、非目标、成功标准或可观察进展信号、重要约束与取舍,以及确实未解决时的开放问题。
适用场景:需要为项目建立或澄清持久目标、统一维护者与智能体理解、指导优先级和 issue 分类时。
限制:不应写私密思维链、详尽发现笔记或用户问答记录;不要为扩大项目范围而编造受众或用例;避免过度贴合实现细节。具体支持的项目类型、命令与平台要求暂未提供。