mcpField
T
todo-create

todo-create

github.com/everyinc開発25.8k241 回インストール今日更新
リポジトリ

todo-create について

todo-createは、YAMLメタデータ付きのMarkdownファイルで、セッションをまたいで保持する作業項目を管理するスキルです。コードレビューの指摘、技術的負債、計画中の作業向けに、命名や構成、運用手順を定めています。

主な機能

  1. 01YAML frontmatter付きMarkdownのToDo
  2. 02標準・レガシーディレクトリの扱い
  3. 03連番IDと優先度の命名規則
  4. 04作成・トリアージ・完了の手順
  5. 05依存関係とブロッカーの追跡

活用シーン

  1. 01コードレビュー指摘の後日対応
  2. 02セッションをまたぐ技術的負債の管理
  3. 03依存関係のある開発タスクの計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/everyinc/compound-engineering-plugin --skill todo-create

インストール後、Claude Code で/todo-createを入力して読み込まれたか確認します。

同梱ファイルassets/todo-template.md

詳細

ファイルベースの Todo 追跡

概要

.context/compound-engineering/todos/ ディレクトリは、コードレビューのフィードバック、技術的負債、機能リクエスト、作業項目を追跡するファイルベースのシステムです。各 Todo は YAML フロントマターを含む Markdown ファイルです。

レガシーサポート： 読み取り時は、.context/compound-engineering/todos/（正規）と todos/（レガシー）の両方を必ず確認してください。新しい Todo は正規パスにのみ書き込んでください。このディレクトリは複数セッションにわたって使用されるため、一時ファイルとして削除しないでください。

ディレクトリパス

用途パス
正規（ここに書き込み）.context/compound-engineering/todos/
レガシー（読み取り専用）todos/

ファイル名の規則

{issue_id}-{status}-{priority}-{description}.md
  • issue_id：連番（001、002、...）。再利用しないでください
  • status：pending | ready | complete
  • priority：p1（重大） | p2（重要） | p3（あると望ましい）
  • description：簡潔なケバブケース

例： 002-ready-p1-fix-n-plus-1.md

ファイル構造

各 Todo には YAML フロントマターと構造化されたセクションがあります。新しい Todo を作成するときは、以下に含まれる Todo テンプレートを使用してください。

---
status: ready
priority: p1
issue_id: "002"
tags: [rails, performance]
dependencies: ["001"]     # Issue IDs this is blocked by
---

必須セクション： Problem Statement、Findings、Proposed Solutions、Recommended Action（トリアージ時に記入）、Acceptance Criteria、Work Log。

任意セクション： Technical Details、Resources、Notes。

ワークフロー

ツールの優先事項： Todo ファイルの検索や読み取りには、シェルコマンドではなく、標準のファイル検索／glob ツールとコンテンツ検索ツールを使用してください。シェルは、標準ツールでは実行できない操作（mv、mkdir -p）にのみ使用してください。

新しい Todo の作成
  1. mkdir -p .context/compound-engineering/todos/
  2. 両方のパスで [0-9]*-*.md を検索し、数値プレフィックスの最大値を見つけて、1 を加算し、3 桁になるようゼロ埋めします。
  3. 以下に含まれる Todo テンプレートを使用し、正規パスに {NEXT_ID}-pending-{priority}-{description}.md として書き込みます。
  4. Problem Statement、Findings、Proposed Solutions、Acceptance Criteria、および最初の Work Log エントリーを記入します。
  5. ステータスを pending（トリアージが必要）または ready（事前承認済み）に設定します。

作業に約15分以上かかる場合、依存関係がある場合、計画が必要な場合、または優先順位付けが必要な場合は Todo を作成します。 修正が単純明快で、それだけで完結する場合は、代わりにすぐ対応してください。

保留中の項目のトリアージ
  1. 両方のパスで *-pending-*.md を glob します。
  2. 各 Todo の Problem Statement、Findings、Proposed Solutions を確認します。
  3. 承認する場合：ファイル名とフロントマターの pending を ready に変更し、Recommended Action を記入します。
  4. 保留する場合：pending のままにします。

インタラクティブな承認ワークフローには、todo-triage スキルを読み込んでください。

依存関係の管理
dependencies: ["002", "005"]  # Blocked by these issues
dependencies: []               # No blockers

ブロッカーを確認するには、両方のパスで {dep_id}-complete-*.md を検索します。一致するものがない場合、ブロッカーは未完了です。

Todo の完了
  1. すべての受け入れ条件を確認します。
  2. 最終セッションの内容で Work Log を更新します。
  3. ファイル名とフロントマターの ready を complete に変更します。
  4. ブロックが解除された作業を確認します。dependencies:.*"{issue_id}" を含むファイルを検索してください。

ワークフローとの連携

トリガーフロー
コードレビュー/ce:review -> Findings -> /todo-triage -> Todos
自律レビュー/ce:review mode:autofix -> 残存 Todo -> /todo-resolve
コード内の TODO/todo-resolve -> 修正 + 複雑な Todo
計画ブレインストーミング -> Todo の作成 -> 作業 -> 完了

主な違い

このスキルは、Markdown ファイルとして保存されるセッションをまたいで維持される作業項目を管理します。セッション内で一時的に手順を追跡する場合は、代わりにプラットフォームのタスクツール（Claude Code の TaskCreate／TaskUpdate、Codex の update_plan）を使用してください。

Todo テンプレート

@./assets/todo-template.md

コメント

Markdown 対応