272 lines
No EOL
9.4 KiB
Markdown
272 lines
No EOL
9.4 KiB
Markdown
# 自動継続ドキュメント - AutoContinuation Policy v1.0
|
||
|
||
**開発コード**: CMO-01-AUTO
|
||
**最終更新日**: 2026/03/09
|
||
**バージョン**: 1.0 (Initial Release)
|
||
|
||
---
|
||
|
||
## 🤖 仕組みの概要
|
||
|
||
このドキュメントは **「進んでください」とポストするだけで、自動的にコーディングが進行する仕組み**を定義します。
|
||
|
||
### 基本原理
|
||
```
|
||
┌─────────────────────────────────────────────────────┐
|
||
│ ユーザー │
|
||
│ ポスト:"進んでください" │
|
||
└─────────────────┬───────────────────────────────────┘
|
||
│
|
||
▼
|
||
┌──────────────────────────────────────────────┐
|
||
│ 自動継続エンジン (AutoContinuation) │
|
||
├──────────────────────────────────────────────┤
|
||
│ 1. short_term_plan.md で次タスク検索 │
|
||
├──────────────────────────────────────────────┤
|
||
│ 2. 優先度高い未着手タスクを選択 │
|
||
├──────────────────────────────────────────────┤
|
||
│ 3. 実装ロジックをコード化 │
|
||
├──────────────────────────────────────────────┤
|
||
│ 4. Git にコミット + ドキュメント更新 │
|
||
└──────────────────────────────────────────────┘
|
||
│
|
||
▼
|
||
┌──────────────────────────────────────────────┐
|
||
│ コーディング完了 │
|
||
└──────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 📋 自動化ルール
|
||
|
||
### R1. タスク選択ロジック（優先度付け）
|
||
|
||
| 条件 | 実装対象 |
|
||
|------|-------------|
|
||
| **UI 欠落** (保存ボタン未実装) | 優先度：HIGH ⚡️ |
|
||
| **API 接続不足** (DatabaseHelper 未接続) | 優先度：HIGH ⚡️ |
|
||
| **PDF 帳票出力** (Printing パッケージ使用準備) | 優先度：MEDIUM 📄 |
|
||
| **DocumentDirectory 保存** | 優先度：MEDIUM 💾 |
|
||
| **エラーハンドリング強化** | 優先度：LOW 🔧 |
|
||
| **UI/UX 改善** | 優先度：LOW 🎨 |
|
||
|
||
### R2. チェックリストテンプレート（次タスク決定用）
|
||
|
||
```markdown
|
||
- [ ] UI 要素確認（保存ボタン・共有アイコンなど）
|
||
- [ ] DatabaseHelper API 接続完了
|
||
- [ ] エラーハンドリング完全化（try-catch 追加）
|
||
- [ ] PDF 帳票出力ロジック実装
|
||
- [ ] DocumentDirectory 自動保存実装
|
||
```
|
||
|
||
### R3. コミットポリシー
|
||
|
||
```bash
|
||
# タスク実装完了時
|
||
git add <ファイル名>
|
||
git commit -m "feat: <機能名>実装 - short_term_plan.md 参照"
|
||
|
||
# ドキュメント更新（必須）
|
||
git add README.md docs/<ドキュメント名>.md
|
||
git commit -m "docs: <機能名>実装完了の記録"
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 次タスク決定アルゴリズム
|
||
|
||
### ステップ 1: short_term_plan.md を読み込み
|
||
|
||
```yaml
|
||
未着手タスク一覧:
|
||
- UI_欠落 (保存ボタン): priority=HIGH, status=TODO
|
||
- API_不足 (insertSales): priority=HIGH, status=TODO
|
||
- PDF_帳票出力：priority=MEDIUM, status=PENDING
|
||
```
|
||
|
||
### ステップ 2: 優先度が高いものを選択
|
||
|
||
**優先度 HIGH の条件**:
|
||
- UI 要素が欠落している
|
||
- API 接続が不十分
|
||
- エラーハンドリングがない
|
||
|
||
### ステップ 3: コード実装開始
|
||
|
||
```dart
|
||
// sales_screen.dart の例
|
||
Future<void> saveSalesData() async {
|
||
// DatabaseHelper.insertSales 接続
|
||
// エラーハンドリング強化
|
||
// UI フィードバック表示
|
||
}
|
||
```
|
||
|
||
### ステップ 4: ドキュメント更新
|
||
|
||
- README.md の「実装完了セクション」に追加
|
||
- short_term_plan.md でタスクチェックオフ
|
||
- 変更履歴に記録
|
||
|
||
---
|
||
|
||
## 🔧 自動化スクリプト定義（未来用）
|
||
|
||
### シェルスクリプトによる自動実行（開発中）
|
||
|
||
```bash
|
||
#!/bin/bash
|
||
# auto_continue.sh
|
||
|
||
# 1. short_term_plan.md を読み込み
|
||
TASK=$(grep "TODO" docs/short_term_plan.md | head -1)
|
||
|
||
# 2. タスク名をパース
|
||
FUNC_NAME=$(echo $TASK | awk '{print $3}')
|
||
|
||
# 3. 実装スクリプトを実行（コード生成）
|
||
flutter pub run code_generator:$FUNC_NAME
|
||
|
||
# 4. Git コミット
|
||
git add lib/ docs/README.md
|
||
git commit -m "feat: $FUNC_NAME実装"
|
||
|
||
# 5. PR 作成または直接コミット
|
||
git push origin master
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 自動化進捗ダッシュボード
|
||
|
||
| カテゴリ | 自動化レベル | 担当者 | ステータス |
|
||
|---------|--------------|--------|---------------|
|
||
| **タスク選択** | ✅ 自動 (AI) | AI エンジン | 進行中 |
|
||
| **コード生成** | ⚠️ 半自動 | 開発者 | 完了済み（manual） |
|
||
| **コミット** | ✅ 自動 | Git | 完了済み |
|
||
| **ドキュメント更新** | ✅ 自動（指示用） | 開発者 | 完了済み |
|
||
|
||
---
|
||
|
||
## 🚀 使用例：「進んでください」のフロー
|
||
|
||
```markdown
|
||
## ユーザーアクション
|
||
|
||
```
|
||
ユーザー: "進んでください"
|
||
```
|
||
|
||
## 自動化エンジン処理
|
||
|
||
1. **short_term_plan.md を読み込み**
|
||
```yaml
|
||
Sprint 5 タスク:
|
||
- [ ] 見積→請求転換 (priority=HIGH)
|
||
- [ ] Inventory モデル (priority=MEDIUM)
|
||
- [ ] PDF 領収書テンプレート (priority=LOW)
|
||
```
|
||
|
||
2. **優先度 HIGH のタスクを選択**
|
||
→ `見積→請求転換`
|
||
|
||
3. **実装コード生成**
|
||
```dart
|
||
// estimate_screen.dart に転換ボタン追加
|
||
// convertEstimateToInvoice() API 実装
|
||
// invoice_screen.dart の作成
|
||
```
|
||
|
||
4. **Git コミット + ドキュメント更新**
|
||
```bash
|
||
git add lib/ docs/README.md
|
||
git commit -m "feat: 見積→請求転換 UI 実装"
|
||
```
|
||
|
||
## 結果
|
||
|
||
- ✅ 3 分以内に新機能実装完了
|
||
- ✅ short_term_plan.md でチェックオフ
|
||
- ✅ README.md に更新記録追加
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 開発チームへの指示
|
||
|
||
### チームメンバー向けワークフロー
|
||
|
||
```
|
||
┌─────────────────────────────────────┐
|
||
│ 1. "進んでください" をポスト │
|
||
└─────────────────┬──────────────────┘
|
||
│
|
||
▼
|
||
┌────────────────────────────────┐
|
||
│ AI: 短時間プランを分析 │
|
||
├────────────────────────────────┤
|
||
│ AI: 次タスクを決定 │
|
||
├────────────────────────────────┤
|
||
│ AI: コードを生成・実装 │
|
||
└────────────────────────────────┘
|
||
│
|
||
▼
|
||
┌────────────────────────────────┐
|
||
│ 2-3 分後：完了報告 │
|
||
└────────────────────────────────┘
|
||
```
|
||
|
||
### チェックオフルール
|
||
|
||
| チェック項目 | 条件 | アクション |
|
||
|-------------|------|---------------|
|
||
| **UI 確認** | ボタン/アイコン追加済 | ✅ Check |
|
||
| **API 接続** | DatabaseHelper 動作確認済 | ✅ Check |
|
||
| **エラーハンドリング** | try-catch 完了 | ✅ Check |
|
||
| **ドキュメント更新** | README.md + short_term_plan | ✅ Check |
|
||
|
||
---
|
||
|
||
## 🎯 次のスプリント（Sprint 5）の自動継続計画
|
||
|
||
### プリセットされたタスクリスト
|
||
|
||
```yaml
|
||
# docs/short_term_plan.md に登録済み
|
||
Sprint 5 タスクリスト:
|
||
- 見積→請求転換 UI (priority=HIGH)
|
||
* estimate_screen.dart → convertEstimateToInvoice()
|
||
* invoice_screen.dart の作成
|
||
|
||
- Inventory モデル (priority=MEDIUM)
|
||
* inventory_model.dart の定義
|
||
* DatabaseHelper CRUD API
|
||
|
||
- PDF 領収書テンプレート (priority=LOW)
|
||
* receipt_template.dart の設計
|
||
|
||
- Google Sign-In (priority=PLANNING)
|
||
* google_sign_in.dart の実装
|
||
```
|
||
|
||
### 自動化ポリシー（Sprint 5 以降）
|
||
|
||
1. **毎週月曜日**: short_term_plan.md で次タスク確定
|
||
2. **毎日 "進んでください"**: AI がコードを実装
|
||
3. **完了確認**: README.md + Git log を参照
|
||
|
||
---
|
||
|
||
## 📚 リンク情報
|
||
|
||
- [工程管理ガイド](./engineering_management.md) - 全体方針
|
||
- [短期計画](./short_term_plan.md) - 次タスクリスト
|
||
- [長期計画](./long_term_plan.md) - ミレストーン目標
|
||
|
||
---
|
||
|
||
**最終更新**: 2026/03/09
|
||
**バージョン**: 1.0
|
||
**作成者**: AutoContinuation System |