PRをマージされる前に2度リジェクトされた話
Awesome Second Brainへのコントリビューションに挑戦しました。 Awesome Second Brainは、AIのメモリおよび知識システムのためのオープンソースのリソースです。 200以上のスターを獲得しており、ルールは非常に厳格です。 私は、Hermes Agent、Obsidian、Honchoという複雑なスタックを提案しました。
2度失敗しました。 プルリクエストをマージしてもらうまでに、3回の修正プロセスが必要でした。 私が犯した間違いと、そこから学んだことを紹介します。
1. ドキュメントではなく記憶に頼ってしまった 存在すると思い込んでいたコマンドを使ってセットアップガイドを書いてしまいました。 設定ファイルが特定のフォルダにあると思い込んでいました。 CLIスクリプトが利用可能だと思い込んでいました。 それは間違いでした。どちらも存在しませんでした。
教訓：コマンドを記憶だけで書かないこと。 公式ドキュメントを開く。 正確なページを見つける。 正確なコマンドをコピーする。 見つからない場合は、含めない。
2. メタデータが不正確だった 会社名を混同していました。 Plastic LabsがObsidianを開発していると思っていましたが、実際は違います。 スタック全体がオープンソースであると主張してしまいましたが、そうではありませんでした。 ObsidianとAgentMailはプロプライエタリです。
教訓：あらゆる詳細を検証すること。 メンテナー、ライセンス、リポジトリのステータスを確認する。 推測しない。
3. 根拠のない広範な主張をしてしまった スタックが「すべてローカル」であると主張しました。 AgentMailはホスト型サービスであるため、これは誤りでした。 「無料」であると主張しました。 ホスト型サービスにはコストがかかるため、これも誤りでした。
教訓：表現を限定すること。 スタックのすべての部分に当てはまらない主張をする場合は、その旨を伝える。 「コンポーネントによって異なる」といったフレーズを使う。 大雑把に言うよりも、正直である方が良い。
4. 最初にガイドラインを読んでいなかった 最初の拒絶を受けてからコントリビューションのルールを読みました。 始める前に読んでおくべきでした。
教訓：ルールは2回読むこと。 ルールは、あなたとメンテナー双方の時間を節約するために存在しています。
最後に リジェクトされるのは辛いものです。 しかし、フィードバックは公平で、具体的かつ実践的なものでした。 最終的なバージョンは、正確で無駄がなく、より優れたものになりました。 あれもこれもと欲張る前に、まずは小さく正しいコントリビューションに集中しましょう。
Optional learning community: https://t.me/GyaanSetuAi