groove-groovebook-publish

groove-groovebook-publish

$ARGUMENTS が指定されている場合は、学習内容として使用します。

成果

現在のプロジェクトで得た学びを、プロジェクト固有の情報を取り除いたうえで、設定済みの groovebook リポジトリにプルリクエストとして公開し、コミュニティレビューに備えます。

受け入れ条件

• 学びが <groovebook> リポジトリへの PR として公開されている
• PR が groovebook の PR テンプレート形式（Summary、Context、Learning、Groove skill area）を使用している
• ファイルが groovebook リポジトリの learned/<topic>/<YYYY-MM-DD>-<slug>.md に書き込まれている
• PR の URL がユーザーに表示される

手順

1. .groove/index.md から groovebook: を読み取ります。記載がない場合は、次のメッセージを表示して終了します。 groovebook is not configured. Add 'groovebook: <owner>/<repo>' to .groove/index.md to enable.

2. gh auth status を確認します。認証されていない場合は、次のメッセージを表示して終了します。 Not authenticated with GitHub. Run: gh auth login

3. groovebook リポジトリにアクセスできることを確認します。gh repo view <groovebook> が失敗した場合は、明確なメッセージを表示して終了します。

4. 学習内容を取得します。

   • $ARGUMENTS が指定されている場合は、出発点として使用します
   • それ以外の場合は、「公開したい学びは何ですか？（貼り付けるか、簡単に説明してください）」と尋ねます
   • PR のタイトルとファイル名のスラッグに使用する、一文の要約を尋ねます

5. 学習内容のプレビューを表示し、次のように尋ねます。 これに削除すべきリポジトリ固有の情報（ファイルパス、内部名、製品名など）は含まれていますか？

   • はいの場合：ユーザーが情報を伏せるのを手伝い、具体的な名前を一般的な説明に置き換えます
   • いいえの場合：続行します

6. トピック（例：patterns、tools、anti-patterns、workflow）とスキル領域（例：compound、plan、review、daily）を尋ねます。

7. スラッグを生成します。要約を小文字にし、スペースをハイフンに置き換え、特殊文字を削除し、40 文字に切り詰めます。次のように設定します。

   • ブランチ名：learning/<YYYY-MM-DD>-<slug>
   • ファイルパス：learned/<topic>/<YYYY-MM-DD>-<slug>.md

8. groovebook リポジトリをまだフォークしていない場合は、フォークします。gh repo fork <groovebook> --clone=false

   • フォークがすでに存在する場合は、何も表示せずにスキップします

9. ブランチとファイルを作成します。

   • gh api repos/<user-fork>/git/refs でブランチの存在を確認します。すでに存在する場合は、短い一意のサフィックスを追加します
   • ファイルの内容（下記の形式を参照）を書き込み、gh api でコミットします
   • または、gh api を使う方法が複雑すぎる場合は、フォークの URL を使って git 操作を行います。より簡単な方法を優先してください

10. PR を作成します。

    gh pr create --repo <groovebook> \
      --title "<one-sentence summary>" \
      --body "<formatted body>" \
      --head "<fork-user>:<branch-name>"
    

11. PR の URL を表示します。

学習ファイルの形式

---
date: YYYY-MM-DD
topic: <topic>
skill-area: <skill-area>
source: groovebook-publish
---

# <One-sentence summary>

## Context

<What triggered this learning — what problem were you solving? Generic, no project specifics.>

## Learning

<The insight itself — what to do, what to avoid, or what pattern works.>

## Groove skill area

`<skill-area>` (e.g. `groove-work-compound`, `groove-work-plan`)

PR 本文の形式

## Summary
<one-sentence summary>

## Context
<what triggered this>

## Learning
<the insight>

## Groove skill area
`<skill-area>`

---
*Published via groove-groovebook-publish*

制約事項

• ユーザーが意図的な公開であることを明示的に確認しない限り、プロジェクト固有の名前、ファイルパス、内部識別子を含む学習内容を公開してはいけません
• 権限が原因でフォークに失敗した場合は、手動でフォークし、フォーク先を groovebook: の値に設定するよう提案します
• スラッグはファイル名として安全でなければなりません。小文字とハイフンのみを使用し、パス区切り文字や特殊文字は含めないでください
• ブランチがすでに存在する場合は、空きが見つかるまで -2、-3 などを追加します