jules-cli

docs/tasks.mdに記載されたタスクをJules CLIを使って依頼・管理します。タスクを日本語でフォーマットしてJulesに送信し、進捗を追跡して完了後にtasks.mdを更新します。

View on GitHub
Author Winds Chord
Namespace @windschord/claude-development-skills
Category general
Version 1.0.0
Stars 1
Downloads 3
self.md verified
Table of content

docs/tasks.mdに記載されたタスクをJules CLIを使って依頼・管理します。タスクを日本語でフォーマットしてJulesに送信し、進捗を追跡して完了後にtasks.mdを更新します。

Installation

npx claude-plugins install @windschord/claude-development-skills/jules-cli

Contents

Files: README.md, SKILL.md

Documentation

docs/tasks.mdに記載されたタスクをGoogleの非同期コーディングエージェントJulesに依頼・管理するスキルです。SDDで分割したタスクを効率的にJulesに割り当て、進捗を追跡します。

特徴

使用方法

基本的な使い方

  1. スキルを有効化

    Claude Codeで以下のように依頼します：

    次のタスクをJulesに依頼してください

    または

    タスクをJulesで実行してください

  2. タスクを選択

    スキルがdocs/tasks.mdから利用可能なタスクを表示するので、実行したいタスクを選択します。

  3. 依頼文を確認

    スキルが生成した依頼文を確認し、問題がなければ承認します。

  4. Julesが作業を実行

    julesコマンドが実行され、タスクがJulesに送信されます。進捗はjules listやjules statusで確認できます。

  5. 完了後の処理

    タスクが完了したら、スキルが結果をレビューし、tasks.mdを更新します。

詳細な例

シナリオ: ユーザー認証APIを実装する

docs/tasks.md の内容:

#### タスク1.1: ユーザー認証APIエンドポイントの実装
**説明**: POST /api/auth/login と POST /api/auth/logout のエンドポイントを実装
**受入基準**:
- src/api/auth.tsが存在する
- すべてのテストが通過する（npm test）
- ESLintエラーがゼロである
**ステータス**: `TODO`
**依存関係**: なし
**推定工数**: 2時間

ユーザーの依頼:

タスク1.1をJulesに依頼してください

スキルの動作:

  1. docs/tasks.mdを読み取る
  2. タスク1.1の情報を抽出
  3. 日本語の依頼文を作成：
    タスク: ユーザー認証APIエンドポイントの実装

概要:
POST /api/auth/login と POST /api/auth/logout のエンドポイントを実装してください。
JWTトークンを使用した認証方式を採用し、パスワードはbcryptでハッシュ化します。

受入基準:
- src/api/auth.tsが存在し、login/logoutエンドポイントが実装されている
- すべてのテストが通過する（npm test）
- ESLintエラーがゼロである

技術的文脈:
- フレームワーク: Next.js 14
- 認証: JWT + bcrypt
- 参照実装: src/api/users.ts

推定工数: 2時間
  4. ユーザーに確認を求める
  5. 承認後、julesコマンドを実行
  6. タスクIDを記録（例: task-abc123）
  7. tasks.mdのステータスをIN_PROGRESSに更新

完了後:

jules status task-abc123  # 完了を確認
jules result task-abc123  # 結果を取得

スキルが結果をレビューし、tasks.mdのステータスをREVIEWに更新します。

Jules依頼文の構造

スキルが生成する依頼文は以下の構造を持ちます：

タスク: [タスクタイトル]

概要:
[タスクの詳細な説明]

受入基準:
- [基準1]
- [基準2]
- [基準3]

技術的文脈:
- [フレームワークやライブラリ]
- [参照すべきファイルやコード]
- [制約事項]

推定工数: [時間]

すべて日本語で記述され、Julesが理解しやすい形式になっています。

ワークフロー

1. ユーザーがスキルを起動
   「次のタスクをJulesに依頼してください」
   ↓
2. スキルがdocs/tasks.mdを読み取る
   TODO状態のタスクを特定
   ↓
3. タスクリストを表示
   ユーザーがタスクを選択
   ↓
4. 依頼文を日本語で作成
   タスクの説明、受入基準、技術的文脈を含む
   ↓
5. ユーザーに依頼文を確認してもらう
   承認後、次へ進む
   ↓
6. julesコマンドを実行
   依頼文をJulesに送信
   ↓
7. タスクIDを記録
   ユーザーに報告
   ↓
