mcpField
F
file-todos

file-todos

github.com/iliaal生産性45143 回インストール5 日前に更新
リポジトリ

file-todos について

file-todosは、開発者やエージェント向けのファイルベースのタスク管理スキルです。Markdownファイルをステータス、優先度、依存関係で整理します。

主な機能

  1. 01ID・ステータス・優先度による命名規則
  2. 02YAMLによるタスクメタデータ
  3. 03問題と受け入れ条件の記載欄
  4. 04IDとステータス項目の検証

活用シーン

  1. 01開発タスクと依存関係の管理
  2. 02未着手・承認済み・完了項目の記録

インストール

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

$npx skills add https://github.com/iliaal/ai-skills --skill file-todos

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

SPEC.md
agents/
openai.yaml
assets/
todo-template.md
references/
quick-reference.md
workflows.md

詳細

ファイルベースの ToDo 管理

ファイル名の規則

{issue_id}-{status}-{priority}-{description}.md
  • issue_id：連番（001、002、003...）。再利用しません。
  • status：pending（トリアージが必要）、ready（承認済み）、complete（完了）
  • priority：p1（重大）、p2（重要）、p3（あると便利）。ia-code-review の重大度スケールからの対応：Critical→p1、Important→p2、Medium→p3、Minor→p3。
  • description：kebab-case の簡潔な説明

例：001-pending-p1-mailer-test.md、002-ready-p1-fix-n-plus-1.md、005-complete-p2-refactor-csv.md

ファイル構成

todo-template.md をひな形として使用します。YAML フロントマター：

---
status: ready              # pending | ready | complete
priority: p1               # p1 | p2 | p3
issue_id: "002"
tags: [typescript, performance, database]
dependencies: ["001"]      # Issue IDs this is blocked by
---

必須セクション： Problem Statement、Findings、Proposed Solutions、Recommended Action、Acceptance Criteria、Work Log

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

主な違い

ファイル ToDo システム（このスキル）： 開発やプロジェクトの進捗管理に使用する、todos/ ディレクトリ内の Markdown ファイルです。人間とエージェントが使用します。

アプリケーションの Todo モデル： ユーザー向けのタスク管理に使用するデータベースモデルです。このファイルベースのシステムとは異なります。

TodoWrite ツール： エージェントのセッション中に使用する、メモリ内のタスク管理機能です。一時的なもので、ディスクには保存されません。

確認

ToDo ファイルが正しく作成されたと判断する前に、次の点を確認してください。

  • issue_id は一意で、todos/ 内の次の連番であること（再利用されていないこと）。
  • 必須のフロントマターフィールド status、priority、issue_id がすべて含まれていること。
  • status と priority の値がファイル名および各列挙値（pending|ready|complete、p1|p2|p3）と一致していること。

参考資料

  • workflows.md - ToDo の作成、トリアージ、依存関係、作業ログ、完了、統合テーブル
  • quick-reference.md - 作業項目、依存関係、検索に使用する Bash コマンド
  • todo-template.md - 新しい ToDo ファイルのテンプレート

コメント

Markdown 対応