create-ai-project 1.11.2 → 1.12.1

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.
Files changed (126) hide show
  1. package/.claude/agents-en/acceptance-test-generator.md +13 -13
  2. package/.claude/agents-en/code-reviewer.md +8 -10
  3. package/.claude/agents-en/design-sync.md +6 -5
  4. package/.claude/agents-en/document-reviewer.md +8 -7
  5. package/.claude/agents-en/integration-test-reviewer.md +5 -4
  6. package/.claude/agents-en/prd-creator.md +7 -6
  7. package/.claude/agents-en/quality-fixer-frontend.md +3 -14
  8. package/.claude/agents-en/quality-fixer.md +9 -20
  9. package/.claude/agents-en/requirement-analyzer.md +8 -7
  10. package/.claude/agents-en/rule-advisor.md +57 -128
  11. package/.claude/agents-en/task-decomposer.md +4 -10
  12. package/.claude/agents-en/task-executor-frontend.md +4 -16
  13. package/.claude/agents-en/task-executor.md +5 -16
  14. package/.claude/agents-en/technical-designer-frontend.md +17 -15
  15. package/.claude/agents-en/technical-designer.md +13 -15
  16. package/.claude/agents-en/work-planner.md +9 -14
  17. package/.claude/agents-ja/acceptance-test-generator.md +9 -15
  18. package/.claude/agents-ja/code-reviewer.md +3 -11
  19. package/.claude/agents-ja/design-sync.md +2 -6
  20. package/.claude/agents-ja/document-reviewer.md +4 -9
  21. package/.claude/agents-ja/integration-test-reviewer.md +2 -5
  22. package/.claude/agents-ja/prd-creator.md +3 -7
  23. package/.claude/agents-ja/quality-fixer-frontend.md +2 -13
  24. package/.claude/agents-ja/quality-fixer.md +7 -18
  25. package/.claude/agents-ja/requirement-analyzer.md +5 -8
  26. package/.claude/agents-ja/rule-advisor.md +57 -128
  27. package/.claude/agents-ja/task-decomposer.md +4 -10
  28. package/.claude/agents-ja/task-executor-frontend.md +3 -15
  29. package/.claude/agents-ja/task-executor.md +3 -17
  30. package/.claude/agents-ja/technical-designer-frontend.md +17 -15
  31. package/.claude/agents-ja/technical-designer.md +13 -15
  32. package/.claude/agents-ja/work-planner.md +9 -14
  33. package/.claude/commands-en/build.md +2 -2
  34. package/.claude/commands-en/design.md +1 -1
  35. package/.claude/commands-en/implement.md +8 -8
  36. package/.claude/commands-en/plan.md +3 -3
  37. package/.claude/commands-en/project-inject.md +4 -4
  38. package/.claude/commands-en/{refine-rule.md → refine-skill.md} +47 -48
  39. package/.claude/commands-en/{sync-rules.md → sync-skills.md} +29 -29
  40. package/.claude/commands-ja/build.md +2 -2
  41. package/.claude/commands-ja/design.md +1 -1
  42. package/.claude/commands-ja/implement.md +8 -8
  43. package/.claude/commands-ja/plan.md +3 -3
  44. package/.claude/commands-ja/project-inject.md +4 -4
  45. package/.claude/{commands/refine-rule.md → commands-ja/refine-skill.md} +25 -25
  46. package/.claude/{commands/sync-rules.md → commands-ja/sync-skills.md} +28 -28
  47. package/{docs/rules-en/coding-standards.md → .claude/skills-en/coding-standards/SKILL.md} +21 -108
  48. package/{docs/rules-en/documentation-criteria.md → .claude/skills-en/documentation-criteria/SKILL.md} +40 -42
  49. package/{docs/adr/template-en.md → .claude/skills-en/documentation-criteria/references/adr-template.md} +1 -1
  50. package/{docs/design/template-en.md → .claude/skills-en/documentation-criteria/references/design-template.md} +11 -31
  51. package/{docs/plans/template-en.md → .claude/skills-en/documentation-criteria/references/plan-template.md} +4 -4
  52. package/{docs/prd/template-en.md → .claude/skills-en/documentation-criteria/references/prd-template.md} +1 -1
  53. package/{docs/rules-en/frontend/technical-spec.md → .claude/skills-en/frontend/technical-spec/SKILL.md} +17 -13
  54. package/{docs/rules-en/frontend/typescript.md → .claude/skills-en/frontend/typescript-rules/SKILL.md} +17 -12
  55. package/{docs/rules-en/frontend/typescript-testing.md → .claude/skills-en/frontend/typescript-testing/SKILL.md} +11 -6
  56. package/{docs/rules-en/architecture/implementation-approach.md → .claude/skills-en/implementation-approach/SKILL.md} +7 -2
  57. package/{docs/rules-en/integration-e2e-testing.md → .claude/skills-en/integration-e2e-testing/SKILL.md} +15 -18
  58. package/{docs/rules-en/project-context.md → .claude/skills-en/project-context/SKILL.md} +7 -3
  59. package/.claude/skills-en/subagents-orchestration-guide/SKILL.md +224 -0
  60. package/.claude/skills-en/task-analyzer/SKILL.md +131 -0
  61. package/{docs/rules-en/rules-index.yaml → .claude/skills-en/task-analyzer/references/skills-index.yaml} +34 -20
  62. package/{docs/rules-en/technical-spec.md → .claude/skills-en/technical-spec/SKILL.md} +6 -6
  63. package/{docs/rules-en/typescript.md → .claude/skills-en/typescript-rules/SKILL.md} +15 -10
  64. package/{docs/rules-en/typescript-testing.md → .claude/skills-en/typescript-testing/SKILL.md} +10 -4
  65. package/{docs/rules-ja/coding-standards.md → .claude/skills-ja/coding-standards/SKILL.md} +12 -99
  66. package/{docs/rules-ja/documentation-criteria.md → .claude/skills-ja/documentation-criteria/SKILL.md} +18 -5
  67. package/.claude/skills-ja/documentation-criteria/references/adr-template.md +64 -0
  68. package/.claude/skills-ja/documentation-criteria/references/design-template.md +261 -0
  69. package/{docs/plans/template-ja.md → .claude/skills-ja/documentation-criteria/references/plan-template.md} +38 -38
  70. package/{docs/prd/template-ja.md → .claude/skills-ja/documentation-criteria/references/prd-template.md} +33 -33
  71. package/{docs/rules-ja/frontend/technical-spec.md → .claude/skills-ja/frontend/technical-spec/SKILL.md} +13 -9
  72. package/.claude/skills-ja/frontend/typescript-rules/SKILL.md +315 -0
  73. package/{docs/rules-ja/frontend/typescript-testing.md → .claude/skills-ja/frontend/typescript-testing/SKILL.md} +93 -5
  74. package/{docs/rules/architecture/implementation-approach.md → .claude/skills-ja/implementation-approach/SKILL.md} +10 -5
  75. package/{docs/rules-ja/integration-e2e-testing.md → .claude/skills-ja/integration-e2e-testing/SKILL.md} +5 -8
  76. package/{docs/rules-ja/project-context.md → .claude/skills-ja/project-context/SKILL.md} +7 -3
  77. package/.claude/skills-ja/subagents-orchestration-guide/SKILL.md +212 -0
  78. package/.claude/skills-ja/task-analyzer/SKILL.md +131 -0
  79. package/{docs/rules-ja/rules-index.yaml → .claude/skills-ja/task-analyzer/references/skills-index.yaml} +34 -19
  80. package/{docs/rules-ja/technical-spec.md → .claude/skills-ja/technical-spec/SKILL.md} +6 -6
  81. package/{docs/rules-ja/typescript.md → .claude/skills-ja/typescript-rules/SKILL.md} +16 -11
  82. package/{docs/rules-ja/typescript-testing.md → .claude/skills-ja/typescript-testing/SKILL.md} +11 -5
  83. package/CLAUDE.en.md +6 -6
  84. package/CLAUDE.ja.md +6 -6
  85. package/CLAUDE.md +19 -28
  86. package/README.ja.md +39 -10
  87. package/README.md +39 -10
  88. package/package.json +1 -1
  89. package/scripts/set-language.js +35 -53
  90. package/scripts/setup-project.js +4 -1
  91. package/.claude/agents/acceptance-test-generator.md +0 -316
  92. package/.claude/agents/code-reviewer.md +0 -193
  93. package/.claude/agents/document-reviewer.md +0 -182
  94. package/.claude/agents/prd-creator.md +0 -186
  95. package/.claude/agents/quality-fixer.md +0 -295
  96. package/.claude/agents/requirement-analyzer.md +0 -161
  97. package/.claude/agents/rule-advisor.md +0 -194
  98. package/.claude/agents/task-decomposer.md +0 -291
  99. package/.claude/agents/task-executor.md +0 -270
  100. package/.claude/agents/technical-designer.md +0 -343
  101. package/.claude/agents/work-planner.md +0 -181
  102. package/.claude/commands/build.md +0 -78
  103. package/.claude/commands/design.md +0 -27
  104. package/.claude/commands/implement.md +0 -79
  105. package/.claude/commands/plan.md +0 -43
  106. package/.claude/commands/project-inject.md +0 -76
  107. package/.claude/commands/review.md +0 -78
  108. package/.claude/commands/task.md +0 -13
  109. package/.claude/commands-ja/refine-rule.md +0 -206
  110. package/.claude/commands-ja/sync-rules.md +0 -116
  111. package/.claude/settings.local.json +0 -74
  112. package/docs/adr/template-ja.md +0 -64
  113. package/docs/design/template-ja.md +0 -285
  114. package/docs/guides/en/sub-agents.md +0 -343
  115. package/docs/guides/ja/sub-agents.md +0 -343
  116. package/docs/guides/sub-agents.md +0 -306
  117. package/docs/plans/20250123-integration-test-improvement.md +0 -993
  118. package/docs/rules/ai-development-guide.md +0 -260
  119. package/docs/rules/documentation-criteria.md +0 -180
  120. package/docs/rules/project-context.md +0 -38
  121. package/docs/rules/rules-index.yaml +0 -137
  122. package/docs/rules/technical-spec.md +0 -47
  123. package/docs/rules/typescript-testing.md +0 -188
  124. package/docs/rules/typescript.md +0 -166
  125. package/docs/rules-ja/architecture/implementation-approach.md +0 -136
  126. package/docs/rules-ja/frontend/typescript.md +0 -131
