todoist-mind

Todoist 管理器 Todoist 管理器 技能

This 技能 provides procedural 图形界面dance and 实用工具 scripts for interacting with the Todoist API.

Prerequisites

Configuration: The Todoist API 令牌 must be placed inside ./references/API_CONFIG.json in the todoist_API_令牌 field. The 令牌 is NOT read from 环境 variables.

Core 工作流s

• 添加 Task

Use this for creating new to-do items. The script must support 提取ing task detAIls.

Command 签名ature Example: scripts/todoist_API.py 添加_task --content "Финализировать отчет по проекту X" --project_id "123456" --due_date "tomorrow" --priority 2

Parameter Description Todoist Value M应用ing content The text of the task. Required project_id Tar获取 project ID. Optional due_date Date/Time for completion (e.g., "tomorrow", "today", "next friday 10am"). Optional (Use natural language recognized by Todoist API) priority Urgency level (1-4). Optional (1=High, 4=No Priority)

• Manage Task 状态 (Complete/删除)

Use for 状态 changes once a task ID is known.

Commands:

Complete: scripts/todoist_API.py complete_task --task_id "78901" 删除: scripts/todoist_API.py 删除_task --task_id "78901"

• Project Navigation

Use to 列出 avAIlable projects for tar获取ing new tasks.

Command:

列出 Projects: scripts/todoist_API.py 列出_projects

Note on Projects: Initial tests confirmed that the correct base URL 应用ears to be /API/v2/. Using a real 令牌 should yield a 列出 of projects or a 401/403 error if the 令牌 is invalid or lacks scope. The 端点 for 列出ing projects is /projects.

Current 状态

The API integration script, scripts/todoist_API.py, has been 创建d as a mock stub. It currently simulates API calls by printing the intended action and arguments to the console instead of hitting the live Todoist API.

This structure is now complete and ready for you to populate with your actual API 凭证s and implementation detAIls.

Resources (optional)

创建 only the resource directories this 技能 actually needs. 删除 this section if no resources are required.

scripts/

Executable code (Python/Bash/etc.) that can be 运行 directly to perform specific operations.

Examples from other 技能s:

PDF 技能: fill_fillable_fields.py, 提取_form_field_信息.py - utilities for PDF manipulation DOCX 技能: document.py, utilities.py - Python 模块s for document processing

应用ropriate for: Python scripts, shell scripts, or any executable code that performs 自动化, data processing, or specific operations.

Note: Scripts may be 执行d without loading into 上下文, but can still be read by Codex for 补丁ing or 环境 adjustments.

references/

Documentation and reference material intended to be loaded into 上下文 to 信息rm Codex's process and thinking.

Examples from other 技能s:

Product management: communication.md, 上下文_building.md - detAIled 工作流 图形界面des Big查询: API reference documentation and 查询 examples Finance: 模式 documentation, company policies

应用ropriate for: In-depth documentation, API references, database 模式s, comprehensive 图形界面des, or any detAIled in格式化ion that Codex should reference while working.

as设置s/

Files not intended to be loaded into 上下文, but rather used within the 输出 Codex produces.

Examples from other 技能s:

Brand styling: PowerPoint template files (.pptx), 记录o files Frontend 构建器: HTML/React boilerplate project directories Typography: Font files (.ttf, .woff2)

应用ropriate for: Templates, boilerplate code, document templates, images, icons, fonts, or any files meant to be copied or used in the final 输出.

Not every 技能 requires all three types of resources.