TaskLoom (tukumo-taskloom)

TaskLoomは、VS Codeのワークスペース内でタスクを直接管理し、タイムラインとして可視化する統合タスク管理拡張機能です。 外部のタスク管理ツールとエディタを行き来することなく、コードのすぐそばでタスクを記録・追跡・完了させることができます。

主な機能 (Features)

コード内タスク管理 (In-File Task Management)

ソースコードのコメント内に [TODO] や [WARN] などのタグを記述するだけで、自動的にタスクとして認識されます。 エディタ上にハイライト装飾が施され、視認性が大幅に向上します。

タイムライン可視化 (Timeline Visualization)

「TaskLoom: タイムラインを表示」 コマンドを実行すると、ワークスペース内の全タスクを美しいタイムライン上にマッピングします。

フィルタリング: 「過去30日間」「担当者別」など、ワンクリックでタスクを絞り込めます。

ジャンプ機能: タイムライン上のタスクをクリックすると、該当ファイルの該当行へ瞬時にジャンプします。

快適な予測変換 (IntelliSense)

入力の摩擦を極限まで減らすため、専用の予測変換（オートコンプリート）を搭載しています。

• [ を入力: タスクの種類（[TODO] , [WARN] など）をサジェスト。
• @ を入力: チームメンバーや担当者をサジェスト。
• # を入力: カスタムタグ（#UI,#Bug など）をサジェスト。

スマートな完了アクション (Smart CodeLens)

タスクの直上に表示される「CodeLens（完了してGitへ追記 / 削除）」をクリックするだけで、タスクを安全に削除し、完了ログ（.taskloom/activity.jsonl）に記録します。 プロジェクトがGitで管理されている場合、コミットメッセージの入力欄に完了したタスクの内容を自動転記します。

GUIによる直感的な設定 (Visual Settings)

「TaskLoomの設定を開く」 コマンドから、ブラウザライクな専用設定ページを開くことができます。 JSONを直接編集することなく、以下の設定が可能です。

• タスク種類（ラベル、色、アイコン）の追加・削除

• 自動挿入時の「時間の丸め処理（15分単位など）」の設定

• 予測変換用リスト（担当者、タグ）の編集

• 設定のエクスポート / インポート機能

使い方 (Usage)

エディタ上で右クリックし、「TaskLoom: Insert TODO」 を選択するか、ショートカットを実行してタスクブロックを自動挿入します。

もしくは、任意のファイルのコメント内に以下のようなフォーマットで直接記述します。

// [TODO] 2026-08-26 14:30 - ログイン機能のバリデーションを修正 @LumenHero #Backend
// 詳細なメモをここに記述できます。

サイドバーの「TaskLoom」ビュー、またはタイムラインからタスクの状況を確認します。

タスクが完了したら、タスク上部の 「完了して追記」 をクリックします。

拡張機能の設定 (Extension Settings)

TaskLoomは、ワークスペースごとに設定を共有できるよう、プロジェクト直下の .taskloom/config.json で設定を管理します。

VS Codeの settings.json (ワークスペース設定) では、以下の1つのプロパティのみを提供します。

taskloom.configPath: 設定ファイル (config.json) のパスを指定します。空欄の場合は、デフォルトでワークスペース直下の .taskloom/config.json が読み込まれます。チームで設定ファイルを共有したい場合は、ここに相対パスを指定してください。

動作要件 (Requirements)

Visual Studio Code v1.101.0 以上

（推奨）Git 拡張機能が有効化されていること（完了時のコミット自動転記機能を使用する場合）

リリースノート (Release Notes)

0.1.0

TaskLoom 初期リリース

タイムラインビュー、予測変換機能、CodeLensによる完了アクションを搭載

GUIによる専用設定ページと、設定のインポート/エクスポート機能を実装

Enjoy your productive coding with TaskLoom!