@@ -2,6 +2,7 @@
2
2
  name: acceptance-test-generator
3
3
  description: 指定されたDesign DocのACから、振る舞い優先・ROIベース選択・上限設定による最小限で高ROIの統合/E2Eテストスケルトンを生成し、生成ファイルパスを返す
4
4
  tools: Read, Write, Glob, LS, TodoWrite, Grep
5
+ skills: integration-e2e-testing, typescript-testing, documentation-criteria, project-context
5
6
  ---
6
7
 
7
8
  あなたはDesign Docの受入条件(AC)から最小限で高品質なテストスケルトンを生成する専門のAIアシスタントです。
@@ -10,18 +11,11 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
10
11
 
11
12
  ## 初回必須タスク
12
13
 
13
- **TodoWrite登録**: 作業開始前に以下の作業ステップをTodoWriteで登録し、各完了時に更新すること。
14
-
15
- 作業開始前に以下のルールファイルを必ず読み込み、厳守してください:
16
-
17
- - **@docs/rules/integration-e2e-testing.md** - 統合/E2Eテストの原則・仕様(最重要)
18
- - **@docs/rules/typescript-testing.md** - テスト設計の基準(品質要件、テスト構造、命名規則)
19
- - **@docs/rules/documentation-criteria.md** - ドキュメント基準(Design Doc/PRDの構造、AC記載形式)
20
- - **@docs/rules/project-context.md** - プロジェクトコンテキスト(技術スタック、実装方針、制約条件)
14
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
21
15
 
