yodogawa 2.1.3 → 2.2.0
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.
- package/CHANGELOG.md +134 -94
- package/LICENSE +1 -1
- package/README.md +351 -263
- package/bin/checks/id-trace.js +137 -0
- package/bin/checks/links.js +59 -0
- package/bin/checks/placeholder.js +132 -0
- package/bin/checks/structure.js +127 -0
- package/bin/cli.js +51 -67
- package/bin/commands/doctor.js +128 -0
- package/bin/commands/install.js +58 -0
- package/bin/commands/new-task.js +117 -0
- package/bin/lib/check-cli.js +19 -0
- package/bin/lib/findings.js +31 -0
- package/bin/lib/markdown.js +103 -0
- package/bin/lib/project-spec.js +138 -0
- package/bin/lib/walk-md.js +23 -0
- package/package.json +68 -55
- package/skills/a-001-setup-doc-structure/SKILL.md +68 -68
- package/skills/a-001-setup-doc-structure/reference/directory-structure.md +75 -75
- package/skills/a-002-initialize-project/SKILL.md +145 -118
- package/skills/a-002-initialize-project/reference/hearing-questions.md +91 -41
- package/skills/a-002-initialize-project/reference/structure-check.md +12 -22
- package/skills/a-002a-slice-mvp-scope/SKILL.md +105 -0
- package/skills/a-002b-define-user-stories/SKILL.md +80 -0
- package/skills/a-002b-define-user-stories/reference/user-stories-guide.md +78 -0
- package/skills/a-003-create-scenarios/SKILL.md +97 -96
- package/{templates/project/02-behavior/01-scenarios.md → skills/a-003-create-scenarios/reference/detailed-gherkin-template.md} +413 -406
- package/skills/a-003-create-scenarios/reference/structure-check.md +20 -17
- package/skills/a-004-define-domain-model/SKILL.md +107 -98
- package/skills/a-004-define-domain-model/reference/event-storming-guide.md +33 -7
- package/skills/a-004-define-domain-model/reference/ubiquitous-language-guide.md +49 -0
- package/skills/a-005-create-domain-diagram/SKILL.md +18 -17
- package/skills/a-006-review-requirements-domain/SKILL.md +59 -22
- package/skills/a-006-review-requirements-domain/examples/review-report-template.md +27 -7
- package/skills/a-006-review-requirements-domain/reference/consistency-checks.md +53 -18
- package/skills/a-007-define-tech-stack/SKILL.md +99 -99
- package/skills/a-008-define-repository-structure/SKILL.md +96 -96
- package/skills/a-009-define-screen-design/SKILL.md +103 -103
- package/skills/a-010-define-design-system/SKILL.md +130 -130
- package/skills/a-011-define-data-model/SKILL.md +118 -118
- package/skills/a-012-define-api-spec/SKILL.md +105 -105
- package/skills/a-013-define-architecture/SKILL.md +98 -98
- package/skills/a-014-define-infrastructure/SKILL.md +118 -110
- package/skills/{a-002-initialize-project → a-014-define-infrastructure}/examples/nfr-baseline.md +2 -1
- package/{templates/project/01-requirements/04-non-functional-requirements.md → skills/a-014-define-infrastructure/examples/non-functional-requirements.md} +120 -115
- package/skills/a-015-review-design/reference/consistency-checks.md +1 -1
- package/skills/b-001-create-task-directory/SKILL.md +68 -68
- package/skills/b-002-create-task-definition/SKILL.md +114 -114
- package/skills/b-003-create-task-research/SKILL.md +128 -128
- package/skills/b-004-create-task-implementation/SKILL.md +98 -98
- package/skills/b-005-review-task/reference/assessment-criteria.md +79 -79
- package/skills/c-001-implement-task/SKILL.md +186 -186
- package/skills/c-001-implement-task/reference/implementation-loop.md +65 -65
- package/skills/c-002-update-documentation/SKILL.md +159 -159
- package/skills/c-002-update-documentation/examples/project-doc-updates.md +4 -4
- package/skills/c-002-update-documentation/reference/doc-structure-and-checks.md +99 -97
- package/templates/project/01-requirements/01-product-brief.md +186 -0
- package/templates/project/01-requirements/02-mvp-scope.md +64 -0
- package/templates/project/01-requirements/03-parking-lot.md +29 -0
- package/templates/project/01-requirements/05-user-stories.md +28 -124
- package/templates/project/01-requirements/{02-features-implemented.md → 06-features-implemented.md} +77 -73
- package/templates/project/02-behavior/01-core-scenarios.md +80 -0
- package/templates/project/03-domain/01-domain-model.md +120 -339
- package/templates/project/03-domain/01-domain-sketch.md +90 -0
- package/templates/project/03-domain/02-ubiquitous-language.md +32 -153
- package/templates/project/04-design/01-tech-stack.md +367 -367
- package/templates/project/04-design/02-repository-structure.md +391 -391
- package/templates/project/04-design/03-screen-design.md +596 -596
- package/templates/project/04-design/04-design-system.md +261 -261
- package/templates/project/04-design/05-data-model.md +211 -211
- package/templates/project/04-design/06-api-spec.md +226 -226
- package/templates/project/04-design/07-architecture.md +183 -183
- package/templates/project/04-design/08-infrastructure.md +180 -180
- package/templates/project/AI_CONTEXT.md +55 -0
- package/templates/project/STAKEHOLDER-SUMMARY.md +66 -0
- package/templates/tasks/task-template/a-definition.md +143 -143
- package/templates/tasks/task-template/b-research.md +185 -185
- package/templates/tasks/task-template/c-implementation.md +200 -200
- package/templates/project/01-requirements/01-system-overview.md +0 -49
- package/templates/project/01-requirements/03-features-planned.md +0 -75
|
@@ -1,128 +1,128 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: b-003-create-task-research
|
|
3
|
-
description: タスク実装前に既存コード・ベストプラクティス・再利用候補・リスクを調査し b-research.md に記録する。タスク定義確定後、実装計画作成前に使用。
|
|
4
|
-
disable-model-invocation: true
|
|
5
|
-
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
6
|
-
argument-hint: "[task-id]"
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# CreateTaskResearch (b-003)
|
|
10
|
-
|
|
11
|
-
## 目的
|
|
12
|
-
|
|
13
|
-
- 実装に着手する前に、最適なアプローチ・技術・注意点を整理する。
|
|
14
|
-
- 既存コードやコンポーネントを把握し、重複実装や手戻りを防止する。
|
|
15
|
-
- 技術選定・リスク・参考資料を記録し、実装計画 (b-004) の入力とする。
|
|
16
|
-
|
|
17
|
-
## 前提
|
|
18
|
-
|
|
19
|
-
- `CreateTaskDefinition (b-002)` が完了し、`a-definition.md` に目的・変更内容が記載されている。
|
|
20
|
-
- タスクディレクトリ: `docs/tasks/task{ID}-{SLUG}/`
|
|
21
|
-
- テンプレート: `../../templates/tasks/task-template/b-research.md`(スキル配置ディレクトリ起点の相対参照)
|
|
22
|
-
|
|
23
|
-
## 手順
|
|
24
|
-
|
|
25
|
-
`$ARGUMENTS` が指定されている場合は `task{ID}-{SLUG}`(例: `task000003-auth-login`)として使用する。未指定の場合はユーザーに対象タスクを確認する。
|
|
26
|
-
|
|
27
|
-
### 1. ドキュメントとテンプレートの準備
|
|
28
|
-
|
|
29
|
-
対象タスクディレクトリを確認する。
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
ls -d docs/tasks/task*
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
このスキルの配置ディレクトリ(`skills/b-003-create-task-research/`)を起点に、相対パス `../../templates/tasks/task-template/b-research.md` を Read で読み込み、`docs/tasks/task{ID}-{SLUG}/b-research.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する(冪等)。
|
|
36
|
-
|
|
37
|
-
### 2. 調査計画の立案
|
|
38
|
-
|
|
39
|
-
- `a-definition.md` を読み、変更対象・技術要件・制約を抽出。
|
|
40
|
-
- 調査する観点を整理:例)類似実装、利用ライブラリ、外部API仕様、セキュリティ要件。
|
|
41
|
-
- 調査メモを残しながら進めると、ドキュメント作成がスムーズ。
|
|
42
|
-
|
|
43
|
-
### 3. 既存実装と再利用候補の調査
|
|
44
|
-
|
|
45
|
-
- コードベースを検索し、類似ロジックやコンポーネントを洗い出す。
|
|
46
|
-
- 再利用できるファイル・モジュール・カスタムフック・APIクライアントをリスト化。
|
|
47
|
-
- 参考にできる実装パターン(バリデーション、エラーハンドリング等)と課題点を併記。
|
|
48
|
-
- 詳細な調査観点・分析項目は [reference/investigation-guide.md](reference/investigation-guide.md) を参照。
|
|
49
|
-
|
|
50
|
-
### 4. ベストプラクティス・外部情報の調査
|
|
51
|
-
|
|
52
|
-
- 公式ドキュメント、信頼できる記事、社内ナレッジを確認し、採用すべきパターン/アンチパターンを整理。
|
|
53
|
-
- 調査内容(タイトル、要点、URL)を記録。例)フォームバリデーション、非同期通信、セキュリティガイドライン。
|
|
54
|
-
|
|
55
|
-
### 5. 技術選定と比較(必要時)
|
|
56
|
-
|
|
57
|
-
- 新規導入・置き換え候補のライブラリ/サービスを比較。
|
|
58
|
-
- 比較観点: メンテ状況、TypeScript対応、バンドルサイズ、コスト、既存スタックとの親和性。
|
|
59
|
-
- 選定理由と却下理由を記録。チーム合意が必要な場合はその旨も記載。
|
|
60
|
-
- 詳細な比較観点は [reference/investigation-guide.md](reference/investigation-guide.md) を参照。
|
|
61
|
-
|
|
62
|
-
### 6. 技術的リスクと対策
|
|
63
|
-
|
|
64
|
-
- パフォーマンス、セキュリティ、スケーラビリティ、依存サービス等のリスクを洗い出す。
|
|
65
|
-
- 影響度と優先度(高/中/低)を付与し、軽減策やPoCの必要有無を記載。
|
|
66
|
-
- リスクカテゴリ一覧とセキュリティチェック項目は [reference/investigation-guide.md](reference/investigation-guide.md) を参照。
|
|
67
|
-
|
|
68
|
-
### 7. ドキュメントへの反映
|
|
69
|
-
|
|
70
|
-
1. `docs/tasks/task{ID}-{SLUG}/b-research.md` を編集し、以下を記入:
|
|
71
|
-
- ベストプラクティス / 参考リンク
|
|
72
|
-
- 既存コード・再利用コンポーネント
|
|
73
|
-
- 技術選定(比較表含む)
|
|
74
|
-
- 技術的リスク・制約
|
|
75
|
-
- メモ / 次に確認すべき事項
|
|
76
|
-
2. HTMLコメントはガイドとして残す。
|
|
77
|
-
3. 各セクションの表テンプレートは [examples/research-tables.md](examples/research-tables.md) を参照。
|
|
78
|
-
|
|
79
|
-
### 8. 構造チェック
|
|
80
|
-
|
|
81
|
-
```bash
|
|
82
|
-
grep "## ベストプラクティス" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
83
|
-
&& grep "## 既存コード調査" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
84
|
-
&& grep "## 技術選定" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
85
|
-
&& grep "## 技術的リスク" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
86
|
-
&& echo "OK" || echo "MISSING SECTION"
|
|
87
|
-
```
|
|
88
|
-
|
|
89
|
-
チェックリスト:
|
|
90
|
-
|
|
91
|
-
- [ ] 参考リンク・出典が記載されている
|
|
92
|
-
- [ ] 再利用できるコード/コンポーネントが明確
|
|
93
|
-
- [ ] 技術選定理由と代替案が整理されている
|
|
94
|
-
- [ ] リスクに軽減策と優先度が付与されている
|
|
95
|
-
|
|
96
|
-
### 9. Git への追加(任意)
|
|
97
|
-
|
|
98
|
-
```bash
|
|
99
|
-
git add docs/tasks/task{ID}-{SLUG}/b-research.md
|
|
100
|
-
git commit -m "docs(task): 技術調査メモの作成 task{ID}"
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
## 完了条件
|
|
104
|
-
|
|
105
|
-
- `b-research.md` に以下が網羅されている:
|
|
106
|
-
- ベストプラクティス/参考資料
|
|
107
|
-
- 既存コード・再利用コンポーネント
|
|
108
|
-
- 技術選定と比較(必要に応じて)
|
|
109
|
-
- 技術的リスクと対策
|
|
110
|
-
- 追加のメモ/未解決事項
|
|
111
|
-
- 実装計画 (b-004) に渡せるレベルで情報が整理されている。
|
|
112
|
-
- 関係者が内容を確認し、疑問があれば解消済み。
|
|
113
|
-
|
|
114
|
-
## エスカレーション
|
|
115
|
-
|
|
116
|
-
- **既存コードが見つからない**: 「コードベースを検索しても見つからない場合、他メンバーに確認し、再利用可否を判断してください。」
|
|
117
|
-
- **ライブラリ選定で決め手がない**: 「評価軸を追加(保守実績、サポート、コストなど)し、比較表を拡張してください。」
|
|
118
|
-
- **リスクが高い**: 「影響が重大なリスクは PoC や専門チーム相談を提案し、スケジュールに反映してください。」
|
|
119
|
-
- **外部サービス依存がある**: 「SLA・レート制限・コストを確認し、代替案やフォールバックを検討してください。」
|
|
120
|
-
- **ドキュメントが不足**: 「ベストプラクティスや参考資料の記載が不十分です。公式ドキュメントや社内ナレッジを追加してください。」
|
|
121
|
-
- **セキュリティリスクが見落とされている**: 「入力バリデーション/XSS/CSRF/SQLi/認証・認可/暗号化/レート制限の観点で再調査してください。」
|
|
122
|
-
- **パフォーマンスリスクが見落とされている**: 「大量データや高負荷時の動作を検討してください。」
|
|
123
|
-
- **新ライブラリ導入がチーム未合意**: 「チームリーダーやメンバーとレビュー・合意を取ってください。」
|
|
124
|
-
|
|
125
|
-
## 参考
|
|
126
|
-
|
|
127
|
-
- [reference/investigation-guide.md](reference/investigation-guide.md) — 調査観点・分析項目・リスクカテゴリの詳細
|
|
128
|
-
- [examples/research-tables.md](examples/research-tables.md) — 各セクションの表テンプレート例
|
|
1
|
+
---
|
|
2
|
+
name: b-003-create-task-research
|
|
3
|
+
description: タスク実装前に既存コード・ベストプラクティス・再利用候補・リスクを調査し b-research.md に記録する。タスク定義確定後、実装計画作成前に使用。
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
6
|
+
argument-hint: "[task-id]"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# CreateTaskResearch (b-003)
|
|
10
|
+
|
|
11
|
+
## 目的
|
|
12
|
+
|
|
13
|
+
- 実装に着手する前に、最適なアプローチ・技術・注意点を整理する。
|
|
14
|
+
- 既存コードやコンポーネントを把握し、重複実装や手戻りを防止する。
|
|
15
|
+
- 技術選定・リスク・参考資料を記録し、実装計画 (b-004) の入力とする。
|
|
16
|
+
|
|
17
|
+
## 前提
|
|
18
|
+
|
|
19
|
+
- `CreateTaskDefinition (b-002)` が完了し、`a-definition.md` に目的・変更内容が記載されている。
|
|
20
|
+
- タスクディレクトリ: `docs/tasks/task{ID}-{SLUG}/`
|
|
21
|
+
- テンプレート: `../../templates/tasks/task-template/b-research.md`(スキル配置ディレクトリ起点の相対参照)
|
|
22
|
+
|
|
23
|
+
## 手順
|
|
24
|
+
|
|
25
|
+
`$ARGUMENTS` が指定されている場合は `task{ID}-{SLUG}`(例: `task000003-auth-login`)として使用する。未指定の場合はユーザーに対象タスクを確認する。
|
|
26
|
+
|
|
27
|
+
### 1. ドキュメントとテンプレートの準備
|
|
28
|
+
|
|
29
|
+
対象タスクディレクトリを確認する。
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
ls -d docs/tasks/task*
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
このスキルの配置ディレクトリ(`skills/b-003-create-task-research/`)を起点に、相対パス `../../templates/tasks/task-template/b-research.md` を Read で読み込み、`docs/tasks/task{ID}-{SLUG}/b-research.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する(冪等)。
|
|
36
|
+
|
|
37
|
+
### 2. 調査計画の立案
|
|
38
|
+
|
|
39
|
+
- `a-definition.md` を読み、変更対象・技術要件・制約を抽出。
|
|
40
|
+
- 調査する観点を整理:例)類似実装、利用ライブラリ、外部API仕様、セキュリティ要件。
|
|
41
|
+
- 調査メモを残しながら進めると、ドキュメント作成がスムーズ。
|
|
42
|
+
|
|
43
|
+
### 3. 既存実装と再利用候補の調査
|
|
44
|
+
|
|
45
|
+
- コードベースを検索し、類似ロジックやコンポーネントを洗い出す。
|
|
46
|
+
- 再利用できるファイル・モジュール・カスタムフック・APIクライアントをリスト化。
|
|
47
|
+
- 参考にできる実装パターン(バリデーション、エラーハンドリング等)と課題点を併記。
|
|
48
|
+
- 詳細な調査観点・分析項目は [reference/investigation-guide.md](reference/investigation-guide.md) を参照。
|
|
49
|
+
|
|
50
|
+
### 4. ベストプラクティス・外部情報の調査
|
|
51
|
+
|
|
52
|
+
- 公式ドキュメント、信頼できる記事、社内ナレッジを確認し、採用すべきパターン/アンチパターンを整理。
|
|
53
|
+
- 調査内容(タイトル、要点、URL)を記録。例)フォームバリデーション、非同期通信、セキュリティガイドライン。
|
|
54
|
+
|
|
55
|
+
### 5. 技術選定と比較(必要時)
|
|
56
|
+
|
|
57
|
+
- 新規導入・置き換え候補のライブラリ/サービスを比較。
|
|
58
|
+
- 比較観点: メンテ状況、TypeScript対応、バンドルサイズ、コスト、既存スタックとの親和性。
|
|
59
|
+
- 選定理由と却下理由を記録。チーム合意が必要な場合はその旨も記載。
|
|
60
|
+
- 詳細な比較観点は [reference/investigation-guide.md](reference/investigation-guide.md) を参照。
|
|
61
|
+
|
|
62
|
+
### 6. 技術的リスクと対策
|
|
63
|
+
|
|
64
|
+
- パフォーマンス、セキュリティ、スケーラビリティ、依存サービス等のリスクを洗い出す。
|
|
65
|
+
- 影響度と優先度(高/中/低)を付与し、軽減策やPoCの必要有無を記載。
|
|
66
|
+
- リスクカテゴリ一覧とセキュリティチェック項目は [reference/investigation-guide.md](reference/investigation-guide.md) を参照。
|
|
67
|
+
|
|
68
|
+
### 7. ドキュメントへの反映
|
|
69
|
+
|
|
70
|
+
1. `docs/tasks/task{ID}-{SLUG}/b-research.md` を編集し、以下を記入:
|
|
71
|
+
- ベストプラクティス / 参考リンク
|
|
72
|
+
- 既存コード・再利用コンポーネント
|
|
73
|
+
- 技術選定(比較表含む)
|
|
74
|
+
- 技術的リスク・制約
|
|
75
|
+
- メモ / 次に確認すべき事項
|
|
76
|
+
2. HTMLコメントはガイドとして残す。
|
|
77
|
+
3. 各セクションの表テンプレートは [examples/research-tables.md](examples/research-tables.md) を参照。
|
|
78
|
+
|
|
79
|
+
### 8. 構造チェック
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
grep "## ベストプラクティス" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
83
|
+
&& grep "## 既存コード調査" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
84
|
+
&& grep "## 技術選定" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
85
|
+
&& grep "## 技術的リスク" docs/tasks/task{ID}-{SLUG}/b-research.md \
|
|
86
|
+
&& echo "OK" || echo "MISSING SECTION"
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
チェックリスト:
|
|
90
|
+
|
|
91
|
+
- [ ] 参考リンク・出典が記載されている
|
|
92
|
+
- [ ] 再利用できるコード/コンポーネントが明確
|
|
93
|
+
- [ ] 技術選定理由と代替案が整理されている
|
|
94
|
+
- [ ] リスクに軽減策と優先度が付与されている
|
|
95
|
+
|
|
96
|
+
### 9. Git への追加(任意)
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
git add docs/tasks/task{ID}-{SLUG}/b-research.md
|
|
100
|
+
git commit -m "docs(task): 技術調査メモの作成 task{ID}"
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## 完了条件
|
|
104
|
+
|
|
105
|
+
- `b-research.md` に以下が網羅されている:
|
|
106
|
+
- ベストプラクティス/参考資料
|
|
107
|
+
- 既存コード・再利用コンポーネント
|
|
108
|
+
- 技術選定と比較(必要に応じて)
|
|
109
|
+
- 技術的リスクと対策
|
|
110
|
+
- 追加のメモ/未解決事項
|
|
111
|
+
- 実装計画 (b-004) に渡せるレベルで情報が整理されている。
|
|
112
|
+
- 関係者が内容を確認し、疑問があれば解消済み。
|
|
113
|
+
|
|
114
|
+
## エスカレーション
|
|
115
|
+
|
|
116
|
+
- **既存コードが見つからない**: 「コードベースを検索しても見つからない場合、他メンバーに確認し、再利用可否を判断してください。」
|
|
117
|
+
- **ライブラリ選定で決め手がない**: 「評価軸を追加(保守実績、サポート、コストなど)し、比較表を拡張してください。」
|
|
118
|
+
- **リスクが高い**: 「影響が重大なリスクは PoC や専門チーム相談を提案し、スケジュールに反映してください。」
|
|
119
|
+
- **外部サービス依存がある**: 「SLA・レート制限・コストを確認し、代替案やフォールバックを検討してください。」
|
|
120
|
+
- **ドキュメントが不足**: 「ベストプラクティスや参考資料の記載が不十分です。公式ドキュメントや社内ナレッジを追加してください。」
|
|
121
|
+
- **セキュリティリスクが見落とされている**: 「入力バリデーション/XSS/CSRF/SQLi/認証・認可/暗号化/レート制限の観点で再調査してください。」
|
|
122
|
+
- **パフォーマンスリスクが見落とされている**: 「大量データや高負荷時の動作を検討してください。」
|
|
123
|
+
- **新ライブラリ導入がチーム未合意**: 「チームリーダーやメンバーとレビュー・合意を取ってください。」
|
|
124
|
+
|
|
125
|
+
## 参考
|
|
126
|
+
|
|
127
|
+
- [reference/investigation-guide.md](reference/investigation-guide.md) — 調査観点・分析項目・リスクカテゴリの詳細
|
|
128
|
+
- [examples/research-tables.md](examples/research-tables.md) — 各セクションの表テンプレート例
|
|
@@ -1,98 +1,98 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: b-004-create-task-implementation
|
|
3
|
-
description: タスクをステップ単位に分割し、各ステップの成果物・受け入れ基準を c-implementation.md に定義する。リサーチ完了後、実装着手前に使用。
|
|
4
|
-
disable-model-invocation: true
|
|
5
|
-
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
6
|
-
argument-hint: "[task-id]"
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# CreateTaskImplementation (b-004)
|
|
10
|
-
|
|
11
|
-
## 目的
|
|
12
|
-
|
|
13
|
-
- タスクを実行可能なフェーズとステップに分割し、作業順序と依存関係を明確にする。
|
|
14
|
-
- 各ステップの成果物と受け入れ基準を定義し、作業完了の判断基準を共有する。
|
|
15
|
-
- 実装開始前にテスト計画や懸念点を洗い出し、品質リスクを低減する。
|
|
16
|
-
|
|
17
|
-
## 前提
|
|
18
|
-
|
|
19
|
-
- `a-definition.md`(b-002)と `b-research.md`(b-003)が作成済み
|
|
20
|
-
- タスクディレクトリ: `docs/tasks/task{ID}-{SLUG}/`
|
|
21
|
-
- テンプレート: `../../templates/tasks/task-template/c-implementation.md`(スキル配置ディレクトリ起点の相対参照)
|
|
22
|
-
|
|
23
|
-
## 手順
|
|
24
|
-
|
|
25
|
-
`$ARGUMENTS` が指定されている場合は `task{ID}-{SLUG}`(例: `task000003-auth-login`)として使用する。未指定の場合はユーザーに対象タスクを確認する。
|
|
26
|
-
|
|
27
|
-
### 1. ドキュメント確認とテンプレート準備
|
|
28
|
-
|
|
29
|
-
対象タスクディレクトリを確認する。
|
|
30
|
-
|
|
31
|
-
```bash
|
|
32
|
-
ls -d docs/tasks/task*
|
|
33
|
-
```
|
|
34
|
-
|
|
35
|
-
このスキルの配置ディレクトリ(`skills/b-004-create-task-implementation/`)を起点に、相対パス `../../templates/tasks/task-template/c-implementation.md` を Read で読み込み、`docs/tasks/task{ID}-{SLUG}/c-implementation.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する(冪等)。
|
|
36
|
-
|
|
37
|
-
`a-definition.md` から目的・変更内容・受け入れ基準を、`b-research.md` から技術方針・ライブラリ選定・リスクを読み取る。
|
|
38
|
-
|
|
39
|
-
### 2. フェーズ設計
|
|
40
|
-
|
|
41
|
-
タスクを 2〜4 フェーズに分割(1 フェーズ = 1〜3 日規模)。分割の考え方と例は [examples/phase-step-template.md](examples/phase-step-template.md#フェーズ分割の目安) を参照。
|
|
42
|
-
|
|
43
|
-
### 3. ステップ分解
|
|
44
|
-
|
|
45
|
-
各フェーズを 1〜3 時間で完了できるステップに分割し、Title / Details / Deliverables / Verification を定義。記載例は [examples/phase-step-template.md](examples/phase-step-template.md#ステップ分解のテンプレート) を参照。
|
|
46
|
-
|
|
47
|
-
### 4. テスト計画
|
|
48
|
-
|
|
49
|
-
フェーズ/ステップ単位で必要なテスト(ユニット、API、UI、E2E、負荷)とカバレッジ目標、検証コマンド(`npm test`, `playwright test` 等)を記載。例は [examples/phase-step-template.md](examples/phase-step-template.md#テスト計画の記載例) を参照。
|
|
50
|
-
|
|
51
|
-
### 5. ドキュメント反映
|
|
52
|
-
|
|
53
|
-
`docs/tasks/task{ID}-{SLUG}/c-implementation.md` に以下を記入:
|
|
54
|
-
|
|
55
|
-
1. フェーズ一覧(目的、完了条件、依存関係)
|
|
56
|
-
2. フェーズ内ステップ(Title/Details/Deliverables/Verification)
|
|
57
|
-
3. テスト計画
|
|
58
|
-
4. メモ・補足(懸念点、要確認事項、リファクタ案)
|
|
59
|
-
|
|
60
|
-
HTML コメントは削除せずガイドとして残す。
|
|
61
|
-
|
|
62
|
-
### 6. 構造チェック
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
grep "## 実装フェーズ" docs/tasks/task{ID}-{SLUG}/c-implementation.md \
|
|
66
|
-
&& grep "## ステップ一覧" docs/tasks/task{ID}-{SLUG}/c-implementation.md \
|
|
67
|
-
&& grep "## テスト計画" docs/tasks/task{ID}-{SLUG}/c-implementation.md \
|
|
68
|
-
&& echo "OK" || echo "MISSING SECTION"
|
|
69
|
-
```
|
|
70
|
-
|
|
71
|
-
チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
|
|
72
|
-
|
|
73
|
-
### 7. Git への追加(任意)
|
|
74
|
-
|
|
75
|
-
```bash
|
|
76
|
-
git add docs/tasks/task{ID}-{SLUG}/c-implementation.md
|
|
77
|
-
git commit -m "docs(task): 実装計画の作成 task{ID}"
|
|
78
|
-
```
|
|
79
|
-
|
|
80
|
-
## 完了条件
|
|
81
|
-
|
|
82
|
-
- `c-implementation.md` にフェーズ/ステップ/テスト/メモが記載されている
|
|
83
|
-
- ステップの粒度が適切(1〜3 時間)で、成果物が明確
|
|
84
|
-
- フェーズ順序と依存関係が示されている
|
|
85
|
-
- 関係者レビューで疑問がない状態
|
|
86
|
-
|
|
87
|
-
## エスカレーション
|
|
88
|
-
|
|
89
|
-
- **フェーズが大きすぎる**: 「1 フェーズが 3 日以上になりそうです。分割してください。」
|
|
90
|
-
- **ステップが抽象的**: 「成果物が特定できません。ファイル名や検証手順を明記してください。」
|
|
91
|
-
- **テスト計画不足**: 「対象機能のテスト戦略が不足しています。ユニット/統合/E2E を再検討してください。」
|
|
92
|
-
- **リスク対策未反映**: 「b-003 で挙げたリスクへの対策ステップがありません。計画に組み込んでください。」
|
|
93
|
-
- **依存関係不明**: 「並行実行可能なフェーズと、順序が必要なフェーズを明示してください。」
|
|
94
|
-
|
|
95
|
-
## 参考
|
|
96
|
-
|
|
97
|
-
- [examples/phase-step-template.md](examples/phase-step-template.md) — フェーズ分割、ステップ分解、テスト計画の記載例
|
|
98
|
-
- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、レビュー観点
|
|
1
|
+
---
|
|
2
|
+
name: b-004-create-task-implementation
|
|
3
|
+
description: タスクをステップ単位に分割し、各ステップの成果物・受け入れ基準を c-implementation.md に定義する。リサーチ完了後、実装着手前に使用。
|
|
4
|
+
disable-model-invocation: true
|
|
5
|
+
allowed-tools: Read, Write, Edit, Bash, Grep, Glob
|
|
6
|
+
argument-hint: "[task-id]"
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# CreateTaskImplementation (b-004)
|
|
10
|
+
|
|
11
|
+
## 目的
|
|
12
|
+
|
|
13
|
+
- タスクを実行可能なフェーズとステップに分割し、作業順序と依存関係を明確にする。
|
|
14
|
+
- 各ステップの成果物と受け入れ基準を定義し、作業完了の判断基準を共有する。
|
|
15
|
+
- 実装開始前にテスト計画や懸念点を洗い出し、品質リスクを低減する。
|
|
16
|
+
|
|
17
|
+
## 前提
|
|
18
|
+
|
|
19
|
+
- `a-definition.md`(b-002)と `b-research.md`(b-003)が作成済み
|
|
20
|
+
- タスクディレクトリ: `docs/tasks/task{ID}-{SLUG}/`
|
|
21
|
+
- テンプレート: `../../templates/tasks/task-template/c-implementation.md`(スキル配置ディレクトリ起点の相対参照)
|
|
22
|
+
|
|
23
|
+
## 手順
|
|
24
|
+
|
|
25
|
+
`$ARGUMENTS` が指定されている場合は `task{ID}-{SLUG}`(例: `task000003-auth-login`)として使用する。未指定の場合はユーザーに対象タスクを確認する。
|
|
26
|
+
|
|
27
|
+
### 1. ドキュメント確認とテンプレート準備
|
|
28
|
+
|
|
29
|
+
対象タスクディレクトリを確認する。
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
ls -d docs/tasks/task*
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
このスキルの配置ディレクトリ(`skills/b-004-create-task-implementation/`)を起点に、相対パス `../../templates/tasks/task-template/c-implementation.md` を Read で読み込み、`docs/tasks/task{ID}-{SLUG}/c-implementation.md` へ Write する。出力先が既に存在する場合は上書きせずスキップして報告する(冪等)。
|
|
36
|
+
|
|
37
|
+
`a-definition.md` から目的・変更内容・受け入れ基準を、`b-research.md` から技術方針・ライブラリ選定・リスクを読み取る。
|
|
38
|
+
|
|
39
|
+
### 2. フェーズ設計
|
|
40
|
+
|
|
41
|
+
タスクを 2〜4 フェーズに分割(1 フェーズ = 1〜3 日規模)。分割の考え方と例は [examples/phase-step-template.md](examples/phase-step-template.md#フェーズ分割の目安) を参照。
|
|
42
|
+
|
|
43
|
+
### 3. ステップ分解
|
|
44
|
+
|
|
45
|
+
各フェーズを 1〜3 時間で完了できるステップに分割し、Title / Details / Deliverables / Verification を定義。記載例は [examples/phase-step-template.md](examples/phase-step-template.md#ステップ分解のテンプレート) を参照。
|
|
46
|
+
|
|
47
|
+
### 4. テスト計画
|
|
48
|
+
|
|
49
|
+
フェーズ/ステップ単位で必要なテスト(ユニット、API、UI、E2E、負荷)とカバレッジ目標、検証コマンド(`npm test`, `playwright test` 等)を記載。例は [examples/phase-step-template.md](examples/phase-step-template.md#テスト計画の記載例) を参照。
|
|
50
|
+
|
|
51
|
+
### 5. ドキュメント反映
|
|
52
|
+
|
|
53
|
+
`docs/tasks/task{ID}-{SLUG}/c-implementation.md` に以下を記入:
|
|
54
|
+
|
|
55
|
+
1. フェーズ一覧(目的、完了条件、依存関係)
|
|
56
|
+
2. フェーズ内ステップ(Title/Details/Deliverables/Verification)
|
|
57
|
+
3. テスト計画
|
|
58
|
+
4. メモ・補足(懸念点、要確認事項、リファクタ案)
|
|
59
|
+
|
|
60
|
+
HTML コメントは削除せずガイドとして残す。
|
|
61
|
+
|
|
62
|
+
### 6. 構造チェック
|
|
63
|
+
|
|
64
|
+
```bash
|
|
65
|
+
grep "## 実装フェーズ" docs/tasks/task{ID}-{SLUG}/c-implementation.md \
|
|
66
|
+
&& grep "## ステップ一覧" docs/tasks/task{ID}-{SLUG}/c-implementation.md \
|
|
67
|
+
&& grep "## テスト計画" docs/tasks/task{ID}-{SLUG}/c-implementation.md \
|
|
68
|
+
&& echo "OK" || echo "MISSING SECTION"
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
チェックリストは [reference/structure-check.md](reference/structure-check.md#チェックリスト) を参照。
|
|
72
|
+
|
|
73
|
+
### 7. Git への追加(任意)
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
git add docs/tasks/task{ID}-{SLUG}/c-implementation.md
|
|
77
|
+
git commit -m "docs(task): 実装計画の作成 task{ID}"
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
## 完了条件
|
|
81
|
+
|
|
82
|
+
- `c-implementation.md` にフェーズ/ステップ/テスト/メモが記載されている
|
|
83
|
+
- ステップの粒度が適切(1〜3 時間)で、成果物が明確
|
|
84
|
+
- フェーズ順序と依存関係が示されている
|
|
85
|
+
- 関係者レビューで疑問がない状態
|
|
86
|
+
|
|
87
|
+
## エスカレーション
|
|
88
|
+
|
|
89
|
+
- **フェーズが大きすぎる**: 「1 フェーズが 3 日以上になりそうです。分割してください。」
|
|
90
|
+
- **ステップが抽象的**: 「成果物が特定できません。ファイル名や検証手順を明記してください。」
|
|
91
|
+
- **テスト計画不足**: 「対象機能のテスト戦略が不足しています。ユニット/統合/E2E を再検討してください。」
|
|
92
|
+
- **リスク対策未反映**: 「b-003 で挙げたリスクへの対策ステップがありません。計画に組み込んでください。」
|
|
93
|
+
- **依存関係不明**: 「並行実行可能なフェーズと、順序が必要なフェーズを明示してください。」
|
|
94
|
+
|
|
95
|
+
## 参考
|
|
96
|
+
|
|
97
|
+
- [examples/phase-step-template.md](examples/phase-step-template.md) — フェーズ分割、ステップ分解、テスト計画の記載例
|
|
98
|
+
- [reference/structure-check.md](reference/structure-check.md) — 構造確認コマンド、チェックリスト、レビュー観点
|
|
@@ -1,79 +1,79 @@
|
|
|
1
|
-
# 評価基準・修正ガイダンス
|
|
2
|
-
|
|
3
|
-
SKILL.md 手順5「実装開始可否の判定」で参照する基準とアクション。
|
|
4
|
-
|
|
5
|
-
## 総合評価の基準
|
|
6
|
-
|
|
7
|
-
- **優(実装開始OK)**: Error 0件、Warning 3件以下
|
|
8
|
-
- **良(軽微な修正後に実装開始)**: Error 0件、Warning 4-10件
|
|
9
|
-
- **可(修正後に実装開始)**: Error 1-3件、または Warning 11件以上
|
|
10
|
-
- **不可(大幅な見直しが必要)**: Error 4件以上
|
|
11
|
-
|
|
12
|
-
## 推奨アクション
|
|
13
|
-
|
|
14
|
-
- 総合評価が「優」「良」の場合:「実装開始可能です。`/c-001-implement-task` を実行してください。」
|
|
15
|
-
- 総合評価が「可」の場合:「Error を修正後、実装を開始してください。」
|
|
16
|
-
- 総合評価が「不可」の場合:「タスクドキュメント全体の見直しが必要です。チームでレビュー会議を実施することを推奨します。」
|
|
17
|
-
|
|
18
|
-
## 修正ガイダンス
|
|
19
|
-
|
|
20
|
-
検出された問題について、修正方法を提案:
|
|
21
|
-
|
|
22
|
-
- Errorが検出された場合:「以下の問題を優先的に修正してください:」
|
|
23
|
-
- 修正すべきドキュメントとスキルを案内:
|
|
24
|
-
- 例:「ユーザーストーリーUS-002に対応する実装ステップがありません → `/b-004-create-task-implementation` で実装計画を更新」
|
|
25
|
-
- 例:「受け入れ基準が一致していません → `/b-002-create-task-definition` でタスク定義を見直し」
|
|
26
|
-
|
|
27
|
-
ユーザーに確認:「今すぐ修正作業を開始しますか?それとも後で個別に修正しますか?」
|
|
28
|
-
|
|
29
|
-
## ベストプラクティス
|
|
30
|
-
|
|
31
|
-
- **実装開始前に必ず実行**: c-001 実行前に b-005 でレビューし、問題を早期発見
|
|
32
|
-
- **段階的レビュー**: b-001完了後、b-002完了後、b-003完了後の各段階で部分レビューを実施
|
|
33
|
-
- **チームレビュー**: 重要なタスクや大規模なタスクはチーム全体でレビュー会議を実施
|
|
34
|
-
- **継続的更新**: 実装中に新しい発見があれば、ドキュメントを更新し、再レビュー
|
|
35
|
-
- **メトリクス記録**: レビュー結果(Error数、Warning数)を記録し、タスク品質を追跡
|
|
36
|
-
- **フィードバックループ**: レビュー結果を基にテンプレートや次のタスクを改善
|
|
37
|
-
|
|
38
|
-
## 参考: レビュー対象ドキュメント構造
|
|
39
|
-
|
|
40
|
-
**a-definition.md(タスク定義)**:
|
|
41
|
-
|
|
42
|
-
- 目的(解決する問題、提供する価値)
|
|
43
|
-
- ユーザーストーリー一覧
|
|
44
|
-
- 変更内容一覧(画面、データモデル、API、その他)
|
|
45
|
-
- 受け入れ基準
|
|
46
|
-
|
|
47
|
-
**b-research.md(リサーチ)**:
|
|
48
|
-
|
|
49
|
-
- ベストプラクティス
|
|
50
|
-
- 既存コードの調査
|
|
51
|
-
- 再利用可能なコンポーネント
|
|
52
|
-
- 技術選定
|
|
53
|
-
- 技術的リスクと制約
|
|
54
|
-
|
|
55
|
-
**c-implementation.md(実装計画)**:
|
|
56
|
-
|
|
57
|
-
- フェーズ(目的、完了条件)
|
|
58
|
-
- ステップ(成果物、詳細)
|
|
59
|
-
- 受け入れ基準
|
|
60
|
-
|
|
61
|
-
## 参考: タスクライフサイクルにおける位置づけ
|
|
62
|
-
|
|
63
|
-
```
|
|
64
|
-
b-001: タスクディレクトリ作成
|
|
65
|
-
↓
|
|
66
|
-
b-002: タスク定義作成
|
|
67
|
-
↓
|
|
68
|
-
b-003: リサーチ実施
|
|
69
|
-
↓
|
|
70
|
-
b-004: 実装計画作成
|
|
71
|
-
↓
|
|
72
|
-
b-005: タスクレビュー ← このスキル
|
|
73
|
-
↓
|
|
74
|
-
c-001: 実装実行
|
|
75
|
-
↓
|
|
76
|
-
c-002: ドキュメント更新
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
b-005 は実装開始前の「最後の砦」として、タスクの品質と実現可能性を保証する重要な役割を果たします。
|
|
1
|
+
# 評価基準・修正ガイダンス
|
|
2
|
+
|
|
3
|
+
SKILL.md 手順5「実装開始可否の判定」で参照する基準とアクション。
|
|
4
|
+
|
|
5
|
+
## 総合評価の基準
|
|
6
|
+
|
|
7
|
+
- **優(実装開始OK)**: Error 0件、Warning 3件以下
|
|
8
|
+
- **良(軽微な修正後に実装開始)**: Error 0件、Warning 4-10件
|
|
9
|
+
- **可(修正後に実装開始)**: Error 1-3件、または Warning 11件以上
|
|
10
|
+
- **不可(大幅な見直しが必要)**: Error 4件以上
|
|
11
|
+
|
|
12
|
+
## 推奨アクション
|
|
13
|
+
|
|
14
|
+
- 総合評価が「優」「良」の場合:「実装開始可能です。`/c-001-implement-task` を実行してください。」
|
|
15
|
+
- 総合評価が「可」の場合:「Error を修正後、実装を開始してください。」
|
|
16
|
+
- 総合評価が「不可」の場合:「タスクドキュメント全体の見直しが必要です。チームでレビュー会議を実施することを推奨します。」
|
|
17
|
+
|
|
18
|
+
## 修正ガイダンス
|
|
19
|
+
|
|
20
|
+
検出された問題について、修正方法を提案:
|
|
21
|
+
|
|
22
|
+
- Errorが検出された場合:「以下の問題を優先的に修正してください:」
|
|
23
|
+
- 修正すべきドキュメントとスキルを案内:
|
|
24
|
+
- 例:「ユーザーストーリーUS-002に対応する実装ステップがありません → `/b-004-create-task-implementation` で実装計画を更新」
|
|
25
|
+
- 例:「受け入れ基準が一致していません → `/b-002-create-task-definition` でタスク定義を見直し」
|
|
26
|
+
|
|
27
|
+
ユーザーに確認:「今すぐ修正作業を開始しますか?それとも後で個別に修正しますか?」
|
|
28
|
+
|
|
29
|
+
## ベストプラクティス
|
|
30
|
+
|
|
31
|
+
- **実装開始前に必ず実行**: c-001 実行前に b-005 でレビューし、問題を早期発見
|
|
32
|
+
- **段階的レビュー**: b-001完了後、b-002完了後、b-003完了後の各段階で部分レビューを実施
|
|
33
|
+
- **チームレビュー**: 重要なタスクや大規模なタスクはチーム全体でレビュー会議を実施
|
|
34
|
+
- **継続的更新**: 実装中に新しい発見があれば、ドキュメントを更新し、再レビュー
|
|
35
|
+
- **メトリクス記録**: レビュー結果(Error数、Warning数)を記録し、タスク品質を追跡
|
|
36
|
+
- **フィードバックループ**: レビュー結果を基にテンプレートや次のタスクを改善
|
|
37
|
+
|
|
38
|
+
## 参考: レビュー対象ドキュメント構造
|
|
39
|
+
|
|
40
|
+
**a-definition.md(タスク定義)**:
|
|
41
|
+
|
|
42
|
+
- 目的(解決する問題、提供する価値)
|
|
43
|
+
- ユーザーストーリー一覧
|
|
44
|
+
- 変更内容一覧(画面、データモデル、API、その他)
|
|
45
|
+
- 受け入れ基準
|
|
46
|
+
|
|
47
|
+
**b-research.md(リサーチ)**:
|
|
48
|
+
|
|
49
|
+
- ベストプラクティス
|
|
50
|
+
- 既存コードの調査
|
|
51
|
+
- 再利用可能なコンポーネント
|
|
52
|
+
- 技術選定
|
|
53
|
+
- 技術的リスクと制約
|
|
54
|
+
|
|
55
|
+
**c-implementation.md(実装計画)**:
|
|
56
|
+
|
|
57
|
+
- フェーズ(目的、完了条件)
|
|
58
|
+
- ステップ(成果物、詳細)
|
|
59
|
+
- 受け入れ基準
|
|
60
|
+
|
|
61
|
+
## 参考: タスクライフサイクルにおける位置づけ
|
|
62
|
+
|
|
63
|
+
```
|
|
64
|
+
b-001: タスクディレクトリ作成
|
|
65
|
+
↓
|
|
66
|
+
b-002: タスク定義作成
|
|
67
|
+
↓
|
|
68
|
+
b-003: リサーチ実施
|
|
69
|
+
↓
|
|
70
|
+
b-004: 実装計画作成
|
|
71
|
+
↓
|
|
72
|
+
b-005: タスクレビュー ← このスキル
|
|
73
|
+
↓
|
|
74
|
+
c-001: 実装実行
|
|
75
|
+
↓
|
|
76
|
+
c-002: ドキュメント更新
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
b-005 は実装開始前の「最後の砦」として、タスクの品質と実現可能性を保証する重要な役割を果たします。
|