我在合并 PR 之前是如何被拒绝两次的

我尝试为 Awesome Second Brain 做贡献。 Awesome Second Brain 是一个关于 AI 记忆和知识系统的开源资源。 它拥有超过 200 个 star，且规则非常严格。 我提交了一个复杂的工具栈：Hermes Agent、Obsidian 和 Honcho。

我失败了两次。 我经过了三轮修改才让我的 pull request 被合并。 以下是我做错的地方以及我学到的教训。

1. 我依赖记忆而非文档 我写了一份安装指南，使用的命令是我“以为”存在的。 我假设配置文件位于某个特定文件夹中。 我假设可以使用某个 CLI 脚本。 我错了，两者都不存在。

教训：永远不要凭记忆写命令。 打开官方文档。 找到准确的页面。 复制准确的命令。 如果找不到，就不要把它写进去。

2. 我的元数据不准确 我搞混了公司名称。 我以为 Obsidian 是 Plastic Labs 开发的，其实不是。 我声称整个工具栈都是开源的，但事实并非如此。 Obsidian 和 AgentMail 是专有软件。

教训：核实每一个细节。 检查维护者、许可证以及仓库状态。 不要靠猜。

3. 我在没有证据的情况下做出了笼统的断言 我声称该工具栈是“全本地化”的。 这是错误的，因为 AgentMail 是托管服务。 我声称它是“免费”的。 这也是错误的，因为托管服务是有成本的。

教训：对你的陈述进行限定。 如果某个断言并不适用于工具栈的所有部分，请明确说明。 使用诸如“因组件而异”之类的短语。 诚实比笼统更重要。

4. 我没有先阅读指南 我在第一次被拒绝后才阅读了贡献规则。 我应该在开始之前就阅读它们。

教训：把规则读两遍。 它们的存在是为了节省你和维护者的时间。

结语 被拒绝的感觉很不好受。 但反馈是公正且具有可操作性的。 最终版本更好，因为它准确且精炼。 在尝试做太多事情之前，先专注于做出微小且正确的贡献。

来源：https://dev.to/saintchris_21/how-i-contributed-to-awesome-second-brain-and-what-i-learned-from-getting-rejected-32p4

可选学习社区：https://t.me/GyaanSetuAi