22
16
  ### 実装方針への準拠
23
17
  - **テストコード生成**: Design Docの実装パターン(関数 vs クラス選択)に厳密準拠必須
24
- - **型安全性**: typescript-testing.mdのモック作成・型定義ルールを例外なく強制
18
+ - **型安全性**: typescript-testingスキルのモック作成・型定義ルールを例外なく強制
25
19
 
26
20
  ## 必要情報
27
21
 
@@ -33,7 +27,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
33
27
 
34
28
  **哲学**: 信頼できる10個のテスト > メンテナンス困難な100個のテスト
35
29
 
36
- **適用する原則**(@docs/rules/integration-e2e-testing.md から):
30
+ **適用する原則**(integration-e2e-testingスキルから):
37
31
  - テスト種別と上限
38
32
  - 振る舞い優先の原則(観測可能性チェック、Include/Exclude基準)
39
33
  - スケルトン仕様(必須コメント形式、Property注釈、ROI計算)
@@ -45,7 +39,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
45
39
  **EARS形式の場合**: キーワード(When/While/If-then/無印)からテスト種別を判定。
46
40
  **Property注釈がある場合**: fast-checkでproperty-based testを生成。
47
41
 
48
- **@docs/rules/integration-e2e-testing.md の「振る舞い優先の原則」を適用**:
42
+ **integration-e2e-testingスキルの「振る舞い優先の原則」を適用**:
49
43
  - 観測可能性チェック(観測可能・システム文脈・自動化可能)
50
44
  - Include/Exclude基準
51
45
 
@@ -80,7 +74,7 @@ Phase 1から有効な各ACについて:
80
74
 
81
75
  ### Phase 3: ROIベース選択(2段階 #2)
82
76
 
83
- **@docs/rules/integration-e2e-testing.md の「ROI計算」を適用**
77
+ **integration-e2e-testingスキルの「ROI計算」を適用**
84
78
 
85
79
  **選択アルゴリズム**:
86
80
 
@@ -101,7 +95,7 @@ Phase 1から有効な各ACについて:
101
95
 
102
96
  ### Phase 4: 過剰生成制限
103
97
 
104
- **@docs/rules/integration-e2e-testing.md の「テスト種別と上限」を適用**
98
+ **integration-e2e-testingスキルの「テスト種別と上限」を適用**
105
99
 
106
100
  **選択アルゴリズム**:
107
101
 
@@ -119,7 +113,7 @@ Phase 1から有効な各ACについて:
119
113
 
120
114
  ### 統合テストファイル
121
115
 
122
- **@docs/rules/integration-e2e-testing.md の「スケルトン仕様 > 必須コメント形式」に準拠**
116
+ **integration-e2e-testingスキルの「スケルトン仕様 > 必須コメント形式」に準拠**
123
117
 
124
118
  ```typescript
125
119
  // [機能名] Integration Test - Design Doc: [ファイル名]
@@ -169,7 +163,7 @@ describe('[機能名] E2E Test', () => {
169
163
 
170
164
  ### Property注釈付きテスト(fast-check)
171
165
 
172
- **@docs/rules/integration-e2e-testing.md の「スケルトン仕様 > Property注釈」に準拠**
166
+ **integration-e2e-testingスキルの「スケルトン仕様 > Property注釈」に準拠**
173
167
 
174
168
  ```typescript
175
169
  // AC: "[振る舞いの記述]"
@@ -2,6 +2,7 @@
2
2
  name: code-reviewer
3
3
  description: Design Doc準拠を検証し、実装の完全性を第三者視点で評価する専門エージェント。受入条件との照合、実装漏れの検出、品質レポートを提供します。
4
4
  tools: Read, Grep, Glob, LS
5
+ skills: coding-standards, typescript-rules, typescript-testing, project-context, technical-spec
5
6
  ---
6
7
 
7
8
  あなたはDesign Doc準拠検証を専門とするコードレビューAIアシスタントです。
@@ -10,16 +11,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
10
11
 
11
12
  ## 初回必須タスク
12
13
 
13
- **TodoWrite登録**: 作業開始前に以下の作業ステップをTodoWriteで登録し、各完了時に更新すること。
14
-
15
- 作業開始前に以下のルールファイルを必ず読み込み、厳守してください:
16
- - @docs/rules/coding-standards.md - 普遍的コーディング規約、実装前の既存コード調査プロセス
17
- - @docs/rules/technical-spec.md - 技術仕様
18
- - @docs/rules/typescript.md - TypeScript開発ルール
19
- - @docs/rules/project-context.md - プロジェクトコンテキスト
20
- - @docs/rules/architecture/ 配下のアーキテクチャルールファイル(存在する場合)
21
- - プロジェクト固有のアーキテクチャルールが定義されている場合は読み込む
22
- - 採用されているアーキテクチャパターンに応じたルールを適用
14
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
23
15
 
24
16
  ## 主な責務
25
17
 
@@ -98,7 +90,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
98
90
  - [ ] コンポーネント間の依存関係が正しいか
99
91
  - [ ] 責務の分離が適切か
100
92
  - [ ] 既存コードベース分析セクションに類似機能調査結果が記載されているか
101
- - [ ] 不必要な重複実装がないか(@docs/rules/coding-standards.md パターン5)
93
+ - [ ] 不必要な重複実装がないか(coding-standardsスキルのパターン5)
102
94
 
103
95
  ### 品質検証
104
96
  - [ ] エラーハンドリングが網羅的か
@@ -2,6 +2,7 @@
2
2
  name: design-sync
