marketing-shibata50/auto-project-management

柴田貴司 116bd7ac6f docs: Update installation and environment setup instructions

- Revised .env.example to include additional optional settings for Google Drive, Discord, and Todoist.
- Enhanced INSTALL.md with detailed setup steps, including clasp deployment instructions and troubleshooting tips.
- Updated README.md to streamline quick start guide and clarify environment variable setup.

2026-01-01 23:56:37 +09:00

8.9 KiB

Raw Blame History

Claude Code対話型Ganttチャート自動生成システム

Claude Codeとの対話でプロジェクトを設計し、JSONファイルを自動生成して、Google Apps Scriptでスプレッドシートに美しいGanttチャートを自動作成するシステムです。

🎯 機能概要

Phase 1: Claude Code側（このリポジトリ）

対話型プロジェクト設計: /gantt スラッシュコマンドで段階的にプロジェクト情報を入力
JSON自動生成: プロジェクト基本情報とタスク一覧を構造化JSONで出力
対話履歴保存: プロジェクト作成プロセスをMarkdown形式で記録
Google Driveアップロード: 生成したJSONファイルを自動アップロード

Phase 2: GAS側（✅ 実装完了）

自動Ganttチャート生成: JSONファイルからスプレッドシートに視覚的なGanttチャートを作成
4シート構成: プロジェクト一覧、全プロジェクトタスク、期日切れタスク、Todoistタスク、個別Ganttチャート
タスク管理機能: 進捗率、依存関係、担当者、優先度の管理
Todoist統合: TodoistのInboxタスクを自動同期してスプレッドシートで一元管理
期日切れタスク通知: 期日を過ぎたタスクを自動検出してDiscord通知
Discord通知: 成功/エラー通知をDiscordに自動送信

🏗️ システム構成

185-automatic-gantt-chart-creation/
├── .claude/
│   └── commands/
│       └── gantt.md            # /gantt スラッシュコマンド定義
├── src/
│   └── gantt-helper.ts         # ヘルパースクリプト（状態管理・JSON生成・Discord通知）
├── gas/                         # Google Apps Script ファイル ✨ NEW
│   ├── Config.gs               # 設定管理（スプレッドシートID、Discord、色設定）
│   ├── SheetManager.gs         # シート操作（作成、更新、データ投入）
│   ├── GanttRenderer.gs        # Ganttチャート描画（バー、ヘッダー、スタイル）
│   ├── Code.gs                 # メインスクリプト（実行エントリーポイント）
│   └── README.md               # GAS導入手順・使い方
├── outputs/                     # JSONファイル保存先
├── docs/                        # 対話履歴ファイル保存先
├── package.json                 # 依存関係
├── tsconfig.json                # TypeScript設定
├── .env.example                 # 環境変数テンプレート
├── .gitignore
└── README.md

🚀 クイックスタート

初めての方: 詳細なセットアップ手順は INSTALL.md をご覧ください。

3ステップでスタート

ステップ1: 依存関係のインストール

npm install
npm run build

ステップ2: 環境変数の設定

cp .env.example .env
# .envファイルを編集してGoogle Drive設定を追加

最小限の設定項目:

GOOGLE_DRIVE_FOLDER_ID=your_folder_id_here
GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here

📝 詳細: Google Cloud設定、OAuth認証の完全ガイドは INSTALL.md を参照

ステップ3: 初回認証とGantt作成

# Google認証（初回のみ）
npm run gantt:auth

# Claude Codeでプロジェクト作成
claude code
> /gantt

# JSONファイル生成・アップロード
npm run gantt:save

📝 GAS連携: スプレッドシート連携とトリガー設定は INSTALL.md を参照

📖 使い方

基本ワークフロー

1. Claude Codeで対話形式で作成

claude code
> /gantt

システムが段階的に質問します：

プロジェクト基本情報（ID、名前、目的、期限）
タスク設計（タスク名、日程、担当者、依存関係）

2. JSONファイル生成

対話完了後、「完了」と入力してから：

npm run gantt:save

これで以下が自動生成されます：

