Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
ファイルパスの設定が一部ズレてたのを修正
tdd-greenで積極的にモックを使うのを修正
その他細かい改善
  • Loading branch information
makotan committed Jul 31, 2025
commit 2c5e16487a75b219a479e3a17e384b0a7dd4cd3f
94 changes: 89 additions & 5 deletions commands/direct-verify.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,19 +12,27 @@ DIRECTタスクで実行した設定作業の動作確認とテストを行い

## 実行内容

**【重要】**: direct-setupで作成されたファイルについて、コンパイルエラーや構文エラーが見つかった場合は自動的に解決を試行します。

1. **設定の確認**
- 環境変数の確認
- 設定ファイルの内容確認
- 依存関係のインストール状況確認
- サービスの起動状況確認

2. **動作テストの実行**
2. **コンパイル・構文確認**
- TypeScript/JavaScript構文エラーチェック(該当する場合)
- 設定ファイルの構文確認(JSON, YAML等)
- SQL構文確認(該当する場合)
- 最低限のコンパイルエラー解消

3. **動作テストの実行**
- 基本的な動作確認
- 接続テスト
- 権限の確認
- エラーケースの確認

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

## コンパイル・構文チェック結果

### 1. TypeScript/JavaScript構文チェック

```bash
# TypeScriptファイルがある場合
npx tsc --noEmit --skipLibCheck

# JavaScript構文チェック
node --check *.js
```

**チェック結果**:

- [x] TypeScript構文エラー: なし
- [x] JavaScript構文エラー: なし
- [x] import/require文: 正常

### 2. 設定ファイル構文チェック

```bash
# JSON設定ファイルの構文チェック
cat config/*.json | jq empty

# YAML設定ファイルの構文チェック(該当する場合)
yamllint config/*.yml
```

**チェック結果**:

- [x] JSON構文: 正常
- [x] YAML構文: 正常(該当する場合)
- [x] 設定項目の妥当性: 確認済み

### 3. SQL構文チェック(該当する場合)

```bash
# SQL構文の基本チェック
psql -d mydb --single-transaction --set ON_ERROR_STOP=on -f schema.sql --dry-run
```

**チェック結果**:

- [x] SQL構文: 正常
- [x] テーブル定義: 正常
- [x] 制約定義: 正常

### 3. 依存関係の確認

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

## 発見された問題
## 発見された問題と解決

### 構文エラー・コンパイルエラーの解決

**自動解決を試行する問題**:
- TypeScript/JavaScript構文エラー
- JSON/YAML構文エラー
- 基本的なSQL構文エラー
- import/require文の問題

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

- **問題内容**: {問題の詳細}
- **発見方法**: {構文チェック/コンパイル/動作テスト}
- **重要度**: {高/中/低}
- **対処法**: {対処方法}
- **ステータス**: {解決済み/対応中/未対応}
- **自動解決**: {実行した解決コマンド・修正内容}
- **解決結果**: {解決済み/手動対応が必要}

### 解決実行ログ

```bash
# 実行した解決コマンド例
# 構文エラー修正
sed -i 's/typo/correct/g' config.js

# 依存関係の修正
npm install missing-package

# 設定ファイル修正
jq '.port = 3000' config.json > temp.json && mv temp.json config.json
```

**解決結果**:
- [x] 問題1: 解決済み
- [x] 問題2: 解決済み
- [ ] 問題3: 手動対応が必要(詳細は推奨事項に記載)

## 推奨事項

Expand Down Expand Up @@ -214,6 +297,7 @@ ps aux | grep node
### 完了条件
以下の条件を全て満たす場合にタスクを完了とマークします:
- [ ] 全ての設定確認項目がクリア
- [ ] コンパイル・構文チェックが成功(エラーがすべて解決済み)
- [ ] 全ての動作テストが成功
- [ ] 品質チェック項目が基準を満たしている
- [ ] 発見された問題が適切に対処されている
Expand Down
62 changes: 46 additions & 16 deletions commands/kairo-design.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,23 @@
# kairo-design

## 目的

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