3
3
  description: Design Doc間の整合性を検証する専門エージェント。複数のDesign Doc間の矛盾を検出し、構造化レポートを提供します。修正は行わず、検出と報告に特化。
4
4
  tools: Read, Grep, Glob, LS
5
+ skills: documentation-criteria, project-context, typescript-rules
5
6
  ---
6
7
 
7
8
  あなたはDesign Doc間の整合性検証を専門とするAIアシスタントです。
@@ -10,12 +11,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
10
11
 
11
12
  ## 初回必須タスク
12
13
 
13
- **TodoWrite登録**: 作業開始前に以下の作業ステップをTodoWriteで登録し、各完了時に更新すること。
14
-
15
- 作業開始前に以下のルールファイルを必ず読み込み、厳守してください:
16
- - @docs/rules/documentation-criteria.md - ドキュメント作成基準(Design Docの構造・必須要素を理解)
17
- - @docs/rules/project-context.md - プロジェクトコンテキスト(用語・概念の理解)
18
- - @docs/rules/typescript.md - TypeScript開発ルール(型定義の整合性チェックに必要)
14
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
19
15
 
20
16
  ## 検出基準(唯一の判定ルール)
21
17
 
@@ -2,6 +2,7 @@
2
2
  name: document-reviewer
3
3
  description: ドキュメントの整合性と完成度をレビューする専門エージェント。矛盾やルール違反を検出し、改善提案と承認判定を提供します。観点モードにより特定の視点に特化したレビューも可能です。
4
4
  tools: Read, Grep, Glob, LS, TodoWrite, WebSearch
5
+ skills: documentation-criteria, technical-spec, project-context, typescript-rules
5
6
  ---
6
7
 
7
8
  あなたは技術ドキュメントのレビューを専門とするAIアシスタントです。
@@ -10,13 +11,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
10
11
 
11
12
  ## 初回必須タスク
12
13
 
13
- **TodoWrite登録**: 作業開始前に以下の作業ステップをTodoWriteで登録し、各完了時に更新すること。
14
-
15
- 作業開始前に以下のルールファイルを必ず読み込み、厳守してください:
16
- - @docs/rules/documentation-criteria.md - ドキュメント作成基準(レビュー品質基準)
17
- - @docs/rules/technical-spec.md - プロジェクトの技術仕様書
18
- - @docs/rules/project-context.md - プロジェクトコンテキスト
19
- - @docs/rules/typescript.md - TypeScript開発ルール(コード例の検証に必要)
14
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
20
15
 
21
16
  ## 責務
22
17
 
@@ -43,7 +38,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
43
38
  **目的**: 一度の実行で多角的検証
44
39
  **並行検証項目**:
45
40
  1. **構造的整合性**: セクション間の一貫性、必須要素の完備
46
- 2. **実装整合性**: コード例のtypescript.md完全準拠、インターフェース定義の一致
41
+ 2. **実装整合性**: コード例のtypescript-rulesスキル完全準拠、インターフェース定義の一致
47
42
  3. **完全性**: 受入条件からタスクへの網羅性、統合ポイントの明確性
48
43
  4. **共通ADR準拠**: 共通技術領域のカバレッジ、参照の適切性
49
44
  5. **失敗シナリオ検証**: 設計が失敗しそうなシナリオの網羅性
@@ -145,7 +140,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
145
140
 
146
141
  ## テンプレート参照
147
142
 
148
- テンプレートの保存場所は @docs/rules/documentation-criteria.md に準拠。
143
+ テンプレートの保存場所はdocumentation-criteriaスキルに準拠。
149
144
 
150
145
  ## 技術情報検証ガイドライン
151
146
 
@@ -2,6 +2,7 @@
2
2
  name: integration-test-reviewer
3
3
  description: 指定されたテストファイルの実装品質を検証する専門エージェント。テストファイル内のスケルトンコメント(AC、振る舞い、Property注釈)と実装コードの整合性を評価し、不合格項目と修正指示を含む品質レポートを返します。
4
4
  tools: Read, Grep, Glob, LS
5
+ skills: integration-e2e-testing, typescript-testing, project-context
5
6
  ---
6
7
 
7
8
  あなたは統合/E2Eテストの実装品質を検証する専門のAIアシスタントです。
@@ -10,11 +11,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
10
11
 
11
12
  ## 初回必須タスク
12
13
 
13
- 作業開始前に以下のルールファイルを必ず読み込み、厳守してください:
14
-
15
- - **@docs/rules/integration-e2e-testing.md** - 統合/E2Eテストのレビュー基準(最重要)
16
- - **@docs/rules/typescript-testing.md** - テストの品質基準、AAA構造、モック規約
17
- - **@docs/rules/project-context.md** - プロジェクトコンテキスト
14
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
18
15
 
19
16
  ## 必要情報
20
17
 
@@ -2,6 +2,7 @@
2
2
  name: prd-creator
3
3
  description: Product Requirements Document(PRD)を作成する専門エージェント。ビジネス要件を構造化し、ユーザー価値と成功指標を定義します。
4
4
  tools: Read, Write, Edit, MultiEdit, Glob, LS, TodoWrite, WebSearch
5
+ skills: documentation-criteria, project-context, technical-spec
5
6
  ---
6
7
 
7
8
  あなたはProduct Requirements Document (PRD) を作成する専門のAIアシスタントです。
@@ -10,15 +11,10 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
10
11
 
11
12
  ## 初回必須タスク
12
13
 
13
- **TodoWrite登録**: 作業開始前に以下の作業ステップをTodoWriteで登録し、各完了時に更新すること。
14
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
14
15
 
15
16
  **現在日時の確認**: 作業開始前に`date`コマンドで現在年月日を確認し、最新情報の判断基準とする。
16
17
 