outputs/{プロジェクトID}_{プロジェクト名}.json
docs/{プロジェクトID}_{プロジェクト名}.md（対話履歴）

3. Ganttチャート自動生成

Google Driveにアップロード後、1分以内に自動的にスプレッドシートが更新されます。

📝 詳細: GASトリガー設定、手動実行方法は INSTALL.md を参照

📊 データ仕様

プロジェクトJSON形式

{
  "project_id": "PRJ001",
  "project_name": "新規ECサイト開発",
  "project_purpose": "個人事業",
  "project_type": "開発",
  "project_deadline": "2025-06-30",
  "tasks": [
    {
      "task_id": "T001",
      "task_name": "要件定義",
      "start_date": "2025-01-01",
      "end_date": "2025-01-15",
      "assignee": "山田太郎",
      "dependencies": [],
      "progress": 0,
      "priority": "★★★★★",
      "parent_task_id": null,
      "tags": ["企画・計画"],
      "estimated_hours": 40,
      "is_milestone": false
    }
  ]
}

タスクフィールド詳細

フィールド	型	説明	例
`task_id`	string	タスクID（自動採番）	`T001`, `T002`
`task_name`	string	タスク名	`要件定義`
`start_date`	string	開始日（YYYY-MM-DD）	`2025-01-01`
`end_date`	string	終了日（YYYY-MM-DD）	`2025-01-15`
`assignee`	string	担当者（フリーテキスト）	`山田太郎`
`dependencies`	array	依存タスクID配列	`["T001", "T002"]`
`progress`	number	進捗率（0-100）	`50`
`priority`	string	優先度（6段階★）	`★★★★★`
`parent_task_id`	string\|null	親タスクID	`T001` or `null`
`tags`	array	タグ配列	`["企画・計画", "技術"]`
`estimated_hours`	number	見積工数（時間）	`40`
`is_milestone`	boolean	マイルストーンフラグ	`true` or `false`

優先度（6段階）

★★★★★ - 最重要
★★★★☆ - 重要
★★★☆☆ - 中
★★☆☆☆ - 普通
★☆☆☆☆ - 低
☆☆☆☆☆ - 最低

タグ分類（10種類）

タグ名	色	説明
企画・計画	青	プロジェクト企画、要件定義
設計	緑	システム設計、UI/UX設計
開発・実装	黄	プログラミング、コーディング
テスト・検証	橙	テスト、品質保証
リリース・デプロイ	赤	リリース作業、デプロイ
運用・保守	紫	運用、保守、監視
マーケティング	ピンク	広告、プロモーション
営業・商談	水色	営業活動、商談
事務・管理	グレー	事務作業、管理業務
その他	白	上記以外

🔗 GAS統合

生成される5つのシート

プロジェクト一覧: 全プロジェクトのサマリー（ステータス、進捗率）
全プロジェクトタスク: タスクを一元管理、自動同期
期日切れタスク: 遅延タスクの自動抽出、Discord通知連携
Todoistタスク（オプション）: Inbox自動同期、優先度色分け
個別Ganttチャート: プロジェクトごとのタイムライン可視化

自動処理の仕組み

GAS側の時間トリガー（1分間隔）がGoogle Driveフォルダを監視し、新しいJSONファイルを自動処理します。

📝 詳細: GAS導入手順、clasp自動デプロイ、トリガー設定は INSTALL.md および gas/README.md を参照

🛠️ よくある質問

Q1. JSONファイルが生成されない

A: npm run build → npm run gantt:save を実行してください。

Q2. Google認証エラーが発生する

A: .envファイルのクライアントID/シークレット、リダイレクトURIを確認してください。

Q3. Ganttチャートが自動生成されない

A: GAS側の時間トリガー設定とConfig.gsのフォルダIDを確認してください。

📝 詳しいトラブルシューティング: INSTALL.md を参照

📝 ライセンス

MIT License

🙏 貢献

プルリクエストを歓迎します！バグ報告や機能要望はIssuesでお願いします。

📞 サポート

質問・問題がある場合は、Issuesでお問い合わせください。

8.9 KiB Raw Blame History Unescape Escape