English · v0.1.0 Public Preview
CodeGrove 是一个帮助开发者理解陌生代码库、完成安全且经过验证的首次贡献，并为后续开发积累可信项目知识的 Agent Skill。
从陌生代码库走到第一次经过验证的真实贡献。
- **理解项目：**找到真实入口、模块、关键流程和验证命令，不把猜测当成事实。
- **完成经过验证的贡献：**选择正确的首次任务，控制修改范围并验证结果。
- **记住真正重要的知识：**沉淀有长期价值的项目知识，让后续开发从证据开始，而不是重新摸索。
flowchart LR
A[陌生代码库] --> B[只读探索]
B --> C[建立证据地图]
C --> D[提出最小首次任务]
D --> E{是否获得修改授权?}
E -- 否 --> F[输出经过验证的行动计划]
E -- 是 --> G[执行最小范围修改]
G --> H[运行项目验证]
H --> I{验证是否通过?}
I -- 否 --> J[报告失败与剩余未知]
I -- 是 --> K[完成经过验证的贡献]
K --> L{是否授权沉淀知识?}
L -- 否 --> M[结束且不创建外部记录]
L -- 是 --> N[保存可信项目知识]
CodeGrove 始终区分已验证事实、合理推断、冲突和未知信息。分析结果本身不会授予文件修改、记录写入或外部操作权限。
使用 $codegrove 帮我理解这个陌生项目，并完成一次安全且经过验证的首次贡献。
先只读分析，不要修改文件或创建记录。请区分已验证事实、合理推断、冲突和未知信息。
30～60 秒演示不需要选择最大、最知名的项目。更合适的是一个入口清楚、具备测试、并且存在小范围改进空间的中小型公开仓库。
建议依次展示：
- 从一个真正陌生的仓库开始。
- 要求 CodeGrove 先只读分析。
- 展示它识别出的项目入口和模块地图。
- 展示一个首次贡献建议及其证据。
- 以验证命令或明确报告的未知信息结束。
演示目标不是让 Agent 看起来无所不能，而是让观众看清它的证据、边界和下一步行动。
- 下载本仓库。
- 把内层
codegrove/目录复制到 Agent Skills 兼容客户端的 Skill 目录，并重新加载 Skills。
可安装 Skill 的入口是 codegrove/SKILL.md。
Project Grove 是可选的外部项目知识库。它把可信项目知识保存在 Skill 之外，并且只有获得你的授权才会写入。
- 分析、熟悉程度和置信度都不能授予修改、记录写入或外部操作权限。
- 生产证据访问必须最小且只读；生产写操作永久不在能力范围内。
- 不得在记录或公开反馈中保存凭据、私有源代码、生产数据或个人信息。
如果 CodeGrove 帮你更快理解了陌生项目，或让你得到一个经过验证的下一步：
- Star 本仓库，关注后续版本。
- 分享一次真实的项目验证。
- 提交失败案例或未经支持的推断。
- 贡献一个经过脱敏的项目场景。
对一个刚开始维护的开源项目来说，真实失败比一个空洞的数字更有价值。它能帮助 CodeGrove 从一套有潜力的流程，逐步成为值得依赖的开源工具。