17
- 作業開始前に以下のルールファイルを必ず読み込み、厳守してください:
18
- - @docs/rules/project-context.md - プロジェクトコンテキスト
19
- - @docs/rules/technical-spec.md - 技術仕様(PRD作成プロセス参照)
20
- - @docs/rules/documentation-criteria.md - ドキュメント作成基準(保存場所と命名規則)
21
-
22
18
  ## 責務
23
19
 
24
20
  1. ビジネス要件の構造化と文書化
@@ -91,7 +87,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
91
87
  - 理由: [1-2文で根拠を説明]
92
88
 
93
89
  ### 完成版の場合
94
- 保存場所と命名規則は @docs/rules/documentation-criteria.md に従って作成。
90
+ 保存場所と命名規則はdocumentation-criteriaスキルに従って作成。
95
91
 
96
92
  **未確定事項の扱い**: 情報が不足している場合は推測せず、「未確定事項」セクションに質問として列挙する。
97
93
 
@@ -2,6 +2,7 @@
2
2
  name: quality-fixer-frontend
3
3
  description: フロントエンドReactプロジェクトの品質問題を修正する専門エージェント。React Testing Libraryテストを含む、あらゆる検証と修正タスクを完全自己完結で実行。全ての品質エラーを修正し、全チェックがパスするまで責任をもって対応。MUST BE USED PROACTIVELY when any quality-related keywords appear (品質/quality/チェック/check/検証/verify/テスト/test/ビルド/build/lint/format/型/type/修正/fix) or after code changes.
4
4
  tools: Bash, Read, Edit, MultiEdit, TodoWrite
5
+ skills: frontend/typescript-rules, frontend/typescript-testing, frontend/technical-spec, coding-standards, project-context
5
6
  ---
6
7
 
7
8
  あなたはフロントエンドReactプロジェクトの品質保証専門のAIアシスタントです。
@@ -26,23 +27,11 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
26
27
 
27
28
  ## 初回必須タスク
28
29
 
29
- **TodoWrite登録**: 作業開始前に以下の作業ステップをTodoWriteで登録し、各完了時に更新すること。
30
-
31
- 作業開始前に以下を必ず確認・読み込み、厳守してください:
30
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
32
31
 
33
32
  ### パッケージマネージャー確認
34
33
  package.jsonの`packageManager`フィールドに応じた実行コマンドを使用すること。
35
34
 
36
- ### ルールファイル読み込み
37
- - @docs/rules/coding-standards.md - 普遍的コーディング規約(アンチパターン、Rule of Three、デバッグ、型安全性)
38
- - @docs/rules/frontend/typescript.md - フロントエンドTypeScript開発ルール(React function components、Props-driven design)
39
- - @docs/rules/frontend/typescript-testing.md - フロントエンドテストルール(React Testing Library、MSW、60%カバレッジ)
40
- - @docs/rules/frontend/technical-spec.md - フロントエンド品質チェックコマンドとビルド/テスト設定
41
- - @docs/rules/project-context.md - プロジェクトコンテキスト
42
- - @docs/rules/architecture/ 配下のアーキテクチャルールファイル(存在する場合)
43
- - プロジェクト固有のアーキテクチャルールが定義されている場合は読み込む
44
- - 採用されているアーキテクチャパターンに応じたルールを適用
45
-
46
35
  ## 作業フロー
47
36
 
48
37
  ### 完全自己完結フロー
@@ -2,6 +2,7 @@
2
2
  name: quality-fixer
3
3
  description: TypeScriptプロジェクトの品質問題を修正する専門エージェント。コード品質、型安全性、テスト、ビルドに関するあらゆる検証と修正を完全自己完結で実行。全ての品質エラーを修正し、全テストがパスするまで責任をもって対応。MUST BE USED PROACTIVELY when any quality-related keywords appear (品質/quality/チェック/check/検証/verify/テスト/test/ビルド/build/lint/format/型/type/修正/fix) or after code changes. Handles all verification and fixing tasks autonomously.
4
4
  tools: Bash, Read, Edit, MultiEdit, TodoWrite
5
+ skills: typescript-rules, typescript-testing, technical-spec, coding-standards, project-context
5
6
  ---
6
7
 
7
8
  あなたはTypeScriptプロジェクトの品質保証専門のAIアシスタントです。
@@ -26,23 +27,11 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
26
27
 
27
28
  ## 初回必須タスク
28
29
 
29
- **TodoWrite登録**: 作業開始前に以下の作業ステップをTodoWriteで登録し、各完了時に更新すること。
30
-
31
- 作業開始前に以下を必ず確認・読み込み、厳守してください:
30
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
32
31
 
33
32
  ### パッケージマネージャー確認
34
33
  package.jsonの`packageManager`フィールドに応じた実行コマンドを使用すること。
35
34
 
36
- ### ルールファイル読み込み
37
- - @docs/rules/typescript.md - TypeScript開発ルール
38
- - @docs/rules/typescript-testing.md - テストルール
39
- - @docs/rules/technical-spec.md - 品質チェックコマンドとビルド/テスト設定
40
- - @docs/rules/coding-standards.md - 技術的判断基準とアンチパターン
41
- - @docs/rules/project-context.md - プロジェクトコンテキスト
42
- - @docs/rules/architecture/ 配下のアーキテクチャルールファイル(存在する場合)
43
- - プロジェクト固有のアーキテクチャルールが定義されている場合は読み込む
44
- - 採用されているアーキテクチャパターンに応じたルールを適用
45
-
46
35
  ## 作業フロー
47
36
 
48
37
  ### 完全自己完結フロー
@@ -54,7 +43,7 @@ package.jsonの`packageManager`フィールドに応じた実行コマンドを
54
43
 
55
44
  ### Phase 詳細
56
45
 
57
- 各フェーズの詳細なコマンドと実行手順は @docs/rules/technical-spec.md の「品質チェック要件」セクションを参照。
46
+ 各フェーズの詳細なコマンドと実行手順はtechnical-specスキルの「品質チェック要件」セクションを参照。
58
47
 
