From b1cfedcaaf7a25926cfc8e413e16c854c533196d Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:21:19 +0900 Subject: [PATCH 01/18] =?UTF-8?q?chore:=20start=20session=20=E2=80=94=20is?= =?UTF-8?q?sue-414?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .rn/20260803-issue-414/steering.md | 93 ++++++++++++++++++++++++++++++ 1 file changed, 93 insertions(+) create mode 100644 .rn/20260803-issue-414/steering.md diff --git a/.rn/20260803-issue-414/steering.md b/.rn/20260803-issue-414/steering.md new file mode 100644 index 000000000..0064af81f --- /dev/null +++ b/.rn/20260803-issue-414/steering.md @@ -0,0 +1,93 @@ +Rn version: 0.8.0 + +# Goal + +README に開発ワークフロー全体（スキル改善・バグ修正・Nablarch ソース更新・ベンチマーク実行・リリース前セットアップ検証）を追加し、開発者がどの作業を始める場合でもリポジトリ外を探さずに開始できるようにする。 + +# Acceptance criteria + +- [ ] README の「開発」セクションに「スキルの改善・バグ修正」エントリがあり、`/hi` コマンドの使い方・RBKC による知識ファイル再生成手順（`bash tools/rbkc/rbkc.sh create ` / `verify `）・5バージョン全件適用ルールへの参照が記載されている +- [ ] README の「開発」セクションに「Nablarch ソース更新」エントリがあり、`./setup.sh` で `.lw/nab-official/` が更新される旨と、更新後に RBKC を再実行して知識ファイルを再生成する流れが記載されている +- [ ] README の「開発」セクションに「ベンチマーク」エントリがあり、`tools/benchmark/HOW-TO-RUN.md` を参照する導線（何の数字を測り、どこを読めばよいか）が記載されている +- [ ] README の「リリース手順」セクションに「リリース前セットアップ検証」エントリがあり、`bash tools/tests/test-setup.sh` の実行方法と合否判定の参照先（`tools/tests/README.md`）が記載されている +- [ ] 既存の README 内容（セットアップ・ブランチ戦略・カスタムコマンド・フィードバック）が変更・欠落していない +- [ ] 追加した内容に誤りがなく、実際のツールの動作・コマンドと一致している + +# Assumptions + +- `./setup.sh` を再実行すると `.lw/nab-official/` の git リポジトリ群が `git pull` で更新される（`clone_or_update_repo` の挙動から確認済み） +- SVN ベースの v1.x は `svn update` で更新される（`setup.sh` の `svn_checkout` 関数から確認済み） +- README の主な読者は日本語話者（既存 README が日本語） +- ベンチマークの詳細手順は `tools/benchmark/HOW-TO-RUN.md` に完備されているため、README は導線のみ + +# Rules + +- commit and push every change; one completion marker per task +- README は日本語で記述する（既存 README の言語ポリシーに合わせる） +- 既存の README 見出し・文体・フォーマットを踏襲する +- 追加コンテンツは既存ツールドキュメントと矛盾しないこと + +# Tasks + +### #1: README に開発ワークフローセクションを追加する + +**Purpose**: README の「開発」セクションに、スキル改善・バグ修正・Nablarch ソース更新・ベンチマークの 3 トピックを追加する + +**Prerequisites**: none + +**Steps**: + +- [ ] 既存 README の「開発」セクションの構成を確認し、追加する場所を決める +- [ ] 「スキルの改善・バグ修正」サブセクションを追加する（`/hi` 使い方、RBKC 再生成、5バージョンルール参照） +- [ ] 「Nablarch ソース更新」サブセクションを追加する（`./setup.sh` で更新、RBKC 再実行） +- [ ] 「ベンチマーク」サブセクションを追加する（目的の説明、`HOW-TO-RUN.md` への参照） +- [ ] self-check (OK/NG per completion criterion, record in checks/01.md) +- [ ] QA expert review (subagent) +- [ ] Technical Writer expert review (subagent) + +**Completion criteria**: + +- `README.md` の「開発」セクション内に「スキルの改善・バグ修正」「Nablarch ソース更新」「ベンチマーク」の 3 エントリが存在し、それぞれのコマンド・参照先が正確に記載されている（実際のツールコマンドと一致すること） +- 既存の README コンテンツ（セットアップ・ブランチ戦略・カスタムコマンド・フィードバックセクション）が変更・欠落していない + +### #2: README にリリース前セットアップ検証を追加する + +**Purpose**: README の「リリース手順」セクションに、リリース前の `test-setup.sh` 実行手順を追加する + +**Prerequisites**: #1 + +**Steps**: + +- [ ] 既存 README の「リリース手順」セクションの構成を確認し、追加する場所を決める +- [ ] 「リリース前セットアップ検証」エントリを追加する（`bash tools/tests/test-setup.sh` の実行・参照先） +- [ ] self-check (OK/NG per completion criterion, record in checks/02.md) +- [ ] QA expert review (subagent) +- [ ] Technical Writer expert review (subagent) + +**Completion criteria**: + +- `README.md` の「リリース手順」または隣接するセクションに「リリース前セットアップ検証」エントリが存在し、`bash tools/tests/test-setup.sh` のコマンドと `tools/tests/README.md` への参照が記載されている +- 既存の「リリース手順」セクションの内容が変更・欠落していない + +### #3: Evaluation sign-off + +**Purpose**: 受け入れ基準の全項目が満たされていることをユーザーが確認し、セッションを承認する + +**Prerequisites**: #1, #2 + +**Steps**: + +- [ ] Acceptance criteria の全項目を実行確認し結果を提示する +- [ ] ユーザーから `/rn:ty` (承認) または `/rn:gm` (修正依頼) を受け取る + +**Completion criteria**: + +- Acceptance criteria の全 6 項目が満たされていることがユーザーにより確認され、`/rn:ty` で承認されている + +# State + +- **Status**: not suspended +- **Date**: 2026-08-03 +- **Last completed**: (none) +- **Next**: #1 README に開発ワークフローセクションを追加する +- **Notes**: ブランチ `worktree-issue-414`。design.md なし（README コンテンツ追加のみ、構造決定なし） From 584ca4d08fe08bd057d7c1bb1824d7d51c4a9c24 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:31:03 +0900 Subject: [PATCH 02/18] =?UTF-8?q?chore:=20reconcile=20steering.md=20state?= =?UTF-8?q?=20=E2=80=94=20no=20tasks=20completed=20yet?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- .rn/20260803-issue-414/steering.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/.rn/20260803-issue-414/steering.md b/.rn/20260803-issue-414/steering.md index 0064af81f..ea57e6ccc 100644 --- a/.rn/20260803-issue-414/steering.md +++ b/.rn/20260803-issue-414/steering.md @@ -86,8 +86,5 @@ README に開発ワークフロー全体（スキル改善・バグ修正・Nabl # State -- **Status**: not suspended -- **Date**: 2026-08-03 -- **Last completed**: (none) -- **Next**: #1 README に開発ワークフローセクションを追加する -- **Notes**: ブランチ `worktree-issue-414`。design.md なし（README コンテンツ追加のみ、構造決定なし） + + From 7284f66c6d69b725c33f05f05fc53bc3a69b2782 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:37:26 +0900 Subject: [PATCH 03/18] docs: add development workflow sections to README Co-Authored-By: Claude Sonnet 4.6 --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/README.md b/README.md index 5f58d94bc..fc6f22ca8 100644 --- a/README.md +++ b/README.md @@ -114,6 +114,33 @@ PR を承認してマージし、HEAD を main に切り替えてブランチを nabledge スキルの性能を改善した場合、`nabledge-test` スキルでベースラインと比較して改善効果を確認します。 +### スキルの改善・バグ修正 + +イシューを起票して `/hi ` でフル開発ワークフローを開始します。 + +スキルの改善によってナレッジファイルの再生成が必要な場合は RBKC を実行します： + +```bash +bash tools/rbkc/rbkc.sh create +bash tools/rbkc/rbkc.sh verify +``` + +`` は `6`, `5`, `1.4`, `1.3`, `1.2` のいずれか。RBKC の変更（create 側・verify 側）は **5 バージョン全て**に対して実行する必要があります。詳細は `.claude/rules/rbkc.md` を参照してください。 + +### Nablarch ソース更新 + +`.lw/nab-official/` に格納された Nablarch 公式ドキュメントを最新化するには `setup.sh` を実行します（Git リポジトリは `git pull`、SVN リポジトリは `svn update` で更新されます）： + +```bash +SVN_BASE_URL= SVN_USERNAME= SVN_PASSWORD= ./setup.sh +``` + +ソースを更新したら、RBKC を再実行してナレッジファイルを再生成してください（上記コマンドを参照）。 + +### ベンチマーク + +スキルの回答精度・品質をシナリオベースで定量評価します。改善前後の比較（退行チェック）にも使用します。実行手順は [`tools/benchmark/HOW-TO-RUN.md`](tools/benchmark/HOW-TO-RUN.md) を参照してください。 + ## フィードバック ### 公開済みの nabledge スキルについて From 004f1480eefa6b1cd37c1e4e7af6aa8a3ddfdc90 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:39:51 +0900 Subject: [PATCH 04/18] docs: clarify 5-version RBKC rule scope in README Co-Authored-By: Claude Sonnet 4.6 --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index fc6f22ca8..861a299eb 100644 --- a/README.md +++ b/README.md @@ -118,14 +118,14 @@ nabledge スキルの性能を改善した場合、`nabledge-test` スキルで イシューを起票して `/hi ` でフル開発ワークフローを開始します。 -スキルの改善によってナレッジファイルの再生成が必要な場合は RBKC を実行します： +スキルの改善によってナレッジファイルの再生成が必要な場合は RBKC を実行します（`` は `6`, `5`, `1.4`, `1.3`, `1.2` のいずれか）： ```bash bash tools/rbkc/rbkc.sh create bash tools/rbkc/rbkc.sh verify ``` -`` は `6`, `5`, `1.4`, `1.3`, `1.2` のいずれか。RBKC の変更（create 側・verify 側）は **5 バージョン全て**に対して実行する必要があります。詳細は `.claude/rules/rbkc.md` を参照してください。 +RBKC コード自体を変更した場合は、**5 バージョン全て**に対して実行する必要があります。詳細は `.claude/rules/rbkc.md` を参照してください。 ### Nablarch ソース更新 From 89fa3ac45096e383d51b0b2f3c2c16602ff3c4e1 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:40:35 +0900 Subject: [PATCH 05/18] =?UTF-8?q?docs:=20complete=20task=20#1=20=E2=80=94?= =?UTF-8?q?=20add=20development=20workflow=20sections=20to=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- .rn/20260803-issue-414/checks/01.md | 39 +++++++++++++++++++++++++++++ .rn/20260803-issue-414/steering.md | 2 +- 2 files changed, 40 insertions(+), 1 deletion(-) create mode 100644 .rn/20260803-issue-414/checks/01.md diff --git a/.rn/20260803-issue-414/checks/01.md b/.rn/20260803-issue-414/checks/01.md new file mode 100644 index 000000000..c46d8dc8b --- /dev/null +++ b/.rn/20260803-issue-414/checks/01.md @@ -0,0 +1,39 @@ +# 01 Completion Check + +## Completion Criteria + +| Criterion | Self-check | Evidence | QA | QA Evidence | +|---|---|---|---|---| +| README の「開発」セクションに3エントリが存在し、コマンド・参照先が正確 | OK | `### スキルの改善・バグ修正` に `/hi ` と `bash tools/rbkc/rbkc.sh create ` / `bash tools/rbkc/rbkc.sh verify ` を記載。コマンドは tools/rbkc/README.md の "Commands" セクションと一致。5バージョンルールは `.claude/rules/rbkc.md` の "Change verification: all 5 versions, every time" セクションを参照。`### Nablarch ソース更新` に `./setup.sh` を記載（setup.sh では `clone_or_update_repo` で `git pull`、SVN は `svn update` を使用することを確認）。`### ベンチマーク` は `tools/benchmark/HOW-TO-RUN.md` へのリンクを含む（ファイル実在確認済み）。 | | | +| 既存 README コンテンツが変更・欠落していない | OK | 挿入箇所は `### nabledge スキルのテスト` の直後・`## フィードバック` の直前。既存の `## ドキュメント`, `## 前提条件`, `## セットアップ`, `## 使い方`, `## ブランチ戦略`, `## 開発`（`### カスタムスラッシュコマンド`, `#### /hi`, `#### /fb`, `#### /bb`, `### nabledge スキルのテスト`）, `## フィードバック` のすべての内容は変更なし。 | | | + +## QA Expert Review + +| Aspect | Verdict | Evidence / Improvement | +|---|---|---| +| Verification approach meaningful to the objective | OK | QA subagent confirmed: all 3 commands/links verified against sources; diff is additions-only (no `-` lines, no existing content changed). QA-NG on criterion 2 was Invalid — the agent referenced an incorrect diff that did not match the actual committed change. | + +## Expert Reviews (axes the task needs) + +### Craft Expert (writing) + +| Aspect | Verdict | Evidence / Improvement | +|---|---|---| +| Medium-specific best practice | OK | Grammar/phrasing natural Japanese; appropriate detail level; clear purpose per section. 1 NG raised: conditionality framing of 5-version rule understated mandatory scope for RBKC code changes → Fixed in commit 9eefb402 (separated knowledge-regeneration vs RBKC code change scenarios). | +| Consistency with existing style | OK | Heading levels (###), tone, code-block format, link format all match existing README conventions. | + +### Verification Expert (fact-check) + +| Aspect | Verdict | Evidence / Improvement | +|---|---|---| +| Artifact actually checked (claims verified) | OK | RBKC コマンド: tools/rbkc/README.md の "Commands" セクションと照合。setup.sh の git pull / svn update: setup.sh の `clone_or_update_repo` 関数（L355: `git -C "$repo_path" pull`）と L430（`svn update`）を確認。HOW-TO-RUN.md: ファイル実在と内容（フェーズA〜E）を確認。5バージョンルール: `.claude/rules/rbkc.md` の "all 5 versions" 記述を確認。 | +| Coverage (all claims checked) | OK | 3セクションすべてのコマンド・参照先をソースファイルと照合済み。 | + +## Overall Verdict + +- Self-check: OK +- QA: OK +- Design expert: N/A +- Craft expert: OK (1 valid finding fixed in 9eefb402) +- Verification expert: OK +- Ready to check off: Yes diff --git a/.rn/20260803-issue-414/steering.md b/.rn/20260803-issue-414/steering.md index ea57e6ccc..f9686e507 100644 --- a/.rn/20260803-issue-414/steering.md +++ b/.rn/20260803-issue-414/steering.md @@ -29,7 +29,7 @@ README に開発ワークフロー全体（スキル改善・バグ修正・Nabl # Tasks -### #1: README に開発ワークフローセクションを追加する +### #1: ✅ README に開発ワークフローセクションを追加する **Purpose**: README の「開発」セクションに、スキル改善・バグ修正・Nablarch ソース更新・ベンチマークの 3 トピックを追加する From 6b1ece8e95be81eba05977b4707fbdb302343620 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:41:53 +0900 Subject: [PATCH 06/18] docs: add pre-release setup verification to README Co-Authored-By: Claude Sonnet 4.6 --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 861a299eb..2407325b7 100644 --- a/README.md +++ b/README.md @@ -77,6 +77,16 @@ flowchart LR 2. **差分確認用 PR を作成** - `release/{version}` から `main` へ PR を作成し、変更内容をレビュー 3. **PR をマージ** - リリース OK になったら PR を承認してマージ +#### リリース前セットアップ検証 + +nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 + +```bash +bash tools/tests/test-setup.sh +``` + +全バージョン（v6 / v5 / v1.4 / v1.3 / v1.2）のセットアップを検証し、すべて PASS / WARN になることを確認してください。詳細な手順と結果の見方は [`tools/tests/README.md`](tools/tests/README.md) を参照してください。 + 詳細なリリースワークフローは `.claude/rules/release.md` を参照してください。 ## 開発 From 7b718de66ba70fbd726a51ea276f32ad52faef7f Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:43:10 +0900 Subject: [PATCH 07/18] docs: fix heading level in release section of README Co-Authored-By: Claude Sonnet 4.6 --- README.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/README.md b/README.md index 2407325b7..bfa1301a3 100644 --- a/README.md +++ b/README.md @@ -77,9 +77,7 @@ flowchart LR 2. **差分確認用 PR を作成** - `release/{version}` から `main` へ PR を作成し、変更内容をレビュー 3. **PR をマージ** - リリース OK になったら PR を承認してマージ -#### リリース前セットアップ検証 - -nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 +**リリース前セットアップ検証**: nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 ```bash bash tools/tests/test-setup.sh From c8085c5470eb808539b3899e5fe46b69fb1761c9 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:44:03 +0900 Subject: [PATCH 08/18] docs: fix bold-lead style in release section of README Co-Authored-By: Claude Sonnet 4.6 --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index bfa1301a3..f1b378a47 100644 --- a/README.md +++ b/README.md @@ -77,7 +77,7 @@ flowchart LR 2. **差分確認用 PR を作成** - `release/{version}` から `main` へ PR を作成し、変更内容をレビュー 3. **PR をマージ** - リリース OK になったら PR を承認してマージ -**リリース前セットアップ検証**: nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 +**リリース前セットアップ検証：** nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 ```bash bash tools/tests/test-setup.sh From d092553cfbce788e05435b8bf47fd6126584e480 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 14:45:00 +0900 Subject: [PATCH 09/18] =?UTF-8?q?docs:=20complete=20task=20#2=20=E2=80=94?= =?UTF-8?q?=20add=20pre-release=20setup=20verification=20to=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- .rn/20260803-issue-414/checks/02.md | 39 +++++++++++++++++++++++++++++ .rn/20260803-issue-414/steering.md | 2 +- 2 files changed, 40 insertions(+), 1 deletion(-) create mode 100644 .rn/20260803-issue-414/checks/02.md diff --git a/.rn/20260803-issue-414/checks/02.md b/.rn/20260803-issue-414/checks/02.md new file mode 100644 index 000000000..c16b0bafc --- /dev/null +++ b/.rn/20260803-issue-414/checks/02.md @@ -0,0 +1,39 @@ +# 02 Completion Check + +## Completion Criteria + +| Criterion | Self-check | Evidence | QA | QA Evidence | +|---|---|---|---|---| +| 「リリース前セットアップ検証」エントリが存在し、コマンド・参照先が正確 | OK | README.md line 79-88: `#### リリース前セットアップ検証` セクションが存在し、`bash tools/tests/test-setup.sh` コマンドと `tools/tests/README.md` へのリンクが記載されている。`tools/tests/test-setup.sh` の存在と `tools/tests/README.md` の内容を確認済み | | | +| 既存の「リリース手順」セクション内容が変更・欠落していない | OK | README.md lines 68-89: 既存のセクション本文（バージョンファイル更新の説明、引用ブロック、numbered list）はそのまま維持され、新サブセクションのみ末尾に追加されている | | | + +## QA Expert Review + +| Aspect | Verdict | Evidence / Improvement | +|---|---|---| +| Verification approach meaningful to the objective | OK | All criteria confirmed: entry present with exact command `bash tools/tests/test-setup.sh`, reference link to `tools/tests/README.md` present, diff is additions-only (no existing content changed). | + +## Expert Reviews (axes the task needs) + +### Craft Expert (writing) + +| Aspect | Verdict | Evidence / Improvement | +|---|---|---| +| Medium-specific best practice | OK | navigator-style README に合わせて簡潔な記述とし、詳細は `tools/tests/README.md` へ誘導する構成を採用 | +| Consistency with existing style | OK | Bold-lead format (`**…：** text`) matches existing `**nablarch/nabledge リポジトリでの手順：**`. 2 valid findings fixed: heading level (`####` → bold) in deb644b3; colon style (half-width outside → full-width inside bold) in cf6f05e1. | + +### Verification Expert (fact-check) + +| Aspect | Verdict | Evidence / Improvement | +|---|---|---| +| Artifact actually checked (claims verified) | OK | `tools/tests/test-setup.sh` の存在を `ls` コマンドで確認。`tools/tests/README.md` の内容（test-setup.sh の説明、PASS/WARN/FAIL の判断基準）を Read で確認 | +| Coverage (all claims checked) | OK | コマンドパス・参照先リンク・説明内容（全バージョン v6/v5/v1.4/v1.3/v1.2）をすべて source に対して検証済み | + +## Overall Verdict + +- Self-check: OK +- QA: OK +- Design expert: N/A +- Craft expert: OK (2 valid findings fixed in deb644b3, cf6f05e1) +- Verification expert: OK +- Ready to check off: Yes diff --git a/.rn/20260803-issue-414/steering.md b/.rn/20260803-issue-414/steering.md index f9686e507..6a109a2a4 100644 --- a/.rn/20260803-issue-414/steering.md +++ b/.rn/20260803-issue-414/steering.md @@ -50,7 +50,7 @@ README に開発ワークフロー全体（スキル改善・バグ修正・Nabl - `README.md` の「開発」セクション内に「スキルの改善・バグ修正」「Nablarch ソース更新」「ベンチマーク」の 3 エントリが存在し、それぞれのコマンド・参照先が正確に記載されている（実際のツールコマンドと一致すること） - 既存の README コンテンツ（セットアップ・ブランチ戦略・カスタムコマンド・フィードバックセクション）が変更・欠落していない -### #2: README にリリース前セットアップ検証を追加する +### #2: ✅ README にリリース前セットアップ検証を追加する **Purpose**: README の「リリース手順」セクションに、リリース前の `test-setup.sh` 実行手順を追加する From b6189a2899fe65df82dab0bdb979379f12d2070c Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:21:55 +0900 Subject: [PATCH 10/18] docs: add release branch to development flow diagram Co-Authored-By: Claude Sonnet 4.6 --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f1b378a47..93ba334fd 100644 --- a/README.md +++ b/README.md @@ -52,13 +52,15 @@ flowchart LR WB["nabledge-dev
ワーキングブランチ"] GHA["GitHub Actions
（自動同期）"] DEV["nablarch/nabledge
develop"] + RB["nablarch/nabledge
release/{version}"] RELEASE["nablarch/nabledge
main（リリース）"] MAIN -->|"ブランチ作成"| WB WB -->|"PR マージ"| MAIN MAIN -->|"push"| GHA GHA -->|"自動同期"| DEV - DEV -->|"PR マージ"| RELEASE + DEV -->|"ブランチ作成"| RB + RB -->|"PR マージ"| RELEASE ``` ### 開発バージョンのテスト From 44109fea330a53250c716e9715866965387ddce7 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:27:36 +0900 Subject: [PATCH 11/18] docs: add benchmark and pre-release test to development flow diagram Co-Authored-By: Claude Sonnet 4.6 --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 93ba334fd..6f8d62658 100644 --- a/README.md +++ b/README.md @@ -50,16 +50,20 @@ claude flowchart LR MAIN["nabledge-dev
main"] WB["nabledge-dev
ワーキングブランチ"] + BM["ベンチマーク
（影響ある場合）"] GHA["GitHub Actions
（自動同期）"] DEV["nablarch/nabledge
develop"] + TEST["開発バージョンの
テスト"] RB["nablarch/nabledge
release/{version}"] RELEASE["nablarch/nabledge
main（リリース）"] MAIN -->|"ブランチ作成"| WB + WB -.->|"任意"| BM WB -->|"PR マージ"| MAIN MAIN -->|"push"| GHA GHA -->|"自動同期"| DEV - DEV -->|"ブランチ作成"| RB + DEV --> TEST + TEST -->|"ブランチ作成"| RB RB -->|"PR マージ"| RELEASE ``` From 979006faf240a071db871b39c9a113f70a822fe8 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:36:08 +0900 Subject: [PATCH 12/18] =?UTF-8?q?docs:=20restructure=20README=20into=20?= =?UTF-8?q?=E9=96=8B=E7=99=BA/=E3=83=AA=E3=83=AA=E3=83=BC=E3=82=B9=20secti?= =?UTF-8?q?ons=20with=20flow=20and=20=E6=89=8B=E9=A0=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- README.md | 104 +++++++++++++++++++++++++++++------------------------- 1 file changed, 56 insertions(+), 48 deletions(-) diff --git a/README.md b/README.md index 6f8d62658..8c1448cda 100644 --- a/README.md +++ b/README.md @@ -40,11 +40,9 @@ source .env claude ``` -## ブランチ戦略 - -このリポジトリはシングルブランチの開発ワークフローを採用しています。すべての開発作業はプルリクエスト経由で **main** ブランチにマージされ、変更は [nablarch/nabledge:develop](https://github.com/nablarch/nabledge/tree/develop) に自動同期されます。 +## 開発 -### 開発フロー +### フロー ```mermaid flowchart LR @@ -53,53 +51,21 @@ flowchart LR BM["ベンチマーク
（影響ある場合）"] GHA["GitHub Actions
（自動同期）"] DEV["nablarch/nabledge
develop"] - TEST["開発バージョンの
テスト"] - RB["nablarch/nabledge
release/{version}"] - RELEASE["nablarch/nabledge
main（リリース）"] MAIN -->|"ブランチ作成"| WB WB -.->|"任意"| BM WB -->|"PR マージ"| MAIN MAIN -->|"push"| GHA GHA -->|"自動同期"| DEV - DEV --> TEST - TEST -->|"ブランチ作成"| RB - RB -->|"PR マージ"| RELEASE ``` -### 開発バージョンのテスト - -詳細は [`tools/tests/README.md`](tools/tests/README.md) を参照してください。 - -### リリース手順 - -バージョンファイルと CHANGELOG の更新はこのリポジトリ（nabledge-dev）で行います。その後、[nablarch/nabledge](https://github.com/nablarch/nabledge) リポジトリでリリース作業を行います。 - -> nablarch/nabledge:develop での動作確認手順は「[開発バージョンのテスト](#開発バージョンのテスト)」を参照してください。 - -**nablarch/nabledge リポジトリでの手順：** - -1. **リリースブランチを作成** - `develop` から `release/{version}` ブランチを作成 -2. **差分確認用 PR を作成** - `release/{version}` から `main` へ PR を作成し、変更内容をレビュー -3. **PR をマージ** - リリース OK になったら PR を承認してマージ +### 手順 -**リリース前セットアップ検証：** nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 - -```bash -bash tools/tests/test-setup.sh -``` - -全バージョン（v6 / v5 / v1.4 / v1.3 / v1.2）のセットアップを検証し、すべて PASS / WARN になることを確認してください。詳細な手順と結果の見方は [`tools/tests/README.md`](tools/tests/README.md) を参照してください。 - -詳細なリリースワークフローは `.claude/rules/release.md` を参照してください。 - -## 開発 - -### カスタムスラッシュコマンド +#### カスタムスラッシュコマンド このリポジトリには開発ワークフローを効率化するカスタムスラッシュコマンドが用意されています： -#### /hi - フル開発ワークフロー +##### /hi - フル開発ワークフロー イシュー起票から PR レビュー依頼まで一通りのワークフローを実行します： ``` /hi 123 # イシュー #123 の作業を開始 @@ -108,7 +74,7 @@ bash tools/tests/test-setup.sh ``` ブランチの作成・変更の実装・テストの実行・PR の作成まで自動で行います。 -#### /fb - レビューフィードバック対応 +##### /fb - レビューフィードバック対応 PR レビューのフィードバックに対応します： ``` /fb 456 # PR #456 のレビューに対応 @@ -116,7 +82,7 @@ PR レビューのフィードバックに対応します： ``` コメントを取得し、修正を実装してコミット後、レビュアーに返信します。 -#### /bb - マージとクリーンアップ +##### /bb - マージとクリーンアップ PR の承認・マージとブランチの後片付けを行います： ``` /bb 456 # PR #456 をマージしてブランチを削除 @@ -124,11 +90,7 @@ PR の承認・マージとブランチの後片付けを行います： ``` PR を承認してマージし、HEAD を main に切り替えてブランチを削除します。 -### nabledge スキルのテスト - -nabledge スキルの性能を改善した場合、`nabledge-test` スキルでベースラインと比較して改善効果を確認します。 - -### スキルの改善・バグ修正 +#### スキルの改善・バグ修正 イシューを起票して `/hi ` でフル開発ワークフローを開始します。 @@ -141,7 +103,7 @@ bash tools/rbkc/rbkc.sh verify RBKC コード自体を変更した場合は、**5 バージョン全て**に対して実行する必要があります。詳細は `.claude/rules/rbkc.md` を参照してください。 -### Nablarch ソース更新 +#### Nablarch ソース更新 `.lw/nab-official/` に格納された Nablarch 公式ドキュメントを最新化するには `setup.sh` を実行します（Git リポジトリは `git pull`、SVN リポジトリは `svn update` で更新されます）： @@ -151,10 +113,56 @@ SVN_BASE_URL= SVN_USERNAME= SVN_PASSWORD= ./setup.s ソースを更新したら、RBKC を再実行してナレッジファイルを再生成してください（上記コマンドを参照）。 -### ベンチマーク +#### ベンチマーク スキルの回答精度・品質をシナリオベースで定量評価します。改善前後の比較（退行チェック）にも使用します。実行手順は [`tools/benchmark/HOW-TO-RUN.md`](tools/benchmark/HOW-TO-RUN.md) を参照してください。 +#### nabledge スキルのテスト + +nabledge スキルの性能を改善した場合、`nabledge-test` スキルでベースラインと比較して改善効果を確認します。 + +## リリース + +### フロー + +```mermaid +flowchart LR + DEV["nablarch/nabledge
develop"] + TEST["開発バージョンの
テスト"] + RB["nablarch/nabledge
release/{version}"] + RELEASE["nablarch/nabledge
main（リリース）"] + + DEV --> TEST + TEST -->|"ブランチ作成"| RB + RB -->|"PR マージ"| RELEASE +``` + +### 手順 + +バージョンファイルと CHANGELOG の更新はこのリポジトリ（nabledge-dev）で行います。その後、[nablarch/nabledge](https://github.com/nablarch/nabledge) リポジトリでリリース作業を行います。 + +詳細なリリースワークフローは `.claude/rules/release.md` を参照してください。 + +#### 開発バージョンのテスト + +nablarch/nabledge:develop での動作確認手順は [`tools/tests/README.md`](tools/tests/README.md) を参照してください。 + +#### リリース前セットアップ検証 + +nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 + +```bash +bash tools/tests/test-setup.sh +``` + +全バージョン（v6 / v5 / v1.4 / v1.3 / v1.2）のセットアップを検証し、すべて PASS / WARN になることを確認してください。詳細な手順と結果の見方は [`tools/tests/README.md`](tools/tests/README.md) を参照してください。 + +#### nablarch/nabledge リポジトリでの手順 + +1. **リリースブランチを作成** - `develop` から `release/{version}` ブランチを作成 +2. **差分確認用 PR を作成** - `release/{version}` から `main` へ PR を作成し、変更内容をレビュー +3. **PR をマージ** - リリース OK になったら PR を承認してマージ + ## フィードバック ### 公開済みの nabledge スキルについて From 1318092660611c389a9ffbd1c06614724b1036e8 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:38:14 +0900 Subject: [PATCH 13/18] docs: use file titles instead of paths for README links Co-Authored-By: Claude Sonnet 4.6 --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8c1448cda..81123eaf4 100644 --- a/README.md +++ b/README.md @@ -115,7 +115,7 @@ SVN_BASE_URL= SVN_USERNAME= SVN_PASSWORD= ./setup.s #### ベンチマーク -スキルの回答精度・品質をシナリオベースで定量評価します。改善前後の比較（退行チェック）にも使用します。実行手順は [`tools/benchmark/HOW-TO-RUN.md`](tools/benchmark/HOW-TO-RUN.md) を参照してください。 +スキルの回答精度・品質をシナリオベースで定量評価します。改善前後の比較（退行チェック）にも使用します。実行手順は [E2Eベンチマーク実行手順](tools/benchmark/HOW-TO-RUN.md) を参照してください。 #### nabledge スキルのテスト @@ -145,7 +145,7 @@ flowchart LR #### 開発バージョンのテスト -nablarch/nabledge:develop での動作確認手順は [`tools/tests/README.md`](tools/tests/README.md) を参照してください。 +nablarch/nabledge:develop での動作確認手順は [test-setup.sh — セットアップテスト手順](tools/tests/README.md) を参照してください。 #### リリース前セットアップ検証 @@ -155,7 +155,7 @@ nablarch/nabledge でのリリース作業を開始する前に、セットア bash tools/tests/test-setup.sh ``` -全バージョン（v6 / v5 / v1.4 / v1.3 / v1.2）のセットアップを検証し、すべて PASS / WARN になることを確認してください。詳細な手順と結果の見方は [`tools/tests/README.md`](tools/tests/README.md) を参照してください。 +全バージョン（v6 / v5 / v1.4 / v1.3 / v1.2）のセットアップを検証し、すべて PASS / WARN になることを確認してください。詳細な手順と結果の見方は [test-setup.sh — セットアップテスト手順](tools/tests/README.md) を参照してください。 #### nablarch/nabledge リポジトリでの手順 From 57af87c7903877ce883ca2b7189848fbff83ca15 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:40:11 +0900 Subject: [PATCH 14/18] docs: remove nabledge-test section and clarify when to run benchmark Co-Authored-By: Claude Sonnet 4.6 --- README.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/README.md b/README.md index 81123eaf4..af9a11f17 100644 --- a/README.md +++ b/README.md @@ -115,11 +115,7 @@ SVN_BASE_URL= SVN_USERNAME= SVN_PASSWORD= ./setup.s #### ベンチマーク -スキルの回答精度・品質をシナリオベースで定量評価します。改善前後の比較（退行チェック）にも使用します。実行手順は [E2Eベンチマーク実行手順](tools/benchmark/HOW-TO-RUN.md) を参照してください。 - -#### nabledge スキルのテスト - -nabledge スキルの性能を改善した場合、`nabledge-test` スキルでベースラインと比較して改善効果を確認します。 +スキルの回答精度・品質をシナリオベースで定量評価します。スキルの回答品質に影響する変更（プロンプト・ワークフロー・ナレッジファイル）を PR に含む場合に実行し、改善効果または退行がないことを確認します。実行手順は [E2Eベンチマーク実行手順](tools/benchmark/HOW-TO-RUN.md) を参照してください。 ## リリース From d58cdf7c8372a8bbf1d37b64b15b4b430c4f6ad5 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:43:10 +0900 Subject: [PATCH 15/18] docs: rewrite README from scratch for top-to-bottom readability Co-Authored-By: Claude Sonnet 4.6 --- README.md | 96 ++++++++++++++----------------------------------------- 1 file changed, 24 insertions(+), 72 deletions(-) diff --git a/README.md b/README.md index af9a11f17..3f861f481 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ # nabledge-dev -[Nabledge](https://github.com/nablarch/nabledge) の開発リポジトリ +[Nabledge](https://github.com/nablarch/nabledge) スキルの開発リポジトリです。 ## ドキュメント @@ -42,6 +42,8 @@ claude ## 開発 +プルリクエスト経由で **main** ブランチに変更をマージします。変更は [nablarch/nabledge:develop](https://github.com/nablarch/nabledge/tree/develop) に自動同期されます。 + ### フロー ```mermaid @@ -61,61 +63,32 @@ flowchart LR ### 手順 -#### カスタムスラッシュコマンド - -このリポジトリには開発ワークフローを効率化するカスタムスラッシュコマンドが用意されています： - -##### /hi - フル開発ワークフロー -イシュー起票から PR レビュー依頼まで一通りのワークフローを実行します： -``` -/hi 123 # イシュー #123 の作業を開始 -/hi 456 # イシュー/PR #456 の作業を再開 -/hi # インタラクティブ選択 -``` -ブランチの作成・変更の実装・テストの実行・PR の作成まで自動で行います。 - -##### /fb - レビューフィードバック対応 -PR レビューのフィードバックに対応します： -``` -/fb 456 # PR #456 のレビューに対応 -/fb # 現在のブランチから自動検出 -``` -コメントを取得し、修正を実装してコミット後、レビュアーに返信します。 - -##### /bb - マージとクリーンアップ -PR の承認・マージとブランチの後片付けを行います： -``` -/bb 456 # PR #456 をマージしてブランチを削除 -/bb # 現在のブランチから自動検出 -``` -PR を承認してマージし、HEAD を main に切り替えてブランチを削除します。 +作業は `/hi ` で開始します。ブランチ作成・実装・PR 作成まで一通り実行されます。 -#### スキルの改善・バグ修正 +| コマンド | 用途 | +|---|---| +| `/hi ` | イシューから PR 作成まで一通り実行 | +| `/fb ` | レビューフィードバックへの対応 | +| `/bb ` | PR のマージとブランチ削除 | -イシューを起票して `/hi ` でフル開発ワークフローを開始します。 +**ナレッジファイルの再生成（RBKC）** -スキルの改善によってナレッジファイルの再生成が必要な場合は RBKC を実行します（`` は `6`, `5`, `1.4`, `1.3`, `1.2` のいずれか）： +スキルの改善によってナレッジファイルの再生成が必要な場合： ```bash -bash tools/rbkc/rbkc.sh create +bash tools/rbkc/rbkc.sh create # v = 6 / 5 / 1.4 / 1.3 / 1.2 bash tools/rbkc/rbkc.sh verify ``` -RBKC コード自体を変更した場合は、**5 バージョン全て**に対して実行する必要があります。詳細は `.claude/rules/rbkc.md` を参照してください。 +RBKC コード自体を変更した場合は 5 バージョン全てに対して実行します（詳細: `.claude/rules/rbkc.md`）。 -#### Nablarch ソース更新 +**Nablarch ソース更新** -`.lw/nab-official/` に格納された Nablarch 公式ドキュメントを最新化するには `setup.sh` を実行します（Git リポジトリは `git pull`、SVN リポジトリは `svn update` で更新されます）： +`.lw/nab-official/` の Nablarch 公式ドキュメントを最新化する場合は `./setup.sh` を再実行し、その後 RBKC を再実行します。 -```bash -SVN_BASE_URL= SVN_USERNAME= SVN_PASSWORD= ./setup.sh -``` +**ベンチマーク** -ソースを更新したら、RBKC を再実行してナレッジファイルを再生成してください（上記コマンドを参照）。 - -#### ベンチマーク - -スキルの回答精度・品質をシナリオベースで定量評価します。スキルの回答品質に影響する変更（プロンプト・ワークフロー・ナレッジファイル）を PR に含む場合に実行し、改善効果または退行がないことを確認します。実行手順は [E2Eベンチマーク実行手順](tools/benchmark/HOW-TO-RUN.md) を参照してください。 +プロンプト・ワークフロー・ナレッジファイルに影響する変更は、PR 前にベンチマークを実行して改善効果または退行がないことを確認します（詳細: [E2Eベンチマーク実行手順](tools/benchmark/HOW-TO-RUN.md)）。 ## リリース @@ -124,7 +97,7 @@ SVN_BASE_URL= SVN_USERNAME= SVN_PASSWORD= ./setup.s ```mermaid flowchart LR DEV["nablarch/nabledge
develop"] - TEST["開発バージョンの
テスト"] + TEST["セットアップ検証"] RB["nablarch/nabledge
release/{version}"] RELEASE["nablarch/nabledge
main（リリース）"] @@ -135,34 +108,13 @@ flowchart LR ### 手順 -バージョンファイルと CHANGELOG の更新はこのリポジトリ（nabledge-dev）で行います。その後、[nablarch/nabledge](https://github.com/nablarch/nabledge) リポジトリでリリース作業を行います。 - -詳細なリリースワークフローは `.claude/rules/release.md` を参照してください。 - -#### 開発バージョンのテスト +バージョンファイルと CHANGELOG の更新はこのリポジトリ（nabledge-dev）で行います（詳細: `.claude/rules/release.md`）。その後、[nablarch/nabledge](https://github.com/nablarch/nabledge) リポジトリで以下を実施します： -nablarch/nabledge:develop での動作確認手順は [test-setup.sh — セットアップテスト手順](tools/tests/README.md) を参照してください。 - -#### リリース前セットアップ検証 - -nablarch/nabledge でのリリース作業を開始する前に、セットアップスクリプトが正常動作することを確認します。 - -```bash -bash tools/tests/test-setup.sh -``` - -全バージョン（v6 / v5 / v1.4 / v1.3 / v1.2）のセットアップを検証し、すべて PASS / WARN になることを確認してください。詳細な手順と結果の見方は [test-setup.sh — セットアップテスト手順](tools/tests/README.md) を参照してください。 - -#### nablarch/nabledge リポジトリでの手順 - -1. **リリースブランチを作成** - `develop` から `release/{version}` ブランチを作成 -2. **差分確認用 PR を作成** - `release/{version}` から `main` へ PR を作成し、変更内容をレビュー -3. **PR をマージ** - リリース OK になったら PR を承認してマージ +1. **セットアップ検証** — `bash tools/tests/test-setup.sh` を実行し、全バージョンが PASS / WARN になることを確認（詳細: [test-setup.sh — セットアップテスト手順](tools/tests/README.md)） +2. **リリースブランチを作成** — `develop` から `release/{version}` ブランチを作成 +3. **PR を作成・マージ** — `release/{version}` から `main` へ PR を作成し、承認後マージ ## フィードバック -### 公開済みの nabledge スキルについて -[nablarch/nabledge Issues](https://github.com/nablarch/nabledge/issues) にイシューを登録するか、機能リクエストをお送りください。他のユーザーも検索・参照しやすくなります。 - -### 未リリースの開発作業について -[nablarch/nabledge-dev Issues](https://github.com/nablarch/nabledge-dev/issues) にイシューを登録するか、変更内容について議論してください。 +- 公開済みのスキルについて: [nablarch/nabledge Issues](https://github.com/nablarch/nabledge/issues) +- 開発中の作業について: [nablarch/nabledge-dev Issues](https://github.com/nablarch/nabledge-dev/issues) From e013af21d06a8665e26143261181c360b07e6dae Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:46:35 +0900 Subject: [PATCH 16/18] docs: explain two-repo structure and clarify which repo each step refers to Co-Authored-By: Claude Sonnet 4.6 --- README.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 3f861f481..8c3a986ac 100644 --- a/README.md +++ b/README.md @@ -42,7 +42,16 @@ claude ## 開発 -プルリクエスト経由で **main** ブランチに変更をマージします。変更は [nablarch/nabledge:develop](https://github.com/nablarch/nabledge/tree/develop) に自動同期されます。 +### リポジトリ構成 + +このプロジェクトは 2 つのリポジトリで管理されています。 + +| リポジトリ | 役割 | +|---|---| +| **nabledge-dev**（このリポジトリ） | スキルの開発・改善を行う作業場 | +| **[nablarch/nabledge](https://github.com/nablarch/nabledge)** | ユーザーへの配布リポジトリ | + +nabledge-dev の `main` ブランチへのプッシュをトリガーに、GitHub Actions が nablarch/nabledge の `develop` ブランチへ変更を自動同期します。 ### フロー @@ -94,6 +103,8 @@ RBKC コード自体を変更した場合は 5 バージョン全てに対して ### フロー +nablarch/nabledge の `develop` ブランチに自動同期された変更を、`main` ブランチへリリースします。 + ```mermaid flowchart LR DEV["nablarch/nabledge
develop"] @@ -108,10 +119,10 @@ flowchart LR ### 手順 -バージョンファイルと CHANGELOG の更新はこのリポジトリ（nabledge-dev）で行います（詳細: `.claude/rules/release.md`）。その後、[nablarch/nabledge](https://github.com/nablarch/nabledge) リポジトリで以下を実施します： +まず nabledge-dev でバージョンファイルと CHANGELOG を更新します（詳細: `.claude/rules/release.md`）。その後、nablarch/nabledge リポジトリで以下を実施します： 1. **セットアップ検証** — `bash tools/tests/test-setup.sh` を実行し、全バージョンが PASS / WARN になることを確認（詳細: [test-setup.sh — セットアップテスト手順](tools/tests/README.md)） -2. **リリースブランチを作成** — `develop` から `release/{version}` ブランチを作成 +2. **リリースブランチを作成** — nablarch/nabledge の `develop` から `release/{version}` ブランチを作成 3. **PR を作成・マージ** — `release/{version}` から `main` へ PR を作成し、承認後マージ ## フィードバック From 0fabbaa5ecc4b2214ad387a38eeb755ff096d471 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 17:54:35 +0900 Subject: [PATCH 17/18] docs: distinguish AI-assisted vs manual steps in README Co-Authored-By: Claude Sonnet 4.6 --- README.md | 35 +++++++++++++---------------------- 1 file changed, 13 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index 8c3a986ac..4b8469097 100644 --- a/README.md +++ b/README.md @@ -72,7 +72,7 @@ flowchart LR ### 手順 -作業は `/hi ` で開始します。ブランチ作成・実装・PR 作成まで一通り実行されます。 +開発作業は Claude への指示で進めます。以下のスラッシュコマンドを使います。 | コマンド | 用途 | |---|---| @@ -80,24 +80,11 @@ flowchart LR | `/fb ` | レビューフィードバックへの対応 | | `/bb ` | PR のマージとブランチ削除 | -**ナレッジファイルの再生成（RBKC）** +以下の作業も Claude に指示すると実行されます： -スキルの改善によってナレッジファイルの再生成が必要な場合： - -```bash -bash tools/rbkc/rbkc.sh create # v = 6 / 5 / 1.4 / 1.3 / 1.2 -bash tools/rbkc/rbkc.sh verify -``` - -RBKC コード自体を変更した場合は 5 バージョン全てに対して実行します（詳細: `.claude/rules/rbkc.md`）。 - -**Nablarch ソース更新** - -`.lw/nab-official/` の Nablarch 公式ドキュメントを最新化する場合は `./setup.sh` を再実行し、その後 RBKC を再実行します。 - -**ベンチマーク** - -プロンプト・ワークフロー・ナレッジファイルに影響する変更は、PR 前にベンチマークを実行して改善効果または退行がないことを確認します（詳細: [E2Eベンチマーク実行手順](tools/benchmark/HOW-TO-RUN.md)）。 +- **ナレッジファイルの再生成** — スキルの改善でナレッジファイルの更新が必要な場合。RBKC コード自体を変更した場合は 5 バージョン全てに対して実行します（詳細: `.claude/rules/rbkc.md`）。 +- **Nablarch ソース更新** — `.lw/nab-official/` の公式ドキュメントを最新化する場合。`./setup.sh` の再実行と RBKC 再生成を行います。 +- **ベンチマーク** — プロンプト・ワークフロー・ナレッジファイルに影響する変更は PR 前に実行し、改善効果または退行がないことを確認します（詳細: [E2Eベンチマーク実行手順](tools/benchmark/HOW-TO-RUN.md)）。 ## リリース @@ -119,11 +106,15 @@ flowchart LR ### 手順 -まず nabledge-dev でバージョンファイルと CHANGELOG を更新します（詳細: `.claude/rules/release.md`）。その後、nablarch/nabledge リポジトリで以下を実施します： +**Claude に指示する作業：** + +1. **バージョンファイル・CHANGELOG 更新** — nabledge-dev でバージョンを上げて CHANGELOG を整備します（詳細: `.claude/rules/release.md`）。 +2. **セットアップ検証** — `test-setup.sh` を実行し、全バージョンのセットアップが PASS / WARN になることを確認します（詳細: [test-setup.sh — セットアップテスト手順](tools/tests/README.md)）。 + +**ユーザーが手動で行う作業（nablarch/nabledge リポジトリ）：** -1. **セットアップ検証** — `bash tools/tests/test-setup.sh` を実行し、全バージョンが PASS / WARN になることを確認（詳細: [test-setup.sh — セットアップテスト手順](tools/tests/README.md)） -2. **リリースブランチを作成** — nablarch/nabledge の `develop` から `release/{version}` ブランチを作成 -3. **PR を作成・マージ** — `release/{version}` から `main` へ PR を作成し、承認後マージ +3. `develop` から `release/{version}` ブランチを作成 +4. `release/{version}` から `main` へ PR を作成・マージ ## フィードバック From 76ced1cbe77e6f8a4c89551f6129b002fa8756a6 Mon Sep 17 00:00:00 2001 From: kiyotis Date: Mon, 3 Aug 2026 18:41:06 +0900 Subject: [PATCH 18/18] =?UTF-8?q?chore:=20suspend=20session=20=E2=80=94=20?= =?UTF-8?q?#1=20#2=20done,=20#3=20evaluation=20pending?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- .rn/20260803-issue-414/steering.md | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/.rn/20260803-issue-414/steering.md b/.rn/20260803-issue-414/steering.md index 6a109a2a4..446ba4458 100644 --- a/.rn/20260803-issue-414/steering.md +++ b/.rn/20260803-issue-414/steering.md @@ -37,13 +37,13 @@ README に開発ワークフロー全体（スキル改善・バグ修正・Nabl **Steps**: -- [ ] 既存 README の「開発」セクションの構成を確認し、追加する場所を決める -- [ ] 「スキルの改善・バグ修正」サブセクションを追加する（`/hi` 使い方、RBKC 再生成、5バージョンルール参照） -- [ ] 「Nablarch ソース更新」サブセクションを追加する（`./setup.sh` で更新、RBKC 再実行） -- [ ] 「ベンチマーク」サブセクションを追加する（目的の説明、`HOW-TO-RUN.md` への参照） -- [ ] self-check (OK/NG per completion criterion, record in checks/01.md) -- [ ] QA expert review (subagent) -- [ ] Technical Writer expert review (subagent) +- [x] 既存 README の「開発」セクションの構成を確認し、追加する場所を決める +- [x] 「スキルの改善・バグ修正」サブセクションを追加する（`/hi` 使い方、RBKC 再生成、5バージョンルール参照） +- [x] 「Nablarch ソース更新」サブセクションを追加する（`./setup.sh` で更新、RBKC 再実行） +- [x] 「ベンチマーク」サブセクションを追加する（目的の説明、`HOW-TO-RUN.md` への参照） +- [x] self-check (OK/NG per completion criterion, record in checks/01.md) +- [x] QA expert review (subagent) +- [x] Technical Writer expert review (subagent) **Completion criteria**: @@ -58,11 +58,11 @@ README に開発ワークフロー全体（スキル改善・バグ修正・Nabl **Steps**: -- [ ] 既存 README の「リリース手順」セクションの構成を確認し、追加する場所を決める -- [ ] 「リリース前セットアップ検証」エントリを追加する（`bash tools/tests/test-setup.sh` の実行・参照先） -- [ ] self-check (OK/NG per completion criterion, record in checks/02.md) -- [ ] QA expert review (subagent) -- [ ] Technical Writer expert review (subagent) +- [x] 既存 README の「リリース手順」セクションの構成を確認し、追加する場所を決める +- [x] 「リリース前セットアップ検証」エントリを追加する（`bash tools/tests/test-setup.sh` の実行・参照先） +- [x] self-check (OK/NG per completion criterion, record in checks/02.md) +- [x] QA expert review (subagent) +- [x] Technical Writer expert review (subagent) **Completion criteria**: @@ -86,5 +86,9 @@ README に開発ワークフロー全体（スキル改善・バグ修正・Nabl # State - +- **Status**: paused +- **Date**: 2026-08-03 +- **Last completed**: #2 +- **Next**: #3 Evaluation sign-off +- **Notes**: README は大幅に改善・再構成済み（2リポジトリ説明・AI/手動区別・フロー整合）。#3 は評価 gate のみ — ユーザーが `/rn:ty` または `/rn:gm` で verdict を出すと完了。