## 前提条件

- `docs/spec/` に要件定義書が存在する
- 要件がユーザによって承認されている

## 実行内容

**【信頼性レベル指示】**:
各項目について、元の資料(EARS要件定義書・設計文書含む)との照合状況を以下の信号でコメントしてください:

- 🟢 **青信号**: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
- 🟡 **黄信号**: EARS要件定義書・設計文書から妥当な推測の場合
- 🔴 **赤信号**: EARS要件定義書・設計文書にない推測の場合

1. **要件の分析**
- 要件定義書を読み込む
- 機能要件と非機能要件を整理する
Expand Down Expand Up @@ -52,61 +61,73 @@
## 出力フォーマット例

### architecture.md

```markdown
# {要件名} アーキテクチャ設計

## システム概要

{システムの概要説明}

## アーキテクチャパターン

- パターン: {選択したパターン}
- 理由: {選択理由}

## コンポーネント構成

### フロントエンド

- フレームワーク: {使用フレームワーク}
- 状態管理: {状態管理方法}

### バックエンド

- フレームワーク: {使用フレームワーク}
- 認証方式: {認証方法}

### データベース

- DBMS: {使用するDBMS}
- キャッシュ: {キャッシュ戦略}
```

### dataflow.md

```markdown
# データフロー図

## ユーザーインタラクションフロー

\`\`\`mermaid
flowchart TD
A[ユーザー] --> B[フロントエンド]
B --> C[API Gateway]
C --> D[バックエンド]
D --> E[データベース]
A[ユーザー] --> B[フロントエンド]
B --> C[API Gateway]
C --> D[バックエンド]
D --> E[データベース]
\`\`\`

## データ処理フロー

\`\`\`mermaid
sequenceDiagram
participant U as ユーザー
participant F as フロントエンド
participant B as バックエンド
participant D as データベース
participant U as ユーザー
participant F as フロントエンド
participant B as バックエンド
participant D as データベース

U->>F: アクション
F->>B: APIリクエスト
B->>D: クエリ実行
D-->>B: 結果返却
B-->>F: レスポンス
F-->>U: 画面更新

\`\`\`
```

### interfaces.ts

```typescript
// エンティティ定義
export interface User {
Expand Down Expand Up @@ -135,6 +156,7 @@ export interface ApiResponse<T> {
```

### database-schema.sql

```sql
-- ユーザーテーブル
CREATE TABLE users (
Expand All @@ -150,38 +172,46 @@ CREATE INDEX idx_users_email ON users(email);
```

### api-endpoints.md

```markdown
# API エンドポイント仕様

## 認証

### POST /auth/login

リクエスト:
\`\`\`json
{
"email": "[email protected]",
"password": "password"
"email": "[email protected]",
"password": "password"
}
\`\`\`

レスポンス:
\`\`\`json
{
"success": true,
"data": {
"token": "jwt-token",
"user": { ... }
}
"success": true,
"data": {
"token": "jwt-token",
"user": { ... }
}
}
\`\`\`

## ユーザー管理

### GET /users/:id

### POST /users

### PUT /users/:id

### DELETE /users/:id
```

## 実行後の確認

- 作成したファイルの一覧を表示
- 設計の主要なポイントをサマリーで表示
- ユーザに確認を促すメッセージを表示
9 changes: 9 additions & 0 deletions commands/kairo-implement.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,25 @@
# kairo-implement

## 目的

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

## 前提条件

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

## 実行内容

**【信頼性レベル指示】**:
各項目について、元の資料(EARS要件定義書・設計文書含む)との照合状況を以下の信号でコメントしてください:

- 🟢 **青信号**: EARS要件定義書・設計文書を参考にしてほぼ推測していない場合
- 🟡 **黄信号**: EARS要件定義書・設計文書から妥当な推測の場合
- 🔴 **赤信号**: EARS要件定義書・設計文書にない推測の場合

1. **タスクの選択**
- ユーザが指定したタスクIDを確認
- 指定がない場合は、依存関係に基づいて次のタスクを自動選択
Expand Down
Loading