TICK.md
通过 Git 支持的 Markdown 进行多智能体任务协调
使用结构化的 TICK.md 文件协调人类和 AI 代理之间的工作。基于 Git 构建，专为自然语言交互设计，针对多代理工作流进行了优化。
✨ 特性
- 🤖 AI 原生：MCP 服务器实现无缝机器人集成
- 📝 人类可读：带有 YAML 前言的纯 Markdown
- 🔄 Git 支持：完整的版本控制和自动审计追踪
- 🎯 依赖跟踪：自动解除任务阻塞
- 🔒 文件锁定：防止并发编辑冲突
- 🔍 高级过滤：按状态、优先级、标签查找任务
- 📊 可视化：依赖图（ASCII 和 Mermaid）
- 👀 实时监控：监听模式支持实时更新
- 🌐 本地优先：无需云服务，可离线运行
🚀 快速入门
安装 CLI
npm install -g tick-md
初始化项目
cd your-project
tick init
tick status
创建和认领任务
tick add "构建认证模块" --priority high --tags backend
tick claim TASK-001 @你的名字
tick done TASK-001 @你的名字
🤖 针对 AI 代理
安装 MCP 服务器
npm install -g tick-mcp-server
添加到你的 MCP 配置中（例如 ~/Library/Application Support/Claude/claude_desktop_config.json）：
{
"mcpServers": {
"tick": {
"command": "tick-mcp",
"args": [],
"env": {}
}
}
}
使用 MCP 工具
MCP 服务器将所有 CLI 命令暴露为工具：
tick_init- 初始化项目tick_add- 创建任务tick_claim- 为你的代理认领任务tick_done- 标记任务完成tick_status- 获取项目概览tick_list- 查询和过滤任务tick_comment- 添加进度备注
🎯 核心概念
TICK.md 文件结构
---
meta:
project_id: my-project
id_prefix: TASK
next_id: 4
updated: 2026-02-07T15:30:00-05:00
---
### TASK-001 · 构建用户认证
tick_config id: TASK-001
status: in_progress
priority: high
claimed_by: @claude-code
assigned_to: @claude-code
created_by: @gianni
created_at: 2026-02-07T10:00:00-05:00
updated_at: 2026-02-07T15:30:00-05:00
tags: [backend, auth]
depends_on: []
blocks: [TASK-002, TASK-003]
history:
- ts: 2026-02-07T10:00:00 who: @gianni action: created
- ts: 2026-02-07T15:30:00 who: @claude-code action: claimed
tick_config
> 构建基于 JWT 的认证系统，支持刷新令牌
自动 Git 提交
默认情况下，每次变更都会创建一个 git 提交：
[tick] TASK-001 被 @claude-code 认领
[tick] TASK-001 被 @claude-code 完成
[tick] TASK-003: 已创建
通过以下标志控制：
--commit- 强制提交--no-commit- 跳过提交- 或者在
.tick/config.yml中配置
任务状态
backlog- 尚未准备好开始todo- 可以认领in_progress- 正在处理中review- 等待审核blocked- 等待依赖完成done- 已完成
文件锁定
CLI 使用 .tick.lock 防止并发编辑。当一个代理认领任务时，它会获取锁定。其他代理会看到任务已被认领，无法修改。
📚 文档
- 协议规范：https://tick.md/docs/protocol
- CLI 参考：https://tick.md/docs/cli
- 入门指南：https://tick.md/docs/getting-started
💡 示例工作流
# 人类创建任务
tick add "构建着陆页" --priority high --tags frontend --assign @claude-code
tick add "编写发布邮件" --priority medium --tags content --assign @content-bot
tick add "E2E 测试" --priority medium --tags qa --depends-on TASK-001
# AI 代理接管工作
tick claim TASK-001 @claude-code
tick comment TASK-001 @claude-code --note "构建了响应式着陆页，包含英雄区域"
tick done TASK-001 @claude-code
# 另一个代理自动触发
tick claim TASK-003 @qa-bot
tick done TASK-003 @qa-bot --skip-review
🔧 配置
编辑 .tick/config.yml：
git:
auto_commit: true # 变更时自动提交（默认：true）
commit_prefix: "[tick]"
push_on_sync: false
locking:
enabled: true
timeout: 300
agents:
default_trust: full
require_registration: false
🌟 针对 OpenClaw 机器人的最佳实践
- 始终先认领再工作：
tick claim TASK-XXX @你的机器人名称 - 添加进度注释：
tick comment TASK-XXX @你的机器人名称 --note "状态更新" - 完成时标记完成：
tick done TASK-XXX @你的机器人名称 - 检查依赖：使用
tick list --blocked查找被阻塞的任务 - 使用 MCP 服务器：支持自然语言任务管理
🔧 OpenClaw 多代理设置
通过 TICK.md 协调多个 OpenClaw 机器人的分步指南。
1. 创建共享任务仓库
gh repo create yourorg/project-tasks --private
cd project-tasks
npx tick-md init
git add -A && git commit -m "init" && git push
2. 在每个 OpenClaw 机器人的服务器上
cd /data/.openclaw/workspace
git clone [email protected]:yourorg/project-tasks.git tasks
cd tasks && npx tick-md status
3. 添加到每个机器人的 AGENTS.md
## ✅ 任务协调 (TICK.md)
我通过 `./tasks/` 中的 TICK.md 与其他代理协调。
### 开始工作前：
1. `cd tasks && npx tick-md sync` — 获取最新
2. `npx tick-md list --status backlog --priority high` — 查找可用工作
3. `npx tick-md claim TASK-XXX @mybotname` — 在工作前认领
4. `npx tick-md done TASK-XXX @mybotname` — 标记完成
### 规则：
- **绝不处理其他代理已认领的任务**
- **始终先认领再开始**
- **工作前后同步**
4. 添加到每个机器人的 HEARTBEAT.md
## 任务同步 (TICK.md)
- [ ] 同步任务：`cd tasks && npx tick-md sync`
- [ ] 检查我的工作：`npx tick-md list --claimed-by @mybotname --status in_progress`
- [ ] 检查可用任务：`npx tick-md list --status backlog --priority high`
5. 部署密钥
每个机器人需要 SSH 访问共享仓库。在每个服务器上生成部署密钥：
ssh-keygen -t ed25519 -C "botname@tasks" -f ~/.ssh/tasks_deploy -N ""
cat ~/.ssh/tasks_deploy.pub
# 将其添加到仓库设置 → 部署密钥（具有写入权限）
配置 git 使用该密钥：
cd tasks
git config core.sshCommand "ssh -i ~/.ssh/tasks_deploy -o IdentitiesOnly=yes"
6. 机器人的同步命令
在执行任何 tick 变更后，推送更改：
cd tasks && git push
或者使用 tick sync，它会自动处理拉取和推送。
📦 包信息
- CLI：npm 上的
tick-md - MCP 服务器：npm 上的
tick-mcp-server - GitHub：https://github.com/Purple-Horizons/tick-md
- 许可证：MIT