claude-task-worker 0.6.0 → 0.10.0

package/README.md

@@ -48,7 +48,7 @@ GitHub Issues/PRを定期ポーリングし、Claude Codeに処理を委譲す
 | `fix-review-point` | `cc-fix-onetime` | `/claude-task-worker:fix-review-point` | 1分 |
 | `triage-created-issue` | `cc-issue-created` + `cc-triage-scope` (Issue) | `/claude-task-worker:triage-created-issue` | 1分 |
 | `triage-pr` | `cc-triage-scope` (PR) | `/claude-task-worker:triage-pr` | 1分 |
-| `resolve-conflict` | `cc-resolve-conflict` (PR) | `/claude-task-worker:resolve-conflict` | 1分 |
+| `resolve-conflict` | `cc-resolve-conflict` (PR) | `/claude-task-worker:resolve-pr-conflict` | 1分 |
 | `check-dependabot` | `dependencies` (PR) | `/claude-task-worker:check-dependabot` | 1時間 |
 | `epic-issue` | `cc-epic-issue` (Issue, sub-issues が全て Close) | `/claude-task-worker:create-epic-pr` | 5分 |
 
@@ -60,14 +60,58 @@ GitHub Issues/PRを定期ポーリングし、Claude Codeに処理を委譲す
 
 `epic-issue` ワーカーは、`cc-epic-issue` ラベル付きの親Issueに紐づくサブIssueがすべて Close されたタイミングで `/claude-task-worker:create-epic-pr` を起動し、エピックブランチからまとめてPRを作成する。
 
