tick-md

✅ Git 驱动的多智能体任务协作中枢

基于 Git 的 Markdown 多智能体任务协调工具,支持 AI Agent 通过 MCP 协议认领任务、防止冲突、自动提交历史记录,实现人机协作的本地化工作流管理。

收藏
5.4k
安装
2k
版本
1.1.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

TICK.md 核心功能与综合评估

核心用法

TICK.md 是一款专为多智能体协作设计的任务管理工具,其核心创新在于将 Git 版本控制与 Markdown 结构化数据相结合。用户通过 tick-md CLI 或 MCP Server 与 TICK.md 文件交互,实现任务的创建、认领、状态更新和完成标记。文件采用 YAML frontmatter + Markdown 的混合格式,每个任务包含唯一 ID、状态机(backlog → todo → in_progress → review → blocked → done)、优先级、标签、依赖关系及完整操作历史。

典型工作流
1. 初始化项目并创建任务 tick add "任务描述" --priority high

2. 智能体认领任务 tick claim TASK-001 @agent-name

3. 执行工作并添加进度注释 tick comment TASK-001 @agent-name --note "进度更新"

4. 标记完成 tick done TASK-001 @agent-name

5. 自动触发 Git 提交生成审计轨迹

MCP 集成:作为 AI-Native 设计的关键组件,tick-mcp-server 将所有 CLI 命令暴露为 MCP 工具,使 Claude 等 Agent 能够通过自然语言直接操作任务系统,无需记忆复杂命令语法。

显著优点

1. 本地优先架构:完全离线运行,无需云服务,数据主权完全归属用户
2. Git 原生审计:每次状态变更自动生成带 [tick] 前缀的 Git 提交,提供不可篡改的历史记录和协作透明性

3. 智能冲突预防:通过 .tick.lock 文件锁机制防止多 Agent 并发编辑冲突,结合依赖自动解锁(当阻塞任务完成时自动将下游任务从 blocked 转为 todo)

4. 人机双模可读:Markdown 格式对人类友好,YAML frontmatter 对机器可解析,消除了传统看板工具的数据孤岛问题

5. 多 Agent 原生设计:从协议层面支持 @agent-name 标识、Agent 注册与信任配置、以及针对 OpenClaw 生态的完整集成指南

6. 可视化支持:内置 ASCII 艺术和 Mermaid 格式的依赖图生成

潜在局限

1. Git 门槛依赖:要求所有参与者具备基础 Git 操作能力,对非技术团队成员存在学习曲线
2. 无实时同步机制:依赖手动或定时 tick sync / git pull/push,非真正的实时协作(对比 Figma 或 Notion 的 OT 算法)

3. 规模天花板:纯文本文件在任务量超过数千条时可能出现性能瓶颈,缺乏数据库级的查询优化

4. 权限粒度粗:基于 Git 的权限模型,无法对单条任务设置细粒度访问控制

5. 移动端体验缺失:CLI/MCP 为中心的设计,无原生移动应用或响应式 Web 界面

适合人群

  • AI 工程团队:需要协调多个 Claude Code / OpenClaw bot 的并行开发
  • 技术型产品经理:偏好 Git 工作流、需要完整审计轨迹的敏捷团队
  • 隐私敏感组织:禁止云端任务数据的外部 SaaS 工具替代方案
  • 开源项目维护者:需要公开透明的工作分配和贡献记录

常规风险

1. Git 冲突风险:当多个 Agent 同时修改同一 TICK.md 文件的不同任务时,可能产生合并冲突(需依赖 Git 的自动合并或手动解决)
2. 锁机制失效:若 Agent 异常终止未释放 .tick.lock,可能导致死锁(配置 timeout: 300 秒可缓解)

3. Agent 身份伪造@agent-name 为自声明标识,恶意 Agent 可伪装他人认领任务(可通过 require_registration: true 和部署密钥绑定缓解)

4. 数据丢失风险--no-commit 模式或本地未推送的提交在硬件故障时可能丢失

5. 供应链安全:npm 包的篡改风险,建议锁定版本并使用 lockfile

tick-md 内容

手动下载zip · 6.8 kB
README.mdtext/markdown
请选择文件