@aramassa/ai-rules 0.9.5 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,254 @@
1
+ ---
2
+ type: prompt
3
+ name: apply-fix
4
+ category: workflow
5
+ focus: implementation-application
6
+ description: "計画済みの修正をrepoルールに沿って適用。skel先行更新、構造検証、テスト運用、docs更新、PR/Issueコメントで進捗共有を標準化。"
7
+ agent: agent
8
+ ---
9
+ # prompt apply-fix ワークフロー
10
+
11
+ ## 概要
12
+
13
+ 計画(Issue/planブランチ/Draft PR)と、実装完了後の締め作業(e2e実行/PR本文追記/Checks登録)の間にある「実装中」の作業を、この prompt で標準化します。
14
+
15
+ この prompt の主目的は、計画済みの修正を repo 固有ルール(skel先行更新・構造検証・テスト制約・docs更新・change_plans運用)を破らずに適用し、実装完了後の締め作業を実行できる状態まで到達することです。
16
+
17
+ ## 目的
18
+
19
+ - 実装の適用(コード/テスト)を安全な順序で進める
20
+ - `skel/` を先行更新し、`test/skeleton-structure-validation.test.ts` で構造一致を担保する
21
+ - テスト運用ルール(特に `it.each` 禁止)を順守する
22
+ - `docs/` と必要に応じて `docs-ai/e2e-test/` を更新する
23
+ - Git 連携できる場合、PR と Issue に進捗・判断・結果を「頻繁に」コメントして追跡可能性を上げる
24
+ - 冗長コードを見つけたら `@TODO` を付け、後日リファクタリング候補として明示する(ただしスコープ外の大改修はしない)
25
+
26
+ ## 前提条件
27
+
28
+ - 計画が完了している(Issue/planブランチ/Draft PR が存在)
29
+ - 作業ブランチは `plan/{issue_number}` を base にした `agent/*` である
30
+ - プロジェクトのテスト/ビルド/静的解析(該当する場合)が実行可能
31
+ - GitHub 連携(`gh` 認証)は任意だが、可能ならコメント運用を行う
32
+
33
+ ## この prompt がやること / やらないこと
34
+
35
+ ### やること
36
+
37
+ - 計画に従った実装(コード・テスト)の適用
38
+ - `skel/` の先行更新と構造検証
39
+ - docs 更新(必要に応じて `docs-ai/e2e-test/` の手順整備まで)
40
+ - 進捗ログ(`change_plans/`)の更新
41
+ - PR/Issue への進捗コメント(可能な場合)
42
+
43
+ ### やらないこと
44
+
45
+ - Issue 作成・plan ブランチ作成・plan PR 作成(計画段階の領域)
46
+ - 実装完了後の e2e 実行、PR本文の実装完了レポート追記、Checks 登録(実装完了後の締め作業の領域)
47
+
48
+ ## ワークフロー
49
+
50
+ ### Step 1: 現状確認(ブランチ/PR/差分)
51
+
52
+ ```bash
53
+ # 現在のブランチ
54
+ git branch --show-current
55
+
56
+ # PR番号(存在する場合)
57
+ PR_NUMBER=$(gh pr view --json number -q '.number' 2>/dev/null || true)
58
+ echo "PR Number: ${PR_NUMBER}"
59
+
60
+ # 変更ファイル一覧
61
+ git --no-pager diff --name-only origin/main...HEAD
62
+ ```
63
+
64
+ **確認ポイント**:
65
+ - [ ] `agent/*` ブランチで作業している
66
+ - [ ] 変更ファイル一覧が意図どおり
67
+
68
+ ### Step 2: 実装開始ログ(change_plans)を用意
69
+
70
+ この repo では、作業中の計画・進捗は `change_plans/` に置き、完了後は削除します(Git履歴で追跡可能)。
71
+
72
+ ただし計画段階の運用では `todo_plans/${ISSUE_NUMBER}/index.md` が Issue 本文の正本です。
73
+ 本タスクの進捗ログは `change_plans/` に作り、`todo_plans/${ISSUE_NUMBER}/index.md` は「要点の正本」として維持します。
74
+
75
+ ```bash
76
+ DATE=$(date +%Y%m%d)
77
+ ISSUE_NUMBER=$(gh issue view --json number -q '.number' 2>/dev/null || true)
78
+
79
+ # gh が使えない場合は ISSUE_NUMBER を手で埋める
80
+ # ISSUE_NUMBER=123
81
+
82
+ CHANGE_PLAN="change_plans/${DATE}_issue-${ISSUE_NUMBER}_apply-fix.md"
83
+
84
+ if [ ! -f "$CHANGE_PLAN" ]; then
85
+ cat > "$CHANGE_PLAN" <<'EOF'
86
+ # apply-fix 実装ログ
87
+
88
+ ## 進捗
89
+ - [ ] skel更新
90
+ - [ ] 構造検証
91
+ - [ ] 実装
92
+ - [ ] テスト
93
+ - [ ] docs更新
94
+
95
+ ## 判断・メモ
96
+
97
+ ## skel差分(patch)
98
+
99
+ EOF
100
+ fi
101
+
102
+ echo "$CHANGE_PLAN"
103
+ ```
104
+
105
+ ### Step 2.1: 詳細ログ(検証結果/調査/判断根拠)を `todo_plans/${ISSUE_NUMBER}/` に残す
106
+
107
+ - PR/Issue のコメントは「最初に自然文で3行」を必須にする(読む負担を増やさない)。
108
+ - その後の追記は状況に応じてよいが、**原則7行以内**に抑える。
109
+ - コマンド出力や長い実行ログは PR/Issue に貼らず、`todo_plans/${ISSUE_NUMBER}/` 配下にファイルとして残し、コメントから参照する。
110
+ - 実装中に調べた内容や、実装手法の選択根拠(なぜその方針にしたか)も、同様に `todo_plans/${ISSUE_NUMBER}/` 配下に残す。
111
+
112
+ **推奨ファイル(例)**:
113
+ - `todo_plans/${ISSUE_NUMBER}/verification.md`: 実行した確認内容・結果(長くてよい)
114
+ - `todo_plans/${ISSUE_NUMBER}/research.md`: 調査メモ・選択根拠(長くてよい)
115
+
116
+ ### Step 3: skel を先に更新(ロジック修正前)
117
+
118
+ - ロジックの修正・テストの修正に入る前に、`skel/` を更新して「構造設計図」を先に確定します。
119
+ - `skel/` の変更差分は patch 形式で取得し、Step 2 の `change_plans/*` に貼り付けます。
120
+
121
+ ```bash
122
+ # 例: skel差分(patch)を確認して change_plans に貼る
123
+ git --no-pager diff -- skel | cat
124
+ ```
125
+
126
+ ### Step 4: 構造検証テストだけ先に実行
127
+
128
+ この repo では、まず `test/skeleton-structure-validation.test.ts` **だけ**を実行して、構造が一致していることを確認します。
129
+
130
+ ```bash
131
+ # プロジェクトのテストランナーで「構造検証テスト」だけを実行
132
+ <test-command> <structure-validation-test-only>
133
+ ```
134
+
135
+ **参考(このリポジトリの例)**:
136
+
137
+ ```bash
138
+ npm test -- skeleton-structure-validation.test.ts --run
139
+ ```
140
+
141
+ **確認ポイント**:
142
+ - [ ] skel/test と test の describe/it 構造が一致している
143
+ - [ ] skel/src と src の構造が一致している
144
+
145
+ ### Step 5: テスト方針(TDD / 禁止事項 / 停止条件)
146
+
147
+ - 修正対象が特定できたら、まずテストを書く(TDD)。
148
+ - **`it.each` は使用禁止**(skel構造検証ができなくなる)。
149
+ - テストが失敗した場合は、原因と修正方針をまとめ、合意が取れるまで先に進まない。
150
+
151
+ ### Step 6: 実装を適用(最小変更・根本原因)
152
+
153
+ - できるだけ最小の差分で、根本原因に対処する。
154
+ - 既存のAPI/CLI互換性を意識し、破壊的変更がある場合は計画と Issue/PR に明記する。
155
+ - 実装中に冗長なコードを見つけた場合は、今回のスコープ外であれば削らずに `@TODO` を付けて後日対応に回す。
156
+
157
+ ### Step 7: docs 更新(docs/ と docs-ai/e2e-test/)
158
+
159
+ - 変更内容が利用者に影響する場合は `docs/` を更新する。
160
+ - 動作確認の再現手順が必要な場合は `docs-ai/e2e-test/` を追加/更新する。
161
+ - ここでは「手順整備」まで(実行と結果記録は実装完了後の締め作業で行う)。
162
+ - ここでは「手順整備」まで(実行と結果記録は実装完了後の締め作業で行う)。
163
+
164
+ ### Step 8: 最小のローカル検証
165
+
166
+ ```bash
167
+ # 構造検証(再確認)
168
+ <test-command> <structure-validation-test-only>
169
+
170
+ # 可能なら、影響範囲のテストも実行
171
+ <test-command>
172
+
173
+ # 変更がビルド成果物に影響する場合
174
+ <build-command>
175
+ ```
176
+
177
+ **参考(このリポジトリの例)**:
178
+
179
+ ```bash
180
+ npm test -- skeleton-structure-validation.test.ts --run
181
+ npm test
182
+ npm run root:build
183
+ ```
184
+
185
+ ### Step 9: コミット / PR・Issue コメント(頻繁に)
186
+
187
+ - コミットはレビュー可能な粒度で積む(例: `skel` → `test` → `impl` → `docs`)。
188
+ - GitHub 連携できる場合、以下のタイミングで PR と Issue にコメントする:
189
+ - 重要な判断変更(仕様・方針・スコープ)
190
+ - テスト戦略確定、テスト結果
191
+ - ブロッカー発生と解消
192
+ - マイルストーン(skel完了/実装完了/docs完了)
193
+
194
+ #### コメントの定型(先頭3行は自然文)
195
+
196
+ コメントは「最初に自然文で3行」を必須にし、その後の追記は状況に応じて行います(原則7行以内)。
197
+
198
+ 長いコマンドや出力を載せたい場合は、**自然文サマリのみ**をコメントに書き、実行ログや詳細は `todo_plans/${ISSUE_NUMBER}/` 配下に保存して参照します。
199
+
200
+ (例:5行)
201
+
202
+ 1行目: 今回の変更で「何を」したかを書きます。
203
+ 2行目: 現在の進捗と、次にやることを書きます。
204
+ 3行目: 影響範囲・注意点(なければ「影響なし」)を書きます。
205
+ 補足: 検証は○○を実施しました。
206
+ 詳細: todo_plans/${ISSUE_NUMBER}/verification.md / todo_plans/${ISSUE_NUMBER}/research.md
207
+
208
+ ```bash
209
+ # 進捗コメント(PR)
210
+ if [ -n "$PR_NUMBER" ]; then
211
+ gh pr comment "$PR_NUMBER" --body "進捗: [skel/実装/テスト/docs] の状況を更新しました。次は [次の作業] に進みます。"
212
+ fi
213
+
214
+ # 進捗コメント(Issue)
215
+ if [ -n "$ISSUE_NUMBER" ]; then
216
+ gh issue comment "$ISSUE_NUMBER" --body "進捗: [skel/実装/テスト/docs]。変更点/判断: ..."
217
+ fi
218
+ ```
219
+
220
+ ### Step 10: 完了条件(実装完了後の締め作業に引き渡せる状態)
221
+
222
+ - [ ] 変更がコミット済み(作業ブランチに反映されている)
223
+ - [ ] `npm test -- skeleton-structure-validation.test.ts --run` が通る
224
+ - [ ] 必要な `docs/` 更新が完了している
225
+ - [ ] 必要な `docs-ai/e2e-test/` が存在する(影響がある場合)
226
+ - [ ] `change_plans/*` に進捗と skel差分patch が残っている(完了後の削除は、merge/完了確認後に実施)
227
+ - [ ] 必要に応じて `todo_plans/${ISSUE_NUMBER}/verification.md` と `todo_plans/${ISSUE_NUMBER}/research.md` が更新されている
228
+
229
+ ## コマンド一覧(まとめ)
230
+
231
+ ```bash
232
+ # 1) 現状確認
233
+ git branch --show-current
234
+ git --no-pager diff --name-only origin/main...HEAD
235
+
236
+ # 2) skel → 構造検証
237
+ <test-command> <structure-validation-test-only>
238
+
239
+ # 3) テスト/実装/ドキュメント
240
+ <test-command>
241
+ <build-command>
242
+
243
+ # 4) PR/Issue コメント
244
+ gh pr comment <PR_NUMBER> --body "..."
245
+ gh issue comment <ISSUE_NUMBER> --body "..."
246
+ ```
247
+
248
+ **参考(このリポジトリの例)**:
249
+
250
+ ```bash
251
+ npm test -- skeleton-structure-validation.test.ts --run
252
+ npm test
253
+ npm run root:build
254
+ ```
@@ -0,0 +1,438 @@
1
+ ---
2
+ type: prompt
3
+ name: fix-implementation
4
+ category: workflow
5
+ focus: implementation-completion
6
+ description: "実装完了後のワークフローを自動化。e2eテスト実行、PR本文更新、Checksへの登録を効率的に実施。"
7
+ agent: agent
8
+ ---
9
+ # prompt fix-implementation ワークフロー
10
+
11
+ ## 概要
12
+
13
+ 実装が完了したら、この prompt を使用して e2e テストの実行、PR 本文への情報追記、Checks の登録を一括で実施します。実装完了後の定型的な品質保証プロセスを効率化します。
14
+
15
+ ## 目的
16
+
17
+ 実装完了後の以下のタスクを自動化します:
18
+
19
+ - e2e テストの実行と結果確認
20
+ - PR 本文への実装情報の追記
21
+ - e2e テスト実行 Checks の PR への登録
22
+ - 品質保証プロセスの標準化
23
+
24
+ ## 前提条件
25
+
26
+ - 実装が完了している(コードの変更が commit されている)
27
+ - PR が作成されている
28
+ - `docs-ai/e2e-test/` に該当機能の e2e テストドキュメントが存在する
29
+ - gh CLI がインストール・認証されている
30
+
31
+ ## ワークフロー
32
+
33
+ ### Step 1: 現状確認
34
+
35
+ ```bash
36
+ # PR番号を確認
37
+ PR_NUMBER=$(gh pr view --json number -q '.number')
38
+ echo "PR Number: $PR_NUMBER"
39
+
40
+ # 現在のブランチを確認
41
+ git branch --show-current
42
+
43
+ # 実装の変更ファイルを確認
44
+ git --no-pager diff --name-only origin/main...HEAD
45
+ ```
46
+
47
+ **確認ポイント**:
48
+ - [ ] PR が存在し、番号が取得できている
49
+ - [ ] 実装ブランチにいる
50
+ - [ ] 変更ファイル一覧が意図した内容と一致している
51
+
52
+ ### Step 2: 該当する e2e テストドキュメントの特定
53
+
54
+ `docs-ai/e2e-test/` ディレクトリから、実装した機能に関連する e2e テストドキュメントを探します。
55
+
56
+ ```bash
57
+ # e2e テストドキュメント一覧を表示
58
+ ls -la docs-ai/e2e-test/
59
+
60
+ # 関連するドキュメントを確認(例: presets関連の場合)
61
+ cat docs-ai/e2e-test/presets-command-e2e.md
62
+ ```
63
+
64
+ **e2e テストドキュメントの構造**:
65
+ - 各ドキュメントは機能ごとに分かれている
66
+ - `[機能名]-[スコープ]-e2e.md` の命名規則
67
+ - コマンドはコピペでそのまま実行可能
68
+
69
+ ### Step 3: e2e テストの実行
70
+
71
+ 該当する e2e テストドキュメントに記載されたコマンドを順次実行します。
72
+
73
+ ```bash
74
+ # プロジェクトルートに移動
75
+ cd /path/to/project
76
+
77
+ # 依存関係をインストール(必要に応じて)
78
+ npm install
79
+
80
+ # プロジェクトをビルド
81
+ npm run build
82
+
83
+ # e2e テストドキュメントに記載されたコマンドを実行
84
+ # 例: CLIコマンドの動作確認
85
+ ./dist/cli.js [コマンド] [オプション]
86
+
87
+ # 結果を確認(成功の場合 ✓ マーク、失敗の場合 ✗ マーク)
88
+ ```
89
+
90
+ **確認ポイント**:
91
+ - [ ] 全ての e2e テストコマンドが成功している
92
+ - [ ] 期待される出力が得られている
93
+ - [ ] エラーが発生していない
94
+
95
+ ### Step 4: PR 本文への情報追記
96
+
97
+ 実装完了後、PR の本文に以下の情報を **追記** します。
98
+
99
+ **追記する内容**:
100
+ 1. **実装した内容の概要** - 何を実装したか
101
+ 2. **テストや注意事項** - テスト方法や注意すべき点
102
+ 3. **想定される本番影響** - 本番環境への影響評価
103
+
104
+ ```bash
105
+ # 現在のPR本文を取得
106
+ CURRENT_BODY=$(gh pr view --json body -q '.body')
107
+
108
+ # 追記する内容を作成
109
+ APPEND_CONTENT="
110
+
111
+ ---
112
+
113
+ ## 実装完了レポート
114
+
115
+ ### 実装した内容の概要
116
+
117
+ - [実装内容1]
118
+ - [実装内容2]
119
+ - [実装内容3]
120
+
121
+ ### テストや注意事項
122
+
123
+ #### 実行したテスト
124
+ - [ ] ユニットテスト: \`npm test\`
125
+ - [ ] e2e テスト: \`docs-ai/e2e-test/[該当ファイル].md\` の手順を実行
126
+ - [ ] 手動動作確認
127
+
128
+ #### 注意事項
129
+ - [注意事項1]
130
+ - [注意事項2]
131
+
132
+ ### 想定される本番影響
133
+
134
+ #### 影響範囲
135
+ - [影響を受けるモジュール/機能]
136
+
137
+ #### リスク評価
138
+ - **高リスク**: なし
139
+ - **中リスク**: [該当あれば記載]
140
+ - **低リスク**: [該当あれば記載]
141
+
142
+ #### 切り戻し方法
143
+ - [問題発生時の切り戻し手順]
144
+ "
145
+
146
+ # PR本文を更新(既存内容 + 追記内容)
147
+ echo "${CURRENT_BODY}${APPEND_CONTENT}" | gh pr edit --body-file -
148
+ ```
149
+
150
+ **PR本文追記テンプレート(コピペ用)**:
151
+
152
+ ```markdown
153
+ ---
154
+
155
+ ## 実装完了レポート
156
+
157
+ ### 実装した内容の概要
158
+
159
+ - [機能Aの実装]
160
+ - [機能Bの改善]
161
+ - [バグXの修正]
162
+
163
+ ### テストや注意事項
164
+
165
+ #### 実行したテスト
166
+ - [x] ユニットテスト: `npm test` - 全テスト通過
167
+ - [x] e2e テスト: `docs-ai/e2e-test/presets-command-e2e.md` の手順を実行
168
+ - [x] 手動動作確認
169
+
170
+ #### 注意事項
171
+ - 既存の設定ファイルとの互換性を確認してください
172
+ - 環境変数 `XXX` の設定が必要です
173
+
174
+ ### 想定される本番影響
175
+
176
+ #### 影響範囲
177
+ - `packages/core/` - 新機能追加
178
+ - `packages/cli/` - コマンドオプション追加
179
+
180
+ #### リスク評価
181
+ - **高リスク**: なし
182
+ - **中リスク**: なし
183
+ - **低リスク**: CLI出力フォーマットの軽微な変更
184
+
185
+ #### 切り戻し方法
186
+ - このPRをリバートすることで元の状態に戻せます
187
+ ```
188
+
189
+ ### Step 5: e2e テスト実行 Checks の PR 登録
190
+
191
+ e2e テストを実行したことを PR の Checks として登録します。
192
+
193
+ **方法1: GitHub API を使用してチェック実行を作成**
194
+
195
+ ```bash
196
+ # リポジトリ情報を取得
197
+ REPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner')
198
+ COMMIT_SHA=$(git rev-parse HEAD)
199
+
200
+ # Check Run を作成
201
+ gh api \
202
+ --method POST \
203
+ -H "Accept: application/vnd.github+json" \
204
+ -H "X-GitHub-Api-Version: 2022-11-28" \
205
+ /repos/${REPO}/check-runs \
206
+ -f name='E2E Tests' \
207
+ -f head_sha="${COMMIT_SHA}" \
208
+ -f status='completed' \
209
+ -f conclusion='success' \
210
+ -f output='{"title":"E2E Tests Passed","summary":"All e2e tests from docs-ai/e2e-test/ passed successfully."}' \
211
+ -f started_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
212
+ -f completed_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
213
+ ```
214
+
215
+ **方法2: PRにコメントとして e2e テスト結果を記録**
216
+
217
+ ```bash
218
+ # e2e テスト結果をコメントとして追加
219
+ gh pr comment $PR_NUMBER --body "## E2E テスト実行結果
220
+
221
+ **実行日時**: $(date '+%Y-%m-%d %H:%M:%S')
222
+
223
+ ### 実行したテスト
224
+ - ✅ \`docs-ai/e2e-test/[該当ファイル].md\` のコマンドを実行
225
+
226
+ ### 結果サマリ
227
+ - ✅ 全テスト通過
228
+ - 実行環境: [環境情報]
229
+
230
+ ### 実行ログ(抜粋)
231
+ \`\`\`
232
+ [テスト実行ログの抜粋]
233
+ \`\`\`
234
+ "
235
+ ```
236
+
237
+ **確認ポイント**:
238
+ - [ ] Check Run が正常に作成された、またはコメントが追加された
239
+ - [ ] PR の Checks タブに e2e テスト結果が表示されている
240
+
241
+ ### Step 6: 最終確認
242
+
243
+ ```bash
244
+ # PR の状態を確認
245
+ gh pr view --json title,state,body,labels,checks
246
+
247
+ # Checks の状態を確認
248
+ gh pr checks
249
+
250
+ # 変更内容の最終確認
251
+ gh pr diff
252
+ ```
253
+
254
+ **最終確認チェックリスト**:
255
+ - [ ] 全ての e2e テストが成功している
256
+ - [ ] PR 本文に実装情報が追記されている
257
+ - [ ] Checks に e2e テスト結果が登録されている
258
+ - [ ] レビュー依頼の準備が整っている
259
+
260
+ ## コマンド一覧(まとめ)
261
+
262
+ 以下のコマンドを順に実行することで、fix-implementation ワークフローを完了できます。
263
+
264
+ ```bash
265
+ #!/bin/bash
266
+
267
+ # Step 1: 現状確認
268
+ PR_NUMBER=$(gh pr view --json number -q '.number')
269
+ echo "PR Number: $PR_NUMBER"
270
+
271
+ # Step 2: e2e テストドキュメントの確認
272
+ ls docs-ai/e2e-test/
273
+
274
+ # Step 3: e2e テストの実行(該当するドキュメントに従う)
275
+ npm run build
276
+ # [e2e テストコマンドを実行]
277
+
278
+ # Step 4: PR本文への追記
279
+ # (上記のテンプレートを使用してPR本文を更新)
280
+
281
+ # Step 5: Checks の登録
282
+ REPO=$(gh repo view --json nameWithOwner -q '.nameWithOwner')
283
+ COMMIT_SHA=$(git rev-parse HEAD)
284
+
285
+ gh api \
286
+ --method POST \
287
+ -H "Accept: application/vnd.github+json" \
288
+ -H "X-GitHub-Api-Version: 2022-11-28" \
289
+ /repos/${REPO}/check-runs \
290
+ -f name='E2E Tests' \
291
+ -f head_sha="${COMMIT_SHA}" \
292
+ -f status='completed' \
293
+ -f conclusion='success' \
294
+ -f output='{"title":"E2E Tests Passed","summary":"E2E tests completed successfully."}' \
295
+ -f started_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
296
+ -f completed_at="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
297
+
298
+ # Step 6: 最終確認
299
+ gh pr view
300
+ gh pr checks
301
+
302
+ echo "✅ fix-implementation workflow completed!"
303
+ ```
304
+
305
+ ## e2e テストドキュメントの書き方
306
+
307
+ 実装する機能に対応する e2e テストドキュメントが存在しない場合は、新規作成してください。
308
+
309
+ **ファイル命名規則**: `[機能名]-[スコープ]-e2e.md`
310
+
311
+ **必須セクション**:
312
+ 1. **前提条件** - 実行環境、必要なツール
313
+ 2. **全体ビルド・テスト** - プロジェクト全体のビルド・テスト
314
+ 3. **機能固有のテスト** - 対象機能の動作確認
315
+ 4. **エラーケース** - 異常系の確認
316
+ 5. **クリーンアップ** - 一時ファイルの削除等
317
+
318
+ **テンプレート例**:
319
+
320
+ ```markdown
321
+ ---
322
+ feature: [機能名]
323
+ purpose: E2E テストコマンド集
324
+ ---
325
+
326
+ # [機能名] E2E Tests
327
+
328
+ ## 前提条件
329
+
330
+ \`\`\`bash
331
+ cd /path/to/project
332
+ npm install
333
+ npm run build
334
+ \`\`\`
335
+
336
+ ## 基本動作確認
337
+
338
+ ### 正常系
339
+
340
+ \`\`\`bash
341
+ # コマンド実行
342
+ ./dist/cli.js [command] [options]
343
+
344
+ # 期待される出力を確認
345
+ \`\`\`
346
+
347
+ ### エラーケース
348
+
349
+ \`\`\`bash
350
+ # エラーケースの確認
351
+ ./dist/cli.js [invalid-command] 2>&1 || echo "Expected error occurred"
352
+ \`\`\`
353
+
354
+ ## クリーンアップ
355
+
356
+ \`\`\`bash
357
+ # 一時ファイルの削除
358
+ rm -rf /tmp/test-output
359
+ \`\`\`
360
+ ```
361
+
362
+ ## ベストプラクティス
363
+
364
+ ### e2e テスト実行時
365
+
366
+ - **環境の一致**: ローカル環境と CI 環境の差異を考慮
367
+ - **再現性**: 同じコマンドで同じ結果が得られることを確認
368
+ - **ドキュメント更新**: テスト内容が変わったらドキュメントも更新
369
+
370
+ ### PR 本文更新時
371
+
372
+ - **簡潔に**: 重要な情報を簡潔にまとめる
373
+ - **具体的に**: 抽象的な表現を避け、具体的な変更点を記載
374
+ - **リスク明示**: 本番影響を正直に評価
375
+
376
+ ### Checks 登録時
377
+
378
+ - **正確な結果**: テスト結果を正確に報告
379
+ - **失敗時の対応**: テスト失敗時は conclusion を 'failure' に設定
380
+ - **詳細情報**: 必要に応じてログの抜粋を含める
381
+
382
+ ## トラブルシューティング
383
+
384
+ ### e2e テストが失敗する場合
385
+
386
+ **原因**: 環境の違い、依存関係の不整合
387
+
388
+ **解決策**:
389
+ ```bash
390
+ # クリーンビルド
391
+ rm -rf node_modules dist
392
+ npm install
393
+ npm run build
394
+
395
+ # 再度テスト実行
396
+ ```
397
+
398
+ ### Check Run の作成に失敗する場合
399
+
400
+ **原因**: GitHub API の権限不足
401
+
402
+ **解決策**:
403
+ - リポジトリの Settings → Actions → General で権限を確認
404
+ - GitHub App を使用している場合は `checks:write` 権限を付与
405
+ - 代替手段として PR コメントを使用
406
+
407
+ ### PR 本文の更新に失敗する場合
408
+
409
+ **原因**: gh CLI の認証エラー
410
+
411
+ **解決策**:
412
+ ```bash
413
+ # 認証状態を確認
414
+ gh auth status
415
+
416
+ # 再認証
417
+ gh auth login
418
+ ```
419
+
420
+ ## 関連ドキュメント
421
+
422
+ - [plan-fix プロンプト](./plan-fix.prompt.md) - 計画完成後のワークフロー
423
+ - [TODO Plans 作成ルール](./todo_plans.prompt.md) - 計画管理
424
+ - [e2e テストガイドライン](../../../docs-ai/e2e-test/README.md) - e2e テストの書き方
425
+
426
+ ## まとめ
427
+
428
+ prompt fix-implementation ワークフローを使用することで:
429
+
430
+ ✅ **品質保証**: e2e テストによる品質確認
431
+ ✅ **透明性**: PR 本文への詳細な実装情報追記
432
+ ✅ **追跡可能性**: Checks への e2e テスト結果登録
433
+ ✅ **標準化**: 実装完了プロセスの統一
434
+
435
+ ---
436
+
437
+ **作成日**: 2025年1月
438
+ **バージョン**: 1.0.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aramassa/ai-rules",
3
- "version": "0.9.5",
3
+ "version": "0.9.6",
4
4
  "description": "This repository collects guidelines and instructions for developing AI agents. It contains documents covering communication rules, coding standards, testing strategies, and general operational practices.",