+## 必要なライブラリ
+
+### 実行時に必要なもの
+
+CLI 本体に npm の実行時依存パッケージはない（ビルド時に esbuild で単一ファイル `dist/index.js` にバンドルされ、Node.js 標準モジュールのみで動作する）。代わりに以下の外部ツールが必要。
+
+| 名前 | バージョン | 用途 |
+|---|---|---|
+| [Node.js](https://nodejs.org/) | >= 20 | CLI の実行ランタイム |
+| [GitHub CLI (`gh`)](https://cli.github.com/) | - | Issue/PR の取得・ラベル操作など全GitHub操作（認証済みであること） |
+| [Claude Code (`claude`)](https://docs.anthropic.com/en/docs/claude-code) | - | タスク実行エンジン。各ワーカーが Claude CLI プロセスとして起動する |
+| [Git (`git`)](https://git-scm.com/) | - | worktree の作成・ブランチ操作 |
+| [jq](https://jqlang.org/) | - | プラグインスキル内でのJSON加工（`check-dependabot` / `edit-pencil-design` スキルなどで使用） |
+| [Pencil CLI (`pencil`)](https://docs.pencil.dev/for-developers/pencil-cli) | - | `.pen` デザインファイルの編集・参照・コンフリクト解消（`edit-pencil-design` / `inspect-pencil-node` / `resolve-pencil-conflict` スキルで使用） |
+| `claude-task-worker` プラグイン | - | 各ワーカーが呼び出すスキル群（本リポジトリの `plugin/`） |
+
+Slack通知（任意）を使う場合は Slack Incoming Webhook URL が必要。Claude API使用状況の取得には、macOSでは `security` コマンド（Keychain）を使用し、それ以外の環境では `~/.claude/.credentials.json` にフォールバックする。
+
+### 開発時に必要なライブラリ（devDependencies）
+
+| パッケージ | バージョン | 用途 |
+|---|---|---|
+| `typescript` | ^5.7.0 | 型チェック（`tsc --noEmit`） |
+| `esbuild` | ^0.27.4 | `dist/index.js` へのバンドル |
+| `@types/node` | ^22.0.0 | Node.js の型定義 |
+| `eslint` | ^10.3.0 | Lint |
+| `@eslint/js` | ^10.0.1 | ESLint 推奨設定 |
+| `typescript-eslint` | ^8.59.1 | TypeScript 対応の ESLint ルール |
+| `eslint-config-prettier` | ^10.1.8 | ESLint と Prettier の競合ルール無効化 |
+| `prettier` | ^3.8.3 | コードフォーマッタ |
+
+### プラグインが利用する MCP サーバー
+
+`claude-task-worker` プラグイン（`plugin/.mcp.json`）は以下の MCP サーバーを定義しており、プラグイン有効化時に Claude Code から自動的に利用される。
+
+| サーバー | 接続方法 | 用途 |
+|---|---|---|
+| `context7` | HTTP（`https://mcp.context7.com/mcp`） | ライブラリの最新ドキュメント取得 |
+| `next-devtools` | `npx -y next-devtools-mcp@latest` | Next.js 開発支援 |
+| `shadcn` | `npx shadcn@latest mcp` | shadcn/ui コンポーネント情報の取得 |
+
 ## セットアップ
 
 ### 前提条件
 
+- [Node.js](https://nodejs.org/) v20 以上がインストール済みであること
 - [GitHub CLI (`gh`)](https://cli.github.com/) がインストール・認証済みであること
 - [Claude Code (`claude`)](https://docs.anthropic.com/en/docs/claude-code) がインストール済みであること
 - `claude-task-worker` プラグインがインストール済みであること（下記インストール手順を参照）
 
+詳細は上記「[必要なライブラリ](#必要なライブラリ)」を参照。
+
 ### インストール
 
 #### 推奨手順（一発セットアップ）
@@ -153,7 +197,7 @@ claude-task-worker init --force   # 既存ファイルを強制上書き
 
 - `.github/ISSUE_TEMPLATE/cc-triage-scope.yml` — `cc-triage-scope` ラベル付きIssue作成用テンプレート
 - `.github/workflows/assign-creator-on-cc-triage-scope.yml` — Issue作成者を自動アサインするワークフロー
-- `claude-task-worker.json` — 設定ファイル（コマンド実行ディレクトリ直下）
+- `claude-task-worker.json` — 設定ファイル（コマンド実行ディレクトリ直下。全ワーカーのデフォルト設定が書き込まれた状態で作成される）
 
 ## コマンド
 
@@ -202,6 +246,7 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 `cc-fix-onetime` ラベルが付いたPRを定期取得し、Claude Codeで修正を実行する。（1分間隔）
 
 - CI完了済みで `cc-in-progress` がないPRが対象
+- 完了後、`cc-fix-onetime` ラベルを除去
 - 完了後、設定ファイルに `fixReviewPointCallbackCommentMessage` が設定されていればPRにコメント投稿
 
 ### create-issue
@@ -210,7 +255,8 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 
 `init` コマンドで作成されるIssueテンプレートを使えば、`cc-triage-scope` ラベル付与と作成者アサインが自動で行われる。ブロック中の依存 Issue が残っている間はワーカーが拾わず、依存がすべて Close された時点で処理が開始される。
 
-除外ラベル: `cc-issue-created` / `cc-pr-created` / `cc-update-issue` / `cc-answer-issue-questions` / `cc-exec-issue` のいずれかが付いている Issue は対象外。
+- 除外ラベル: `cc-issue-created` / `cc-pr-created` / `cc-update-issue` / `cc-answer-issue-questions` / `cc-exec-issue` のいずれかが付いている Issue は対象外
+- 完了後、`cc-issue-created` ラベルを付与して triage-created-issue ワーカーに引き継ぎ
 
 ### update-issue
 
@@ -240,7 +286,7 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 
 ### resolve-conflict
 
-`cc-resolve-conflict` ラベルが付いたPRを定期取得し、`/claude-task-worker:resolve-conflict` を実行してコンフリクト解消を行う。（1分間隔）
+`cc-resolve-conflict` ラベルが付いたPRを定期取得し、`/claude-task-worker:resolve-pr-conflict` を実行してコンフリクト解消を行う。（1分間隔）
 
 - 完了後、`cc-resolve-conflict` ラベルを除去
 
@@ -270,7 +316,7 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 
 ### usage
 
-現在のClaude API使用状況をSlackに通知する。
+現在のClaude API使用状況（5時間/7日間の利用率とリセット時刻）を標準出力に表示し、Slack Webhookが設定されていればSlackにも通知する。
 
 ### install
 
@@ -310,7 +356,7 @@ claude-task-worker --version
 claude-task-worker -v
 ```
 
-`package.json` の `version` を出力する（例: `0.2.0`）。
+`package.json` の `version` を出力する（例: `0.6.0`）。
 
 ## 設定ファイル
 
@@ -328,15 +374,15 @@ claude-task-worker -v
 | ワーカー名 | デフォルト `skill` | デフォルト `model` | デフォルト `effort` | デフォルト `pollingIntervalSeconds` | デフォルト `cooldownSeconds` | デフォルト `maxConcurrentTasks` |
 |---|---|---|---|---|---|---|
 | `answer-issue-questions` | `/claude-task-worker:answer-issue-questions` | `opus` | `xhigh` | 60 | 0 | 1 |
-| `create-issue` | `/claude-task-worker:create-issue-from-issue-number` | `opus` | `xhigh` | 60 | 0 | 1 |
-| `update-issue` | `/claude-task-worker:update-issue` | `sonnet` | `xhigh` | 60 | 0 | 1 |
-| `exec-issue` | `/claude-task-worker:exec-issue` | `sonnet` | `xhigh` | 60 | 0 | 1 |
-| `fix-review-point` | `/claude-task-worker:fix-review-point` | `sonnet` | `xhigh` | 60 | 0 | 1 |
-| `triage-created-issue` | `/claude-task-worker:triage-created-issue` | `sonnet` | `xhigh` | 60 | 0 | 1 |
-| `triage-pr` | `/claude-task-worker:triage-pr` | `sonnet` | `xhigh` | 60 | 0 | 1 |
-| `resolve-conflict` | `/claude-task-worker:resolve-pr-conflict` | `sonnet` | `xhigh` | 60 | 0 | 1 |
-| `check-dependabot` | `/claude-task-worker:check-dependabot` | `sonnet` | `xhigh` | 3600 | 0 | 1 |
-| `epic-issue` | `/claude-task-worker:create-epic-pr` | `sonnet` | `xhigh` | 300 | 0 | 1 |
+| `create-issue` | `/claude-task-worker:create-issue-from-issue-number` | `sonnet` | `xhigh` | 60 | 0 | 1 |
+| `update-issue` | `/claude-task-worker:update-issue` | `sonnet` | `high` | 60 | 0 | 1 |
+| `exec-issue` | `/claude-task-worker:exec-issue` | `sonnet` | `high` | 60 | 0 | 1 |
+| `fix-review-point` | `/claude-task-worker:fix-review-point` | `sonnet` | `high` | 60 | 0 | 1 |
+| `triage-created-issue` | `/claude-task-worker:triage-created-issue` | `sonnet` | `high` | 60 | 0 | 1 |
+| `triage-pr` | `/claude-task-worker:triage-pr` | `sonnet` | `high` | 60 | 0 | 1 |
+| `resolve-conflict` | `/claude-task-worker:resolve-pr-conflict` | `sonnet` | `high` | 60 | 0 | 1 |
+| `check-dependabot` | `/claude-task-worker:check-dependabot` | `sonnet` | `high` | 3600 | 0 | 1 |
+| `epic-issue` | `/claude-task-worker:create-epic-pr` | `sonnet` | `high` | 300 | 0 | 1 |
 
 各フィールドの値:
 
@@ -362,8 +408,6 @@ claude-task-worker -v
 }
 ```
 
-> 💡 **推奨:** 重い実装タスク（`exec-issue`, `fix-review-point`）では `/advisor` を有効にすることを推奨する。事前/事後に強力なレビューモデルへ相談することで、アプローチの誤りや見落としを早期に検出でき、完了率と品質が向上する。各ワーカーが呼び出すスキルのプロンプト内で `advisor` ツールを活用する運用を推奨。
-
 ## Slack通知
 
 環境変数 `CLAUDE_TASK_WORKER_SLACK_WEBHOOK_URL` にSlack Incoming Webhook URLを設定すると、各ワーカーのタスク完了時・失敗時にSlackへ通知が送信される。
@@ -387,8 +431,12 @@ claude-task-worker all
 
 ```bash
 npm install
-npm run build    # TypeScript → dist/
-npm run dev      # Watch mode (auto-rebuild)
+npm run build         # 型チェック（tsc --noEmit）+ esbuild で dist/index.js にバンドル
+npm run dev           # 型チェックの watch モード
+npm run lint          # ESLint
+npm run lint:fix      # ESLint（自動修正）
+npm run format        # Prettier で整形
+npm run format:check  # Prettier のチェックのみ
 ```
 
 コントリビューションを歓迎します。開発環境のセットアップ・PRの出し方は [CONTRIBUTING.md](./CONTRIBUTING.md) を参照してください。バグ報告・機能要望は [Issue テンプレート](https://github.com/getty104/claude-task-worker/issues/new/choose) から作成してください。

package/dist/index.js

@@ -1175,7 +1175,7 @@ function getWorktreePath(worktreeId) {
 }
 async function createWorktreeFromBranch(worktreeId, baseBranch) {
   const worktreePath = getWorktreePath(worktreeId);
-  await execFileAsync2("git", ["worktree", "add", "-B", worktreeId, worktreePath, `origin/${baseBranch}`]);
+  await execFileAsync2("git", ["worktree", "add", "--track", "-B", worktreeId, worktreePath, `origin/${baseBranch}`]);
 }
 async function removeWorktree(worktreeId) {
   const worktreePath = getWorktreePath(worktreeId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-task-worker",
-  "version": "0.6.0",
+  "version": "0.10.0",
   "description": "CLI tool that polls GitHub Issues/PRs and delegates work to Claude CLI",
   "type": "module",
   "main": "dist/index.js",