8. tasks.mdを更新
   ステータスをIN_PROGRESSに変更
   ↓
9. 進捗を確認（必要に応じて）
   jules listやjules statusを使用
   ↓
10. 完了後、結果をレビュー
    受入基準を満たしているか確認
    ↓
11. tasks.mdを最終更新
    ステータスをREVIEWまたはDONEに変更

並行処理

依存関係のない複数のタスクを並行してJulesに依頼できます：

例:

ユーザー: タスク1.1、1.2、1.3をJulesに依頼してください

スキルは各タスクについて：

  1. 個別の依頼文を作成
  2. 順次julesコマンドを実行
  3. すべてのタスクIDを記録
  4. 各タスクの進捗を個別に追跡

並行実行の条件:

tasks.mdの更新

スキルは以下のようにtasks.mdを更新します：

ステータスの遷移

TODO → IN_PROGRESS（Jules実行中）→ REVIEW（完了、レビュー待ち）→ DONE（承認済み）

記録される情報

#### タスク1.1: ユーザー認証APIエンドポイントの実装
**説明**: POST /api/auth/login と POST /api/auth/logout のエンドポイントを実装
**受入基準**:
- src/api/auth.tsが存在する
- テストが通過する
**ステータス**: `REVIEW`
**依存関係**: なし
**推定工数**: 2時間
**Jules Task ID**: task-abc123
**開始日時**: 2024-01-15 10:30
**完了日時**: 2024-01-15 12:15
**作業時間**: 1時間45分

エラーハンドリング

Julesでエラーが発生した場合

スキルは以下の手順で対処します：

  1. エラー内容を確認

    jules status <task-id>

  2. ユーザーに報告

    • エラーの詳細
    • 推定される原因
    • 推奨される対処方法

  3. 対処を提案

    • 依頼文を修正して再実行
    • 依存関係を解決
    • 手動で対処

  4. tasks.mdを更新

    • ステータスをBLOCKEDに変更
    • エラー内容を記録

タスクが長時間完了しない場合

  1. 現在の状態を確認
  2. ユーザーに状況を報告
  3. キャンセルまたは待機を提案

Jules CLIコマンドリファレンス

このスキルが使用する主なコマンド：

タスクの作成

jules "タスクの説明"

タスクの管理

jules list               # タスクリスト表示
jules status <task-id>   # タスクの状態確認
jules show <task-id>     # タスクの詳細表示
jules result <task-id>   # 完了したタスクの結果取得

タスクの制御

jules cancel <task-id>   # タスクのキャンセル
jules retry <task-id>    # タスクの再実行

ベストプラクティス

1. タスクの粒度を適切に

2. 受入基準を明確に

検証可能な受入基準をtasks.mdに記載：

良い例:

受入基準:
- src/components/LoginForm.tsxが存在する
- npm testを実行してすべてのテストが通過する
- npm run lintを実行してエラーがゼロである

悪い例:

受入基準:
- ちゃんと動く
- きれいなコード

3. 技術的文脈を提供

Julesが適切に作業できるよう、必要な情報をtasks.mdに含める：

4. 依存関係を明示

tasks.mdで依存関係を明確に記載：

**依存関係**: Task 1.1, Task 1.2

これにより、スキルが適切な実行順序を判断できます。

制約事項

実行の制限

以下の場合はJulesへの依頼を控えます：

  1. タスクの曖昧性

    • 受入基準が不明確
    • 実装方法が複数考えられる
    • 技術的文脈が不足している

  2. リスクの高い操作

    • 本番環境への直接的な変更
    • データベースの削除操作
    • 認証情報の変更

  3. ユーザーの判断が必要な場合

    • 技術選択が必要
    • アーキテクチャの決定が必要
    • トレードオフの判断が必要

環境要件

トラブルシューティング

julesコマンドが見つからない

原因: Jules CLIがインストールされていない、またはPATHに含まれていない

解決:

  1. Jules CLIのインストールを確認
  2. PATHを設定
  3. which julesで確認

認証エラーが発生する

原因: Jules CLIの認証が設定されていない

解決:

jules auth login

でGoogle認証を完了してください。

タスクが失敗する

原因: 依頼文が不明瞭、または依存関係が不足

解決:

  1. tasks.mdのタスク説明を詳細化
  2. 受入基準を

…(truncated)

Source

View on GitHub

Tags: general