Ticket Knowledge Logger

ユーザーから以下の情報を受け取る:

• カテゴリ: 調査 / 実装 / その他
• チケット番号: BAX-XXXX 形式

2. JIRAからチケット名を取得

チケット番号からJIRAのチケットページにアクセスし、チケット名（Summary）を取得する。

• URL: https://kokopelli-inc.atlassian.net/browse/{チケット番号}
• WebFetchツールでページにアクセスし、チケットのタイトル（Summary）を抽出する
• 取得したチケット名はディレクトリ名に使用する（例: BAX-10325_年払い対応）
• チケット名に含まれるファイルシステムで使えない文字（/, \, :, *, ?, ", <, >, |）はアンダースコア _ に置換する
• JIRAにアクセスできない場合は、ユーザーにチケット名を直接聞く

3. ディレクトリ作成

mkdir -p /Users/takano_y/ghq/github.com/kokopelli-inc/badev-knowledge-base/docs/takano/{カテゴリ}/{チケット番号}_{チケット名}

4. LOG.md 作成

会話ログファイルを作成:

重要: 日時は必ず YYYY-MM-DD HH:MM 形式で、時刻（HH:MM）を省略せずに記録すること。現在時刻は date "+%Y-%m-%d %H:%M" コマンドで取得できる。

# {チケット番号} 会話ログ

## 基本情報

- **チケット**: {チケット番号}
- **カテゴリ**: {カテゴリ}
- **作成日時**: {YYYY-MM-DD HH:MM}  ← 例: 2026-02-05 14:30

---

## 会話ログ

### {YYYY-MM-DD HH:MM} - セッション1  ← 例: 2026-02-05 14:30 - セッション1

#### 質問/タスク
{ユーザーからの質問やタスクの内容}

#### 調査/作業内容
{調査した内容、読んだファイル、実行したコマンドなど}

#### 結果/発見
{発見した事項、結論、解決策など}

---

### {YYYY-MM-DD HH:MM} - セッション2  ← 例: 2026-02-05 15:45 - セッション2
...

5. README.md 作成

まとめファイルを作成:

# {チケット番号}

## 概要

{チケットの目的・背景を1-2文で}

## 結論/解決策

{最終的な結論、解決策、または実装内容}

## 関連ファイル

- `path/to/file.php:123` - {説明}

## 参考情報

- {参考にしたドキュメント、URL}
- {関連するチケット番号}

## プラン

計画書は [PLAN.md](./PLAN.md) を参照。

## ログ

詳細は [LOG.md](./LOG.md) を参照。

6. PLAN.md 作成（プランモード使用時）

プランモード（EnterPlanMode）でタスクの計画を立てた場合、その計画書を PLAN.md として保存する。

タイミング: プランモードで計画を策定した直後、または記録時にプランモードの出力が会話に存在する場合。

# {チケット番号} プラン計画書

## 基本情報

- **チケット**: {チケット番号}
- **作成日時**: {YYYY-MM-DD HH:MM}
- **最終更新**: {YYYY-MM-DD HH:MM}

---

## 目的・ゴール

{チケットで達成すべきことを明確に記述}

## 現状分析

{現在のコードの状態、問題点の整理}

## 実装方針

{どのようなアプローチで解決するかの方針}

## タスク分解

- [ ] タスク1: {内容}
- [ ] タスク2: {内容}
- [ ] タスク3: {内容}

## 影響範囲

- {変更が影響するファイル・機能の一覧}

## リスク・懸念事項

- {想定されるリスクや注意点}

## 備考

{その他の補足情報}

更新ルール:

• プランモードで計画を再策定した場合は、PLAN.mdを上書き更新する（最新の計画のみ保持）
• タスク分解のチェックボックスは、実装完了時に手動またはログ記録時に更新可能
• README.mdの「関連ファイル」セクションに PLAN.md へのリンクを追加する

7. JIRAチケットにコメント投稿

ログやREADMEを作成・更新した際、JIRAチケットにもナレッジコメントを投稿する。

ツール

mcp__plugin_atlassian_atlassian__addCommentToJiraIssue を使用する。

パラメータ

• cloudId: kokopelli-inc.atlassian.net
• issueIdOrKey: {チケット番号}（例: BAX-10325）
• commentBody: 下記フォーマットのMarkdown文字列

GitHubリンクの確認

コメント投稿前に、LOG.mdとREADME.mdがリモートにプッシュ済みかを確認する。

確認方法:

cd /Users/takano_y/ghq/github.com/kokopelli-inc/badev-knowledge-base && \
git log --oneline origin/main -- "docs/takano/{カテゴリ}/{チケット番号}_{チケット名}/LOG.md" | head -1 && \
git log --oneline origin/main -- "docs/takano/{カテゴリ}/{チケット番号}_{チケット名}/README.md" | head -1

• 出力があればリモートにプッシュ済み → GitHubリンクをコメントに追加
• 出力が空ならまだプッシュされていない → ローカルパスのみ記載

GitHubリンクのURL形式: