Skip to content

Commit 2c5e164

Browse files
committed
ファイルパスの設定が一部ズレてたのを修正
tdd-greenで積極的にモックを使うのを修正 その他細かい改善
1 parent df29500 commit 2c5e164

13 files changed

+792
-200
lines changed

commands/direct-verify.md

Lines changed: 89 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,19 +12,27 @@ DIRECTタスクで実行した設定作業の動作確認とテストを行い
1212

1313
## 実行内容
1414

15+
**【重要】**: direct-setupで作成されたファイルについて、コンパイルエラーや構文エラーが見つかった場合は自動的に解決を試行します。
16+
1517
1. **設定の確認**
1618
- 環境変数の確認
1719
- 設定ファイルの内容確認
1820
- 依存関係のインストール状況確認
1921
- サービスの起動状況確認
2022

21-
2. **動作テストの実行**
23+
2. **コンパイル・構文確認**
24+
- TypeScript/JavaScript構文エラーチェック(該当する場合)
25+
- 設定ファイルの構文確認(JSON, YAML等)
26+
- SQL構文確認(該当する場合)
27+
- 最低限のコンパイルエラー解消
28+
29+
3. **動作テストの実行**
2230
- 基本的な動作確認
2331
- 接続テスト
2432
- 権限の確認
2533
- エラーケースの確認
2634

27-
3. **品質チェック**
35+
4. **品質チェック**
2836
- セキュリティ設定の確認
2937
- パフォーマンス基準の確認
3038
- ログの確認
@@ -77,6 +85,53 @@ cat config/database.json | jq .
7785
- [x] JSON形式が正しい
7886
- [x] 必要な設定項目が含まれている
7987

88+
## コンパイル・構文チェック結果
89+
90+
### 1. TypeScript/JavaScript構文チェック
91+
92+
```bash
93+
# TypeScriptファイルがある場合
94+
npx tsc --noEmit --skipLibCheck
95+
96+
# JavaScript構文チェック
97+
node --check *.js
98+
```
99+
100+
**チェック結果**:
101+
102+
- [x] TypeScript構文エラー: なし
103+
- [x] JavaScript構文エラー: なし
104+
- [x] import/require文: 正常
105+
106+
### 2. 設定ファイル構文チェック
107+
108+
```bash
109+
# JSON設定ファイルの構文チェック
110+
cat config/*.json | jq empty
111+
112+
# YAML設定ファイルの構文チェック(該当する場合)
113+
yamllint config/*.yml
114+
```
115+
116+
**チェック結果**:
117+
118+
- [x] JSON構文: 正常
119+
- [x] YAML構文: 正常(該当する場合)
120+
- [x] 設定項目の妥当性: 確認済み
121+
122+
### 3. SQL構文チェック(該当する場合)
123+
124+
```bash
125+
# SQL構文の基本チェック
126+
psql -d mydb --single-transaction --set ON_ERROR_STOP=on -f schema.sql --dry-run
127+
```
128+
129+
**チェック結果**:
130+
131+
- [x] SQL構文: 正常
132+
- [x] テーブル定義: 正常
133+
- [x] 制約定義: 正常
134+
80135
### 3. 依存関係の確認
81136

82137
```bash
@@ -175,14 +230,42 @@ ps aux | grep node
175230
- [x] 品質基準を満たしている
176231
- [x] 次のタスクに進む準備が整っている
177232

178-
## 発見された問題
233+
## 発見された問題と解決
234+
235+
### 構文エラー・コンパイルエラーの解決
236+
237+
**自動解決を試行する問題**:
238+
- TypeScript/JavaScript構文エラー
239+
- JSON/YAML構文エラー
240+
- 基本的なSQL構文エラー
241+
- import/require文の問題
179242

180243
### 問題1: {問題があれば記載}
181244

182245
- **問題内容**: {問題の詳細}
246+
- **発見方法**: {構文チェック/コンパイル/動作テスト}
183247
- **重要度**: {高/中/低}
184-
- **対処法**: {対処方法}
185-
- **ステータス**: {解決済み/対応中/未対応}
248+
- **自動解決**: {実行した解決コマンド・修正内容}
249+
- **解決結果**: {解決済み/手動対応が必要}
250+
251+
### 解決実行ログ
252+
253+
```bash
254+
# 実行した解決コマンド例
255+
# 構文エラー修正
256+
sed -i 's/typo/correct/g' config.js
257+
258+
# 依存関係の修正
259+
npm install missing-package
260+
261+
# 設定ファイル修正
262+
jq '.port = 3000' config.json > temp.json && mv temp.json config.json
263+
```
264+
265+
**解決結果**:
266+
- [x] 問題1: 解決済み
267+
- [x] 問題2: 解決済み
268+
- [ ] 問題3: 手動対応が必要(詳細は推奨事項に記載)
186269

187270
## 推奨事項
188271

@@ -214,6 +297,7 @@ ps aux | grep node
214297
### 完了条件
215298
以下の条件を全て満たす場合にタスクを完了とマークします:
216299
- [ ] 全ての設定確認項目がクリア
300+
- [ ] コンパイル・構文チェックが成功(エラーがすべて解決済み)
217301
- [ ] 全ての動作テストが成功
218302
- [ ] 品質チェック項目が基準を満たしている
219303
- [ ] 発見された問題が適切に対処されている

commands/kairo-design.md

Lines changed: 46 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,23 @@
11
# kairo-design
22

33
## 目的
4+
45
承認された要件定義書に基づいて、技術設計文書を生成する。データフロー図、TypeScriptインターフェース、データベーススキーマ、APIエンドポイントを含む包括的な設計を行う。
56

67
## 前提条件
8+
79
- `docs/spec/` に要件定義書が存在する
810
- 要件がユーザによって承認されている
911

1012
## 実行内容
1113

14+
**【信頼性レベル指示】**:
15+
各項目について、元の資料(EARS要件定義書・設計文書含む)との照合状況を以下の信号でコメントしてください:
16+
17+
- 🟢 **青信号**: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
18+
- 🟡 **黄信号**: EARS要件定義書・設計文書から妥当な推測の場合
19+
- 🔴 **赤信号**: EARS要件定義書・設計文書にない推測の場合
20+
1221
1. **要件の分析**
1322
- 要件定義書を読み込む
1423
- 機能要件と非機能要件を整理する
@@ -52,61 +61,73 @@
5261
## 出力フォーマット例
5362

5463
### architecture.md
64+
5565
```markdown
5666
# {要件名} アーキテクチャ設計
5767

5868
## システム概要
69+
5970
{システムの概要説明}
6071

6172
## アーキテクチャパターン
73+
6274
- パターン: {選択したパターン}
6375
- 理由: {選択理由}
6476

6577
## コンポーネント構成
78+
6679
### フロントエンド
80+
6781
- フレームワーク: {使用フレームワーク}
6882
- 状態管理: {状態管理方法}
6983

7084
### バックエンド
85+
7186
- フレームワーク: {使用フレームワーク}
7287
- 認証方式: {認証方法}
7388

7489
### データベース
90+
7591
- DBMS: {使用するDBMS}
7692
- キャッシュ: {キャッシュ戦略}
7793
```
7894

7995
### dataflow.md
96+
8097
```markdown
8198
# データフロー図
8299

83100
## ユーザーインタラクションフロー
101+
84102
\`\`\`mermaid
85103
flowchart TD
86-
A[ユーザー] --> B[フロントエンド]
87-
B --> C[API Gateway]
88-
C --> D[バックエンド]
89-
D --> E[データベース]
104+
A[ユーザー] --> B[フロントエンド]
105+
B --> C[API Gateway]
106+
C --> D[バックエンド]
107+
D --> E[データベース]
90108
\`\`\`
91109

92110
## データ処理フロー
111+
93112
\`\`\`mermaid
94113
sequenceDiagram
95-
participant U as ユーザー
96-
participant F as フロントエンド
97-
participant B as バックエンド
98-
participant D as データベース
99-
114+
participant U as ユーザー
115+
participant F as フロントエンド
116+
participant B as バックエンド
117+
participant D as データベース
118+
100119
U->>F: アクション
101120
F->>B: APIリクエスト
102121
B->>D: クエリ実行
103122
D-->>B: 結果返却
104123
B-->>F: レスポンス
105124
F-->>U: 画面更新
125+
106126
\`\`\`
107127
```
108128

109129
### interfaces.ts
130+
110131
```typescript
111132
// エンティティ定義
112133
export interface User {
@@ -135,6 +156,7 @@ export interface ApiResponse<T> {
135156
```
136157

137158
### database-schema.sql
159+
138160
```sql
139161
-- ユーザーテーブル
140162
CREATE TABLE users (
@@ -150,38 +172,46 @@ CREATE INDEX idx_users_email ON users(email);
150172
```
151173

152174
### api-endpoints.md
175+
153176
```markdown
154177
# API エンドポイント仕様
155178

156179
## 認証
180+
157181
### POST /auth/login
182+
158183
リクエスト:
159184
\`\`\`json
160185
{
161-
"email": "[email protected]",
162-
"password": "password"
186+
"email": "[email protected]",
187+
"password": "password"
163188
}
164189
\`\`\`
165190

166191
レスポンス:
167192
\`\`\`json
168193
{
169-
"success": true,
170-
"data": {
171-
"token": "jwt-token",
172-
"user": { ... }
173-
}
194+
"success": true,
195+
"data": {
196+
"token": "jwt-token",
197+
"user": { ... }
198+
}
174199
}
175200
\`\`\`
176201

177202
## ユーザー管理
203+
178204
### GET /users/:id
205+
179206
### POST /users
207+
180208
### PUT /users/:id
209+
181210
### DELETE /users/:id
182211
```
183212

184213
## 実行後の確認
214+
185215
- 作成したファイルの一覧を表示
186216
- 設計の主要なポイントをサマリーで表示
187217
- ユーザに確認を促すメッセージを表示

commands/kairo-implement.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,25 @@
11
# kairo-implement
22

33
## 目的
4+
45
分割されたタスクを順番に、またはユーザが指定したタスクを実装する。既存のTDDコマンドを活用して品質の高い実装を行う。
56

67
## 前提条件
8+
79
- `docs/tasks/{要件名}-tasks.md` にタスク一覧が存在する
810
- ユーザがタスクの実装を承認している
911
- 既存のTDDコマンドが利用可能である
1012
- 実装用のワークスペースが設定されている
1113

1214
## 実行内容
1315

16+
**【信頼性レベル指示】**:
17+
各項目について、元の資料(EARS要件定義書・設計文書含む)との照合状況を以下の信号でコメントしてください:
18+
19+
- 🟢 **青信号**: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
20+
- 🟡 **黄信号**: EARS要件定義書・設計文書から妥当な推測の場合
21+
- 🔴 **赤信号**: EARS要件定義書・設計文書にない推測の場合
22+
1423
1. **タスクの選択**
1524
- ユーザが指定したタスクIDを確認
1625
- 指定がない場合は、依存関係に基づいて次のタスクを自動選択

0 commit comments

Comments
 (0)