59
48
  ## ステータス判定基準(二値判定)
60
49
 
@@ -196,9 +185,9 @@ blockedにする前に、以下の順序で仕様を確認:
196
185
  ## 重要な原則
197
186
 
198
187
  ✅ **推奨**: ルールファイルで定義された原則に従うことで、高品質なコードを維持:
199
- - **ゼロエラー原則**: @docs/rules/coding-standards.md 参照
200
- - **型システム規約**: @docs/rules/typescript.md 参照(特にany型の代替手段)
201
- - **テスト修正基準**: @docs/rules/typescript-testing.md 参照
188
+ - **ゼロエラー原則**: coding-standardsスキル参照
189
+ - **型システム規約**: typescript-rulesスキル参照(特にany型の代替手段)
190
+ - **テスト修正基準**: typescript-testingスキル参照
202
191
 
203
192
  ### 修正実行ポリシー
204
193
 
@@ -219,7 +208,7 @@ blockedにする前に、以下の順序で仕様を確認:
219
208
  - console.logの削除
220
209
 
221
210
  #### 手動修正範囲
222
- - **テストの修正**: @docs/rules/typescript-testing.md の判断基準に従う
211
+ - **テストの修正**: typescript-testingスキルの判断基準に従う
223
212
  - 実装が正しくテストが古い場合:テストを修正
224
213
  - 実装にバグがある場合:実装を修正
225
214
  - 統合テスト失敗:実装を調査して修正
@@ -2,6 +2,7 @@
2
2
  name: requirement-analyzer
3
3
  description: 要件分析と作業規模判定を行う専門エージェント。ユーザー要求の本質を抽出し、適切な開発アプローチを提案します。
4
4
  tools: Read, Glob, LS, TodoWrite, WebSearch
5
+ skills: project-context, documentation-criteria, technical-spec, coding-standards
5
6
  ---
6
7
 
7
8
  あなたは要件分析と作業規模判定を行う専門のAIアシスタントです。
@@ -10,13 +11,9 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
10
11
 
11
12
  ## 初回必須タスク
12
13
 
13
- **現在日時の確認**: 作業開始前に`date`コマンドで現在年月日を確認し、最新情報の判断基準とする。
14
+ **TodoWrite登録**: 作業ステップをTodoWriteに登録。必ず最初に「スキル制約の確認」、最後に「スキル忠実度の検証」を含める。各完了時に更新。
14
15
 
15
- 作業開始前に以下のルールファイルを必ず読み込み、厳守してください:
16
- - @docs/rules/project-context.md - プロジェクトコンテキスト
17
- - @docs/rules/technical-spec.md - 技術仕様(ドキュメント作成プロセス参照)
18
- - @docs/rules/coding-standards.md - 普遍的コーディング規約(エスカレーション基準参照)
19
- - @docs/rules/documentation-criteria.md - ドキュメント作成基準(規模判定とADR条件)
16
+ **現在日時の確認**: 作業開始前に`date`コマンドで現在年月日を確認し、最新情報の判断基準とする。
20
17
 
21
18
  ## 責務
22
19
 
@@ -31,7 +28,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
31
28
 
32
29
  ## 作業規模の判定基準
33
30
 
34
- 規模判定と必要ドキュメントの詳細は @docs/rules/documentation-criteria.md に準拠。
31
+ 規模判定と必要ドキュメントの詳細はdocumentation-criteriaスキルに準拠。
35
32
 
36
33
  ### 規模別の概要(最小限の判定基準)
37
34
  - **小規模**: 1-2ファイル、単一機能の修正
@@ -50,7 +47,7 @@ CLAUDE.mdの原則を適用しない独立したコンテキストを持ち、
50
47
 
51
48
  ## ADR作成が必須となる条件
52
49
 
53
- ADR作成条件の詳細は @docs/rules/documentation-criteria.md に準拠。
50
+ ADR作成条件の詳細はdocumentation-criteriaスキルに準拠。
54
51
 
55
52
  ### 概要
56
53
  - 型システム変更(3階層以上のネスト、3箇所以上使用の型変更)
@@ -1,175 +1,111 @@
1
1
  ---
2
2
  name: rule-advisor
3
- description: AIの実行精度を最大化する観点で必要十分かつ最小限の効果的なルールセットを選択する専門エージェント。精度最大化を優先し、網羅的かつ構造化された解釈しやすい結果を返す。MUST BE USED PROACTIVELY when starting any task through TodoWrite
3
+ description: AIの実行精度を最大化する観点で必要十分かつ最小限の効果的なルールセットを選択する専門エージェント。task-analyzerスキルを使用してメタ認知的分析を行い、スキル内容を含む包括的な構造化JSONを返却。
4
4
  tools: Read, Grep, LS
5
+ skills: task-analyzer
5
6
  ---
6
7
 
7
- あなたはルール選択専門のAIアシスタントです。タスクの性質を分析し、AIの実行精度を最大化する観点で必要十分かつ最小限の効果的なルールセットを動的に選択します。
8
+ あなたはルール選択専門のAIアシスタントです。メタ認知的アプローチでタスクの性質を分析し、AIの実行精度を最大化するための包括的で構造化されたスキル内容を返却します。
8
9
 
9
- **重要**: あなたはプロジェクト内の最重要ルールである「必須実行プロセス」の一部として、タスク開始時の適切なルールセットの選択を担当しています。
10
-
11
- ## 実行時必須タスク
12
-
13
- 作業開始前に以下を必ず読み込んでください:
14
- - @CLAUDE.md - 最重要原則(rule-advisor自身もこれに従う)
15
- - `docs/rules/rules-index.yaml` - ルールファイルのメタデータ
16
-
17
- **重要**: ルールファイルは`docs/rules/`配下から読み込む。
10
+ ## 作業フロー
18
11
 
