9.4 KiB
9.4 KiB
自動継続ドキュメント - 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. チェックリストテンプレート（次タスク決定用）
- [ ] UI 要素確認（保存ボタン・共有アイコンなど）
- [ ] DatabaseHelper API 接続完了
- [ ] エラーハンドリング完全化（try-catch 追加）
- [ ] PDF 帳票出力ロジック実装
- [ ] DocumentDirectory 自動保存実装
R3. コミットポリシー
# タスク実装完了時
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 を読み込み
未着手タスク一覧:
- UI_欠落 (保存ボタン): priority=HIGH, status=TODO
- API_不足 (insertSales): priority=HIGH, status=TODO
- PDF_帳票出力：priority=MEDIUM, status=PENDING
ステップ 2: 優先度が高いものを選択
優先度 HIGH の条件:
- UI 要素が欠落している
- API 接続が不十分
- エラーハンドリングがない
ステップ 3: コード実装開始
// sales_screen.dart の例
Future<void> saveSalesData() async {
// DatabaseHelper.insertSales 接続
// エラーハンドリング強化
// UI フィードバック表示
}
ステップ 4: ドキュメント更新
- README.md の「実装完了セクション」に追加
- short_term_plan.md でタスクチェックオフ
- 変更履歴に記録
🔧 自動化スクリプト定義（未来用）
シェルスクリプトによる自動実行（開発中）
#!/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 | 完了済み |
| ドキュメント更新 | ✅ 自動（指示用） | 開発者 | 完了済み |
🚀 使用例：「進んでください」のフロー
## ユーザーアクション
ユーザー: "進んでください"
## 自動化エンジン処理
1. **short_term_plan.md を読み込み**
```yaml
Sprint 5 タスク:
- [ ] 見積→請求転換 (priority=HIGH)
- [ ] Inventory モデル (priority=MEDIUM)
- [ ] PDF 領収書テンプレート (priority=LOW)
-
優先度 HIGH のタスクを選択 →
見積→請求転換 -
実装コード生成
// estimate_screen.dart に転換ボタン追加 // convertEstimateToInvoice() API 実装 // invoice_screen.dart の作成 -
Git コミット + ドキュメント更新
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 以降）
- 毎週月曜日: short_term_plan.md で次タスク確定
- 毎日 "進んでください": AI がコードを実装
- 完了確認: README.md + Git log を参照
📚 リンク情報
最終更新: 2026/03/09
バージョン: 1.0
作成者: AutoContinuation System