task-tracking-dots

Dots でのタスク追跡

Dots は、複数のセッションにまたがる作業を管理するための軽量なタスクトラッカーです。dot CLI を使用して、作業項目、依存関係、完了理由を追跡します。

このスキルを使うタイミング

次のような場合にこのスキルを使用します。

• 複数のセッションにまたがる作業項目を追跡する
• タスク間の依存関係を管理する
• 監査可能性を確保するため、完了理由を記録する

事前確認：dot がインストールされていることを確認する

ワークフローコマンドを実行する前に、dot CLI を確認します。

command -v dot >/dev/null 2>&1

dot が見つからない場合は、インストールします。

Homebrew：

brew install joelreymont/tap/dots

ソースからインストールする場合（Zig 0.15+ が必要です）：

git clone https://github.com/joelreymont/dots.git
cd dots
zig build -Doptimize=ReleaseSmall
cp zig-out/bin/dot ~/.local/bin/

~/.local/bin が PATH に含まれていることを確認し、次に検証します。

dot --version

セッションでの基本ワークフロー

各セッションの開始時：

dot ls
dot ready

タスクを開始する前：

dot on <id>

タスクの完了後：

dot off <id> -r "What was done"

完了したタスクを未完了のままにしないでください。必ず簡潔な理由を添えてクローズします。

---

Dots の作成

# Quick add
dot "Fix the bug"

# With priority and description
dot add "Design API" -p 1 -d "Details"

# As child of another dot
dot add "Subtask" -P dots-1

# Depends on another dot
dot add "After X" -a dots-2

優先度レベル

レベル	意味
0	重大（今すぐ対応）
1	高
2	中（デフォルト）
3	低
4	バックログ

---

Dots の操作

dot ls              # List open dots
dot ready           # Show unblocked dots
dot show dots-1     # Show dot details
dot tree            # Show hierarchy
dot find "query"   # Search dots

ワークフローに関する注意事項：

• 新しい作業を始める前に、必ず未完了／着手可能な dot を確認します。
• 作業を開始する前に dot on <id> を実行します。
• 完了したらすぐに dot off <id> -r "..." を実行します。

---

タスクを適切にクローズする

完了したタスクには、すべて理由が必要です。簡潔かつ具体的に記述します。

dot off dots-5 -r "Fixed null check in player.gd"
dot off dots-12 -r "Already implemented in previous session"
dot off dots-3 -r "Created PR #42, awaiting review"

タスクがすでに完了しているとわかった場合は、理由に根拠を記載してクローズします。

---

途中までの進捗

タスクが一部しか完了していない場合：

• 残りの作業を記録するサブタスクを作成する、または
• 現在のタスクに依存するフォローアップ dot を作成します。

これにより、現在の dot の内容を正確に保ち、次のセッションに向けてコンテキストを維持できます。

---

Dots と TodoWrite の使い分け

• Dots：複数の手順がある作業、複数のセッションにまたがる可能性があるタスク、依存関係のある作業に使います。
• TodoWrite：ユーザーに表示する、小規模で単一セッション内に完了するチェックリストに使います。

作業によってリポジトリに変更が生じた場合は、該当する dot をすぐに更新します。