tick-md

🎯 Git 原生多智能体协作中枢

基于 Git 的多智能体任务协调协议,通过结构化 Markdown 实现人机协作透明化管理,本地优先无需云端。

收藏
3.4k
安装
886
版本
v1.3.3
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

Tick Multi-Agent Coordination 是一套基于 Git 的多智能体任务协调协议,核心通过 TICK.md 文件实现人机协作的透明化管理。用户以自然语言与 AI 交互,AI 自动在后台维护任务状态。主要工作流包括:初始化项目(tick init)、创建任务(tick add)、认领任务(tick claim)、添加进度注释(tick comment)、标记完成(tick done)以及同步到 Git(tick sync)。支持 MCP 协议调用,提供 tick_statustick_addtick_claim 等工具函数,方便 AI Agent 直接集成。

显著优点

本地优先与隐私保护:所有数据存储在本地 TICK.md 文件,无需云端服务,完全避免数据泄露风险。Git 原生集成:完整的版本控制和审计追踪,任务历史可追溯,支持团队协作。人机协作友好:用户无需学习复杂命令,AI 自动维护任务状态,降低使用门槛。结构化透明:标准 Markdown + YAML 格式,既人类可读又机器可解析。多智能体支持:支持人类和 AI Agent 注册、角色分配、任务认领与协调。依赖管理智能:自动处理任务依赖关系,完成父任务后自动解锁子任务,支持循环依赖检测。

潜在缺点与局限性

外部依赖较重:核心功能依赖 tick-md CLI 和 tick-mcp-server npm 包,需 Node.js >=18 环境,增加了部署复杂度。生态成熟度有限:作为社区项目(T3 来源),相比 Jira、Linear 等商业工具,企业级支持和插件生态较弱。无可视化界面:纯命令行和文本交互,对习惯 GUI 的用户不够直观。学习成本:虽然用户交互简单,但完整掌握 Tick Protocol 的进阶功能(批量操作、依赖图、MCP 配置)需要一定学习时间。协作规模限制:基于文件锁定的 Git 协作方式,在超大规模团队(数十人以上同时编辑)可能遇到合并冲突。

适合的目标群体

AI 辅助开发团队:希望 AI Agent 参与项目管理、自动跟踪任务进度的技术团队。隐私敏感型项目:对数据主权有严格要求,拒绝 SaaS 工具的企业和个人开发者。Git 原生工作流拥护者:已经深度使用 Git,希望项目管理与代码仓库无缝集成的团队。多智能体实验者:研究人机协作、多 AI Agent 协调的研究者和早期采用者。小型到中型项目:5-20 人规模的敏捷团队,追求轻量级、可自托管的解决方案。

使用风险

依赖包安全风险:虽然 Skill 本身纯文档,但实际执行逻辑在 tick-mdtick-mcp-server npm 包中,需信任这些依赖的来源和更新。版本兼容性:Node.js 版本要求(>=18)可能在旧环境中无法运行。MCP 配置风险:若 MCP Server 配置不当,可能授予 AI 过高的文件系统权限。Git 操作冲突:多人同时修改 TICK.md 可能产生合并冲突,需要团队约定协作规范。功能边界模糊:AI 自动维护任务与用户手动编辑的边界需明确,避免状态不一致。

安全解读

核心功能与用法

Tick Multi-Agent Coordination 是一套基于结构化 Markdown 文件的多代理任务协调协议。用户通过自然语言与 AI 交互,AI 则在后台透明维护 TICK.md 文件,实现人机与 AI 代理之间的无缝协作。

核心工作流程
1. 初始化tick init 创建项目

2. 任务创建tick add "任务标题" --priority high --tags 标签

3. 代理注册tick agent register @代理名 --type bot --roles 角色

4. 任务认领tick claim TASK-XXX @代理名

5. 进度更新tick comment TASK-XXX @代理名 --note "进度说明"

6. 任务完成tick done TASK-XXX @代理名

关键特性

  • 人机可读:标准 Markdown + YAML,Git 原生版本控制
  • 依赖管理:自动解锁依赖任务,检测循环依赖
  • 批量操作:支持 import、batch 模式处理大量任务
  • 实时监控tick watch 实时追踪变更
  • MCP 支持:提供 Model Context Protocol 工具集,替代 CLI 调用

显著优点

1. 透明协作:TICK.md 文件对所有参与者可见,消除信息孤岛
2. 本地优先:无需云服务,数据完全自主掌控

3. Git 原生:完整的审计追踪、分支管理、冲突解决

4. 自然交互:用户无需学习命令,AI 自动处理底层操作

5. 灵活扩展:支持子任务、依赖图、多角色代理、时间估算

潜在局限

1. 外部依赖:核心功能依赖 tick-mdtick-mcp-server npm 包,需单独安装和审计
2. 学习成本:需理解 TICK.md 文件结构和 Git 工作流

3. 规模限制:超大型项目(数千任务)可能影响 Markdown 解析性能

4. 无可视化:依赖 tick graph 生成文本/Mermaid 图,无原生 GUI

5. 协作冲突:多人同时编辑 TICK.md 可能产生 Git 合并冲突

适合人群

  • AI 辅助开发团队:希望 AI 代理参与日常任务管理
  • Git 原生工作流用户:熟悉 Git 版本控制的开发者
  • 隐私敏感场景:需要本地优先、无云服务的项目管理
  • 多代理实验:探索人机混合团队协作模式
  • 技术文档驱动型团队:偏好 Markdown 格式的极客团队

常规风险

1. npm 包安全风险:实际执行代码位于外部 npm 包,建议安装前执行 npm audit
2. 数据丢失风险:TICK.md 文件需定期 tick sync --push 提交到 Git

3. 权限管理:代理注册后权限较宽,需通过 Git 权限控制访问

4. 状态不一致:直接编辑 TICK.md 可能破坏状态机,建议始终使用 CLI/MCP 工具

5. 版本兼容性:schema_version 升级可能导致旧文件解析失败

tick-md 内容

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