Taskmate

🚀 タスクマネージャー使用ガイド

このタスクマネージャーは、タスクの管理を効率的に行うためのツールです。ユーザーはタスクの作成、編集、削除などの操作が簡単に行えます。また、タスクデータは自動的に保存され、後で参照することができます。

🚀 クイックスタート

このセクションでは、タスクマネージャーの基本的な使い方を説明します。

📦 インストール

本プロジェクトのインストールには、requirements.txtに記載された依存パッケージをインストールする必要があります。以下のコマンドを実行してください。

pip install -r requirements.txt

🏗️ プロジェクト構造

ディレクトリ構造

TaskMateAI/
├── src/
│   └── TaskMateAI/
│       ├── __init__.py      # パッケージ初期化ファイル
│       └── __main__.py      # メインアプリケーションコード
├── output/                  # データ保存ディレクトリ
│   └── tasks.json           # タスクデータ（自動生成）
├── tests/                   # テストコード
│   ├── unit/                # 単体テスト
│   │   └── __init__.py
│   ├── integration/         # 統合テスト
│   └── conftest.py          # テスト fixtures 定義ファイル
├── requirements.txt         # 依存パッケージリスト
└── README.md                # このファイル

ディレクトリ構造の説明

1. src/TaskMateAI：メインプログラムコードとパッケージ初期化ファイルが含まれています。
2. output/：自動生成されたタスクデータファイルを保存するために使用されます。
3. tests/：テストコードが含まれており、単体テストと統合テストに分かれています。
4. requirements.txt：プロジェクトに必要なサードパーティライブラリの依存関係が列挙されています。
5. README.md：プロジェクトの概要と使用ガイドが記載されています。

タスクデータの保存

すべてのタスクデータはoutput/tasks.jsonファイルに自動的に保存されます。タスクに対する操作を行うたびに、このファイルは更新されます。

🧪 テスト構造

テストコードはtests/ディレクトリにあり、以下の構造を持っています。

tests/
├── __init__.py           # テストパッケージ初期化ファイル
├── conftest.py           # テスト fixtures 定義ファイル
├── unit/                 # 単体テスト
│   ├── __init__.py
│   ├── test_task_utils.py       # タスク関連ユーティリティのテスト
│   ├── test_mcp_tools.py        # MCP ツール機能のテスト
│   └── test_agent_projects.py   # エージェントとプロジェクト管理機能のテスト
└── integration/          # 統合テスト
    └── __init__.py

🧪 テストの実行方法

全てのテストを実行する

cd /path/to/TaskMateAI
uv run python -m pytest -xvs

特定のテストファイルを実行する

uv run python -m pytest -xvs tests/unit/test_task_utils.py

特定のテストクラスを実行する

uv run python -m pytest -xvs tests/unit/test_mcp_tools.py::TestMCPTools

特定のテスト関数を実行する

uv run python -m pytest -xvs tests/unit/test_task_utils.py::TestTaskUtils::test_read_tasks_with_data

🚀 将来の改善計画

• タスクテンプレート機能の実装
• タスク間の依存関係管理システムの構築
• カレンダー機能の追加
• タグ分類システムの導入
• マイルストーン管理機能の実装

📄 ライセンス

MIT

👤 作者情報

NewAITees