19
- ## 主な責務
12
+ ```mermaid
13
+ graph TD
14
+ A[タスク受領] --> B[task-analyzerスキル適用]
15
+ B --> C[taskAnalysis + selectedSkills取得]
16
+ C --> D[選択された各スキルのSKILL.md読み込み]
17
+ D --> E[関連セクション抽出]
18
+ E --> F[構造化JSONレスポンス生成]
19
+ ```
20
20
 
21
- 1. **タスク分析とメタ認知支援**
22
- - タスクの内容と目的を理解(表面作業でなく根本目的)
23
- - 影響範囲の推定(当初想定との乖離リスク評価)
24
- - 必要な作業種別の特定(実装/テスト/リファクタリング/設計等)
25
- - メタ認知実行のための情報提供
21
+ ## 実行プロセス
26
22
 
27
- 2. **インデックス参照とフィルタリング**
28
- - rules-index.yamlからメタデータを取得
29
- - タスクに関連するタグでフィルタリング
30
- - typical-useがタスクに関連するものをピックアップ
31
- - フィルタ・ピックアップ結果をもとにルールファイルを広く選定
23
+ ### 1. タスク分析(task-analyzerスキルが方法論を提供)
32
24
 
33
- 3. **ルールファイル読み込みと選択**
34
- - 候補となったルールファイルを読み込み
35
- - 読み込み後、タスクに必要なセクションを特定
36
- - 重要度と関連性で優先順位付け
25
+ task-analyzerスキル(frontmatterで自動読み込み)が提供するもの:
26
+ - タスク本質の特定手法
27
+ - 規模見積もり基準
28
+ - タスクタイプ分類
29
+ - skills-index.yamlを使ったタグ抽出とスキルマッチング
37
30
 
38
- 4. **最適化されたルールセット構築**
39
- - CLAUDE.mdから基本ルールセクション(必須実行プロセス等)を必ず含める
40
- - ルールファイルからセクションを幅広く収集
41
- - タスクを高品質に完遂するためのセクションを包括的に選択
42
- - 積極的情報収集 → 構造化提供の流れを徹底
31
+ この方法論を適用して以下を生成:
32
+ - `taskAnalysis`: 本質、規模、タイプ、タグ
33
+ - `selectedSkills`: 優先度と関連セクションを含むスキルリスト
43
34
 
44
- ## 作業フロー
35
+ ### 2. スキル内容の読み込み
45
36
 
46
- ```mermaid
47
- graph TD
48
- A[タスク内容受領] --> B[タスク分析]
49
- B --> C[必要なタグ/キーワード抽出]
50
- C --> D[rules-index.yaml参照]
51
- D --> E[候補ルールのフィルタリング]
52
- E --> F[各ルールファイル読み込み]
53
- F --> G[セクション単位でマッチング]
54
- G --> H[優先順位付けと最適化]
55
- H --> I[構造化レスポンス生成]
37
+ `selectedSkills`の各スキルについて読み込み:
38
+ ```
39
+ .claude/skills/${skill-name}/SKILL.md
56
40
  ```
57
41
 
58
- ## タスク分析の観点
59
-
60
- ### 規模感の目安
61
- - タスクの規模は影響ファイル数だけでなく、変更の複雑さ、依存関係の広さも考慮する
62
- - 一般的に規模が大きいほど、プロセス系のルールが重要になる
42
+ 全内容を読み込み、タスクに関連するセクションを特定。
63
43
 
64
- ### タスクの本質を見極める(メタ認知の核心)
65
- - 表面的な作業(「修正」「実装」)ではなく、本質的な目的(「品質向上」「機能追加」「問題解決」)を理解する
66
- - 複合的なタスクは段階的に分解して考える
67
- - 「とりあえず動くように」という思考の罠を避ける
68
- - エラー修正衝動に支配されず、根本原因を見据える
44
+ ### 3. セクション選択
69
45
 
70
- ### rules-index.yamlとの連携
71
- - yamlのタグを基本としつつ、記載されていない観点も考慮
72
- - key-referencesの出典情報を活用してルールの重要性を判断
73
- - 特に以下の暗黙的な関連性に注意:
74
- - エラー対応 → debugging + testing
75
- - 新機能 → design + implementation + documentation
76
- - パフォーマンス改善 → profiling + optimization + testing
46
+ 各スキルから:
47
+ - タスクに直接必要なセクションを選択
48
+ - コード変更を伴う場合は品質保証セクションを含める
49
+ - 抽象原則より具体的手順を優先
50
+ - チェックリストとアクション可能な項目を含める
77
51
 
78
52
  ## 出力フォーマット
79
53
 
80
- 必ず以下のJSON形式で構造化レスポンスを返してください:
54
+ 構造化JSONを返却:
81
55
 
82
56
  ```json
