btw

/btw - By-The-Way 提案コレクター

作業中に「これをスキルにするとよさそう」「このパターンを自動化するとよさそう」といった 改善提案をすぐに記録し、管理するツールです。

Commands

/btw {suggestion} - 提案を記録する

1. .bkit/btw-suggestions.json を読み込みます（存在しない場合は作成します）
2. 次の ID を生成します：btw-NNN（ゼロ埋めの連番）
3. 提案エントリを作成します：

   {
     "id": "btw-001",
     "timestamp": "ISO-8601",
     "suggestion": "{user input}",
     "context": {
       "file": "{current working file if identifiable}",
       "pdcaPhase": "{current PDCA phase from getPdcaStatusView() or null}",
       "feature": "{current feature or null}"
     },
     "category": "auto-detect",
     "status": "pending",
     "promotedTo": null,
     "priority": null,
     "teamContext": {
       "isTeamSession": false,
       "phase": "{PDCA phase or null}",
       "role": "{teammate role that discovered this, or 'user'}",
       "pattern": "{orchestration pattern or null}"
     }
   }
   

4. 提案テキストからカテゴリを自動検出します：
   • skill-request：”skill”、”스킬”、”자동화”、”automate” を含む
   • bug-pattern：”bug”、”버그”、”오류”、”error”、”fix” を含む
   • improvement：”개선”、”improve”、”better”、”refactor” を含む
   • documentation：”문서”、”doc”、”설명”、”explain” を含む
   • general：デフォルト
5. stats.total の件数を更新します
6. 「btw-{NNN} を記録しました：{短縮した提案}。すべて表示するには /btw list を使用してください。」と応答します

/btw list - すべての提案を一覧表示する

1. .bkit/btw-suggestions.json を読み込みます
2. テーブルを表示します：

   ID       | Status   | Category       | Suggestion (truncated)
   ---------|----------|----------------|----------------------
   btw-001  | pending  | skill-request  | @Flow 모델에서 옵션 목록을 자동...
   btw-002  | promoted | improvement    | DataProxy 패턴에 검증 로직을...
   

3. 概要を表示します：合計：N | 保留中：N | 昇格済み：N | 却下済み：N

/btw analyze - スキル候補となる提案を分析する

1. .bkit/btw-suggestions.json から保留中の提案をすべて読み込みます
2. カテゴリごとにグループ化し、パターンを見つけます：
   • 類似する提案をまとめます（キーワードの重複）
   • 類似トピックの頻度を数えます
   • 既存の bkit スキルに対応する提案と、新しいスキルが必要な提案を特定します
3. スキル候補ごとに、次の処理を行います：
   • スキルの分類（ワークフローまたは機能）を見積もります
   • スキル名と説明を提案します
   • 元となる提案 ID を参照します
4. 分析結果を出力します：

   Skill Candidates from /btw Analysis
   =====================================
   
   1. [NEW SKILL] hunikflow-validation (capability)
      Based on: btw-001, btw-005, btw-008
      Frequency: 3 mentions
      Description: Validation pattern guide for @Flow entities
   
   2. [EXISTING SKILL ENHANCEMENT] code-review
      Based on: btw-003
      Suggestion: Add DataProxy-specific review rules
   

5. 分析のタイムスタンプを stats.lastAnalyzed に保存します

/btw promote {id} - 提案をスキル作成に昇格する

1. .bkit/btw-suggestions.json から ID で提案を検索します
2. ステータスが「pending」であることを確認します（すでに昇格済みまたは却下済みの提案は昇格できません）
3. 提案を更新します：
   • status：「promoted」
   • promotedTo：スキル名（提案から導出）
4. 提案のコンテキストを使用して、スキル作成ワークフローを開始します：
   • 提案テキストをスキル説明の元データとして渡します
   • コンテキスト（ファイル、機能）をプロジェクトのコンテキストとして渡します
5. 「btw-{id} を昇格し、skill-create パイプラインに渡しました。続行するには /skill-create を実行してください。」と応答します

/btw stats - 統計情報を表示する

1. .bkit/btw-suggestions.json を読み込みます
2. 次の項目を集計して表示します：

   /btw Statistics
   ===============
   Total suggestions: 12
   By status: pending=8, promoted=3, dismissed=1
   By category: skill-request=5, improvement=4, bug-pattern=2, general=1
   Promotion rate: 25.0%
   Last analyzed: 2026-03-13T10:00:00Z
   Top keywords: @Flow(3), DataProxy(2), validation(2)
   

データファイル：.bkit/btw-suggestions.json

ファイルが存在しない場合は、次の構造で初期化します：

{
  "version": "1.0",
  "suggestions": [],
  "stats": {
    "total": 0,
    "promoted": 0,
    "dismissed": 0,
    "lastAnalyzed": null
  }
}

カテゴリの自動検出ルール

パターン	カテゴリ
skill, 스킬, automate, 자동화, command, 명령	skill-request
bug, 버그, error, 오류, fix, 수정	bug-pattern
improve, 개선, better, refactor, 리팩토링, optimize	improvement
doc, 문서, explain, 설명, readme, guide	documentation
(default)	general

統合ポイント

• PDCA コンテキスト：getPdcaStatusView() （lib/pdca/status.js）を通じてフェーズと機能を読み取ります。これは、ドキュメントによってのみ証拠が示されるフェーズを対象とします。 .bkit/state/memory.json（移行前の .bkit-memory.json）には、9 フェーズのパイプラインのステータスが格納されますが、PDCA フェーズは格納されません。
• skill-create：/btw promote は skill-create ワークフローを開始します
• skill-needs-extractor：/btw analyze の結果はギャップ分析に使用されます
• CTO Team：フェーズ遷移時に btw の概要が表示されます（以下を参照）

CTO Team との統合

CTO Team セッション（/pdca team）中に /btw を使用した場合：

自動検出

• .bkit/runtime/agent-state.json でチームセッションがアクティブかどうかを確認します
• アクティブな場合：teamContext.isTeamSession = true を設定し、フェーズ、ロール、パターンを入力します
• アクティブでない場合：teamContext.isTeamSession = false を設定します（デフォルトの動作）

フェーズ遷移フック

CTO Lead はフェーズ遷移のたびに btw-suggestions.json を自動的に読み取ります：

• 保留中の提案が 0 件：出力せずにスキップします（出力なし、ターン消費なし）
• 保留中の提案が 1 件以上：簡潔な概要（上位 3 件、カテゴリ別の件数）を 1～2 ターンで表示します
• CTO が自動的に昇格することはありません。ユーザーが /btw promote {id} で決定します

セッション終了時

cto-stop.js フックはセッション終了時に btw の統計情報を出力します：

• セッション中に収集された提案の合計数
• カテゴリ別の内訳
• 昇格率

teamContext フィールド

チームセッション中に記録された各提案エントリーに追加されます：

"teamContext": {
  "isTeamSession": true,
  "phase": "do",
  "role": "user",
  "pattern": "swarm"
}

これにより、/btw analyze は PDCA フェーズごとに提案をグループ化し、フェーズ固有のパターンを特定できます。