任务管理器使用指南

项目构造

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

测试执行方法

1. 执行所有测试：

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

2. 执行特定的测试文件：

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

3. 执行特定的测试类：

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

4. 执行特定的测试函数：

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

未来改进计划

• 实现任务模板功能
• 构建任务之间的依赖关系管理系统
• 添加日历功能
• 引入标签分类系统
• 实现里程碑管理功能

许可证

MIT

作者信息

NewAITees