TICK.md

Git バックアップの Markdown によるマルチエージェントタスク調整

構造化された TICK.md ファイルを使用して、人間と AI エージェント間の作業を調整します。Git 上に構築され、自然言語でのやり取り向けに設計され、マルチエージェントワークフローに最適化されています。

✨ 機能

🤖 AI ネイティブ: シームレスなボット統合のための MCP サーバー
📝 人間可読: YAML フロントマター付きのプレーンマークダウン
🔄 Git バックアップ: 完全なバージョン管理と自動監査証跡
🎯 依存関係追跡: 自動タスクブロック解除
🔒 ファイルロック: 同時編集の競合を防止
🔍 高度なフィルタリング: ステータス、優先度、タグでタスクを検索
📊 可視化: 依存関係グラフ（ASCII および Mermaid）
👀 リアルタイム監視: ライブアップデートのウォッチモード
🌐 ローカルファースト: クラウド不要、オフラインでも動作

🚀 クイックスタート

CLI のインストール

npm install -g tick-md

プロジェクトの初期化

cd your-project
tick init
tick status

タスクの作成と主張

tick add "Build authentication" --priority high --tags backend
tick claim TASK-001 @yourname
tick done TASK-001 @yourname

🤖 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 · Build user authentication

\`\`\`yaml
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
\`\`\`

> JWTベースの認証をリフレッシュトークン付きで構築する

自動 Git コミット

デフォルトでは、すべての変更で Git コミットが作成されます：

[tick] TASK-001 claimed by @claude-code
[tick] TASK-001 completed by @claude-code
[tick] TASK-003: created

フラグで制御：

--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 "Build landing page" --priority high --tags frontend --assign @claude-code
tick add "Write launch email" --priority medium --tags content --assign @content-bot
tick add "E2E tests" --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 @yourbotname
進捗コメントを追加: tick comment TASK-XXX @yourbotname --note "ステータス更新"
完了時に完了とマーク: tick done TASK-XXX @yourbotname
依存関係を確認: 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
# これをリポジトリの Settings → Deploy Keys に追加（書き込みアクセス付き）

Git がそれを使用するように設定：

cd tasks
git config core.sshCommand "ssh -i ~/.ssh/tasks_deploy -o IdentitiesOnly=yes"

6. ボットの同期コマンド

tick の変更後、変更をプッシュ：

cd tasks && git push

または、プルとプッシュを自動的に処理する tick sync を使用します。

📦 パッケージ情報

CLI: tick-md on npm
MCP サーバー: tick-mcp-server on npm
GitHub: https://github.com/Purple-Horizons/tick-md
ライセンス: MIT

🆘 サポート

GitHub Issues: https://github.com/Purple-Horizons/tick-md/issues
スポンサー: https://github.com/sponsors/Purple-Horizons

お気に入りのAIに質問する

ドキュメント