SuperAPI AI 工具集

project-goal

写作与研究

查看项目

更新于 10-16 08:45

技能介绍

用途:在项目根目录创建或更新 GOAL.md,说明项目要实现什么、为谁服务,以及刻意不做什么,供后续智能体与维护者阅读。

主要能力:先确定项目根目录(优先 git 仓库根,否则用当前工作目录);检查 README.md、GOAL.md、CONTRIBUTING.md、文档索引、包清单、配置、示例、源码布局、测试、入口点、公共 API、构建与安装脚本、issue、路线图、changelog 等;形成关于目的、受众、核心能力、成功信号、约束、非目标和未知点的初步判断,再向用户提问。

使用方式:只问对最终文档有实质影响的问题;有 Ask User 工具则使用,否则直接在对话中提问;默认一次一个问题,通常不超过 3–5 个;能推断时优先用确认式提问,只有真实缺口、冲突或价值取舍才用开放问题。随后写入 <project-root>/GOAL.md,若已存在则在保留准确内容的基础上修订。用户答复与仓库证据冲突时以用户为准,并在回复中说明冲突。

文档结构:默认含 Project Goal、North Star、Who This Is For、Core Goals、Success Looks Like、Non-Goals、Principles and Constraints、Current Focus、Open Questions,可按项目调整。必须包含简短北极星、明确的受众(只有一个清晰受众就只写它)、具体成果、按优先级分组的核心目标、非目标、成功标准,以及重要约束与范围边界;仅当发现后仍未解决才保留开放问题。

适用场景:为已有或新项目建立长期意图文档,帮助分诊与优先级判断。限制:不编造受众或用例,不写实现细节或短期任务清单,不保存私密思维链或提问记录;最终需报告写入路径并总结关键假设或未决事项。