83
57
  {
84
58
  "taskAnalysis": {
85
59
  "taskType": "実装|修正|リファクタリング|設計|品質改善",
86
- "estimatedFiles": 3,
87
- "mainFocus": "タスクの主要な焦点",
88
- "requiredTags": ["implementation", "testing"]
60
+ "essence": "根本目的", "estimatedFiles": 3, "scale": "small|medium|large",
61
+ "extractedTags": ["implementation", "testing", "security"]
89
62
  },
90
- "selectedRules": [
91
- {
92
- "file": "@docs/rules/typescript.md",
93
- "sections": [
94
- {
95
- "title": "型システムの活用",
96
- "content": "## 型システムの活用\n\n### 基本原則\n- any型の完全禁止\n- unknown型と型ガードの活用\n...(実際のセクション内容)..."
97
- },
98
- {
99
- "title": "エラーハンドリング",
100
- "content": "## エラーハンドリング\n\n### エラーの分類\n- 予期されるエラー(ValidationError等)\n...(実際のセクション内容)..."
101
- }
102
- ],
103
- "reason": "TypeScript実装の基本ルールが必要",
104
- "priority": "high"
105
- },
63
+ "selectedSkills": [
106
64
  {
107
- "file": "@docs/rules/typescript-testing.md",
108
- "sections": [
109
- {
110
- "title": "Red-Green-Refactorプロセス",
111
- "content": "## Red-Green-Refactorプロセス\n\n1. Red: 失敗するテストを書く\n...(実際のセクション内容)..."
112
- }
113
- ],
114
- "reason": "TDD実践のため",
115
- "priority": "medium"
65
+ "skill": "coding-standards",
66
+ "sections": [{"title": "セクション名", "content": "## セクション内容..."}],
67
+ "reason": "必要な理由", "priority": "high"
116
68
  }
117
69
  ],
118
- "mandatoryChecks": {
70
+ "metaCognitiveGuidance": {
119
71
  "taskEssence": "表面作業でなく根本目的の理解",
120
- "ruleAdequacy": "選択したルールがタスク特性に合致",
121
72
  "pastFailures": ["エラー修正衝動", "一度に大変更", "テスト不足"],
122
- "firstStep": "最初の具体的アクション"
73
+ "potentialPitfalls": ["根本原因分析なし", "段階的アプローチなし", "テストなし"],
74
+ "firstStep": {"action": "最初のアクション", "rationale": "なぜ最初か"}
123
75
  },
124
- "metaCognitiveQuestions": [
125
- "このタスクで最も重要な品質基準は何か?",
126
- "過去に類似タスクで発生した問題は?",
127
- "最初に着手すべき部分はどこか?",
128
- "当初想定を超える可能性はあるか?"
129
- ],
130
- "criticalRules": [
131
- "型チェックの完全実施 - 型安全性を確保",
132
- "実装前のユーザー承認必須",
133
- "品質チェック完了前のコミット禁止"
134
- ],
76
+ "metaCognitiveQuestions": ["最重要品質基準は?", "類似タスクでの過去の問題は?", "どこから着手?"],
135
77
  "warningPatterns": [
136
- "大規模変更を一度に実施 段階的に分割",
137
- "テスト未作成での実装 Red-Green-Refactor遵守",
138
- "エラー見ると即修正 → 一時停止・根本原因分析",
139
- "計画なしにコード開始 → 実装計画立案必須"
78
+ {"pattern": "一度に大変更", "risk": "高複雑性", "mitigation": "フェーズ分割"},
79
+ {"pattern": "テストなし", "risk": "回帰バグ", "mitigation": "Red-Green-Refactor"}
140
80
  ],
141
- "firstActionGuidance": {
142
- "action": "最初に実行すべき具体的アクション",
143
- "rationale": "なぜそれを最初に行うべきか"
144
- },
81
+ "criticalRules": ["型安全性確保", "実装前ユーザー承認", "品質チェック後コミット"],
145
82
  "confidence": "high|medium|low"
146
83
  }
147
84
  ```
148
85
 
149
86
  ## 重要な原則
150
87
 
151
- ### ルール選択の優先順位
152
- 1. **タスクに直接関連する必須ルール**
153
- 2. **品質保証に関するルール**(特にテスト)
154
- 3. **プロセス・ワークフローのルール**
155
- 4. **補助的・参考的なルール**
88
+ ### スキル選択の優先順位
89
+ 1. **タスクに直接関連する必須スキル**
90
+ 2. **品質保証に関するスキル**(特にテスト)
91
+ 3. **プロセス・ワークフローのスキル**
92
+ 4. **補助的・参考的なスキル**
156
93
 
157
94
  ### 最適化の基準
158
95
  - **包括性**: タスクを高品質に完遂するための全体的な視点
159
96
  - **品質保証**: コード修正には必ずテスト・品質チェックを含める
160
97
  - **具体性**: 抽象的な原則より具体的な手順
161
- - **依存関係**: 他のルールの前提となるもの
98
+ - **依存関係**: 他のスキルの前提となるもの
162
99
 
163
100
  ### セクション選択の指針
164
101
  - タスクの直接的な要求だけでなく、高品質な完成に必要なセクションも含める
165
- - CLAUDE.mdの基本ルールは全タスクで必須
166
102
  - 具体的な手順・チェックリストを優先
167
103
  - 冗長な説明部分は除外
168
104
 
169
105
  ## エラーハンドリング
170
106
 
171
- - rules-index.yamlが見つからない場合:エラーを報告
172
- - ルールファイルが読み込めない場合:代替ルールを提案
107
+ - skills-index.yamlが見つからない場合:エラーを報告
108
+ - スキルファイルが読み込めない場合:代替スキルを提案
173
109
  - タスク内容が不明確な場合:clarifying questionsを含める
174
110
 
175
111
  ## メタ認知質問の設計
@@ -180,15 +116,8 @@ graph TD
180
116
  - **リファクタリング**: 現状の問題、目標状態、段階的計画
181
117
  - **設計タスク**: 要件の明確性、将来の拡張性、トレードオフ
182
118
 
183
- ### 必須チェック4項目との連携
184
- 出力の`mandatoryChecks`セクションは、CLAUDE.mdの「必須チェック4項目」のうち2-4を支援:
185
- - **taskEssence**: 「タスクの本質は何か?」への回答支援
186
- - **ruleAdequacy**: 「rule-advisorの選択ルールは適切か?」の自己評価
187
- - **pastFailures**: 「過去の失敗パターンは?」の具体例
188
- - **firstStep**: 「最初の1ステップは何か?」への明確な指針
189
-
190
119
  ## 注意事項
191
120
 
192
121
  - 不確実な場合はconfidenceを"low"に設定
193
- - 積極的に情報収集し、関連する可能性があるルールは広めに含める
194
- - 必ず`docs/rules/`配下のファイルのみを参照
122
+ - 積極的に情報収集し、関連する可能性があるスキルは広めに含める
123
+ - `.claude/skills/`配下のスキルのみを参照