Pulsar Task Master (plsr-taskmaster)

AIとのタスク対話を行うためのライブラリです。

Install

グローバルインストール（推奨）

npm install -g plsr-taskmaster

ローカルインストール

npm i plsr-taskmaster

Usage

タスクフォルダはデフォルトでtasksです。変更したい場合はpackage.json内にplsr-taskプロパティを作成してください。こんな感じです。

...
    "plsr-task" : {
        "task-dir" : "tasks"
    }

コマンド一覧

| 正式コマンド | エイリアス | 説明 | |-------------|-----------|------| | plsr-task | ptm | 短縮形で利用可能 |

コマンドラインからの利用は以下のように実施します。

# タスクを作成する(実行中があればわきにどける)
npx plsr-task create <タスク名(default="task")>
# または短縮形
npx ptm create <タスク名>

# タスクのplan/reviewサイクルを作成する
npx ptm cycle

# 実行中タスクをわきにどける
npx ptm stash

# stashされたタスクを復元する
npx ptm pop

# 実行中タスクを完了する
npx ptm done

概念

3つのファイルから構成されています。

planファイル

• 指示を行うファイルで、タスクの内容が記述されています。
• ファイル名はplan.[タスク名].[サイクル数].mdとなります。
  • ex) plan.create-project.1.md

AIはタスクファイルを読んで、作業し、作業内容のレポートを同一のファイルへ書き込みます。

reviewファイルの後続で作成された場合は、レビューの結果を受けて改善する指示が書き込まれています。

reviewファイル

• レビューを行うファイルで、レビューの内容が記述されています。
• ファイル名はreview.[タスク名].[サイクル数].mdとなります。
  • ex) review.create-project.1.md

このファイルはplanファイルの後続サイクルで作成されます。planファイルを指し示していて、AIまたはユーザーはplanファイルの結果をレビューします。

サイクル

AIの指示はplan/reviewサイクルを繰り返すことで実施されます。

開発者向け情報

ビルド

# 開発中ビルド
npm run dev

# 本番ビルド
npm run build

グローバルインストール検証

グローバルインストールが正しく動作するかを検証するスクリプトを用意しています：

node scripts/global-install-test.js

このスクリプトは以下を自動で行います：

1. npm packでパッケージを生成
2. グローバルインストール
3. 全コマンドの動作テスト（create/cycle/stash/pop/done）
4. アンインストールとクリーンアップ

トラブルシューティング

グローバルインストール時のPATHエラー

'plsr-task' is not recognized as an internal or external command

原因: npmのグローバルbinディレクトリがPATHに含まれていない

解決方法:

# グローバルbinディレクトリを確認
npm config get prefix

# 表示されたパスをPATHに追加（Windowsは直下、Linux/macOSはbin配下）

権限エラー（Linux/macOS）

EACCES: permission denied

解決方法:

# オプション1: sudoを使用
sudo npm install -g plsr-taskmaster

# オプション2: npmのprefixを変更（推奨）
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
# ~/.bashrc または ~/.zshrc に追加:
# export PATH=~/.npm-global/bin:$PATH

古いキャッシュの問題

# npmキャッシュをクリア
npm cache clean --force

# 再インストール
npm uninstall -g plsr-taskmaster
npm install -g plsr-taskmaster