5
5
  "workspaces": [
6
6
  "packages/extract",
@@ -0,0 +1,16 @@
1
+ description: 計画済みの修正をrepoルールに沿って適用するワークフロー。skel先行更新、構造検証、テスト運用、docs更新、PR/Issueコメントによる進捗共有を標準化します。
2
+
3
+ config:
4
+ baseDir: .github/prompts
5
+
6
+ recipe:
7
+ - title: "prompt apply-fix ワークフロー"
8
+ out: "apply-fix.prompt.md"
9
+ type: "prompt"
10
+ filters:
11
+ category: "workflow"
12
+ focus: "implementation-application"
13
+ frontmatter:
14
+ description: "計画済みの修正をrepoルールに沿って適用。skel先行更新、構造検証、テスト運用、docs更新、PR/Issueコメントで進捗共有を標準化。"
15
+ agent: "agent"
16
+ applyTo: "**/*"
@@ -0,0 +1,16 @@
1
+ description: 実装完了後のワークフローを自動化。e2eテスト実行、PR本文更新、Checksへの登録を効率的に実施します。
2
+
3
+ config:
4
+ baseDir: .github/prompts
5
+
6
+ recipe:
7
+ - title: "prompt fix-implementation ワークフロー"
8
+ out: "fix-implementation.prompt.md"
9
+ type: "prompt"
10
+ filters:
11
+ category: "workflow"
12
+ focus: "implementation-completion"
13
+ frontmatter:
14
+ description: "実装完了後のワークフローを自動化。e2eテスト実行、PR本文更新、Checksへの登録を効率的に実施。"
15
+ agent: "agent"
16
+ applyTo: "**/*"
@@ -12,4 +12,5 @@ recipe:
12
12
  focus: "plan-to-implementation"
13
13
  frontmatter:
14
14
  description: "VS Code Plan モードから Agent Coding への移行を自動化。計画完成後の Git/GitHub 操作を簡略化し、効率的な開発ワークフローを実現。"
15
+ agent: "agent"
15
16
  applyTo: "**/*"