nabledge-dev

Nabledge スキルの開発リポジトリです。

ドキュメント

• 📊 開発状況 - 現在の進捗とロードマップ
• 📐 設計ドキュメント - アーキテクチャと設計の詳細
• 🎯 アクティビティマッピング - Nabledge とのワークフローおよび役割分担
• 📈 メトリクス - 週次開発生産性と Nabledge 導入状況（自動更新）

前提条件

• WSL2 / Ubuntu
• CA 証明書（企業プロキシ環境の場合）

セットアップ

1. CA 証明書のインストール（プロキシ環境の場合）

sudo cp /path/to/your/ca.crt /usr/local/share/ca-certificates/ca.crt
sudo update-ca-certificates

2. 環境セットアップ

SVN_BASE_URL=<SVN_URL> SVN_USERNAME=<username> SVN_PASSWORD=<password> ./setup.sh
cp .env.example .env
# .env を編集して認証情報を設定する

SVN_BASE_URL 等には v1.4/v1.3/v1.2 が格納されている SVN リポジトリの URL を指定します。

使い方

source .env
claude

開発

リポジトリ構成

このプロジェクトは 2 つのリポジトリで管理されています。

リポジトリ	役割
nabledge-dev（このリポジトリ）	スキルの開発・改善を行う作業場
nabledge	ユーザーへの配布リポジトリ

nabledge-dev/main へのプッシュをトリガーに、GitHub Actions が nabledge/develop へ変更を自動同期します。

フロー

flowchart LR
    MAIN["nabledge-dev/main"]
    WB["nabledge-dev<br/>ワーキングブランチ"]
    BM["ベンチマーク<br/>（影響ある場合）"]
    GHA["GitHub Actions<br/>（自動同期）"]
    DEV["nabledge/develop"]

    MAIN -->|"ブランチ作成"| WB
    WB -.->|"任意"| BM
    WB -->|"PR マージ"| MAIN
    MAIN -->|"push"| GHA
    GHA -->|"自動同期"| DEV

Loading

コマンド

コマンド	用途
/hi [issue#]	イシューの作成から実装・PR 作成まで一貫実行。引数なしで起動するとイシュー作成から対話で始まる
/fb [PR#]	PR レビューフィードバックへの対応
/bb [PR#]	PR のマージとブランチ削除
/sv [PR#]	セッション状態を保存して中断（tasks.md に進捗を記録）
/re [PR#]	/sv で保存したセッションを再開

手順

スキル改善・不具合対応

1. /hi を実行（イシューがなければ作成から始まる）
   • プロンプト・ワークフロー・ナレッジファイルに影響する変更は、イシュー作成時に「前回ベンチマークから劣化していないことを確認して」と伝えるとベンチマークまで実行される（参考: E2Eベンチマーク実行手順・コード分析ベンチマーク実行手順）
   • 不具合対応は「調査・水平展開・再発防止まで含めてイシューを作成して」と伝えると対応するサクセスクライテリアを含めてくれる
   • ナレッジファイル（.claude/skills/nabledge-*/）は直接編集せず「RBKC を修正して」と伝える。RBKC コードを変更した場合は「5 バージョン全件で create と verify を実行して」と伝えると対応する
2. PR をレビュー（ユーザー作業）
3. フィードバックがあれば /fb <number> で対応
4. /bb <number> で PR をマージ

Nablarch ソース更新

1. Nablarch ソースを更新（ユーザー作業）
   • v5/v6（Git）: ./setup.sh
   • v1.x（SVN）: SVN_BASE_URL=<url> SVN_USERNAME=<user> SVN_PASSWORD=<pass> ./setup.sh
2. /hi でイシューを作成してナレッジファイルの再生成・PR 作成まで実行
3. PR をレビュー（ユーザー作業）
4. フィードバックがあれば /fb <number> で対応
5. /bb <number> で PR をマージ

リリース

フロー

nabledge/develop に自動同期された変更を、nabledge/main へリリースします。

flowchart LR
    DEV["nabledge/develop"]
    TEST["セットアップ検証"]
    RB["nabledge/release/{version}"]
    RELEASE["nabledge/main"]

    DEV --> TEST
    TEST -->|"ブランチ作成"| RB
    RB -->|"PR マージ"| RELEASE

Loading

手順

1. /hi を実行し「リリース準備をして」と伝えるとバージョンファイル・CHANGELOG 更新・PR 作成まで実行する
2. PR をレビュー（ユーザー作業）
3. フィードバックがあれば /fb <number> で対応
4. /bb <number> で PR をマージ（nabledge/develop に自動同期される）
5. nabledge-dev/main で「セットアップ検証を実行して」と伝えると全バージョンのセットアップが PASS / WARN になることを確認する（参考: セットアップ検証）
6. nabledge/develop から release/{version} ブランチを作成（ユーザー作業）
7. nabledge/release/{version} から nabledge/main へ PR を作成・マージ（ユーザー作業、このマージがリリース）
8. リリースタグを追加（ユーザー作業）

フィードバック

• 公開済みのスキルについて: nabledge Issues
• 開発中の作業について: nabledge-dev Issues