核心用法
task-specialist 是一套纯 Bash + SQLite 构建的本地 CLI 任务管理工具，专为 AI Agent 执行多步骤项目而设计。安装仅依赖 sqlite3 与 bash，通过 install.sh 一键部署，可选创建 ~/.local/bin 快捷命令。
核心工作流围绕任务生命周期展开：
- 创建与分解：
task create建立任务并支持优先级（1-10）与项目归类；task break将复杂任务拆分为带自动依赖链的子任务 - 状态流转：
pending→start→in_progress，遇阻可block并记录原因，完成后complete自动解除下游依赖阻塞 - 依赖管理：
task depend建立显式依赖，启动前强制校验，完成后级联解锁 - 监控机制：
task-heartbeat定期更新存活时间，task stuck识别 30 分钟无活动的进行中任务
数据完全本地持久化，Schema 简洁（tasks + dependencies 双表），支持按状态、项目、父任务、日期范围及正则搜索。
显著优点
| 维度 | 表现 |
|------|------|
| **离线可靠** | 零网络依赖，SQLite 文件即数据库，适合离线/敏感环境 |
| **Agent 原生** | 文档明确面向 AI Agent 设计，强调任务分解、状态透明、依赖管理三大原则 |
| **安全干净** | 无 `eval()`、无外部 API、无加密操作，VirusTotal 全绿通过 |
| **输入防护** | 整数校验、状态白名单、日期正则、单引号转义、临时文件 SQL 投递，多层防注入 |
| **自动化友好** | 纯文本输出、退出码明确、支持脚本集成（如 `while` 循环内调用 `task-heartbeat`） |
| **依赖自动化** | `task break` 自动链式依赖，`complete` 自动级联解阻塞，减少人工维护 |
潜在局限
- 单用户本地：无多用户协作、无云端同步、无 Web 界面
- 功能边界：不支持甘特图、燃尽图等可视化；无标签系统（仅项目字段）
- 生态集成：暂无与 Git、CI/CD、Slack 等工具的官方集成，需自行脚本桥接
- 并发控制：SQLite 的 WAL 模式可支持并发读，但文档未明确说明并发写入策略
适合人群
- 需要离线运行的 AI Agent 或自动化脚本
- 追求极简、可审计、无供应商锁定的个人开发者或小团队
- 希望任务数据完全本地掌控，拒绝 SaaS 隐私风险的场景
常规风险
- 数据备份：SQLite 文件需自行纳入备份策略，无内置快照机制
- 权限管理：数据库文件权限依赖操作系统，多用户共享需手动控制文件 ACL
- 长期维护：Bash 脚本规模扩大后可读性下降，大型项目可能需迁移至更重型工具