mcpField
C
conductor-status

conductor-status

github.com/sickn33エージェントワークフロー48.7k306 回インストール今日更新
リポジトリ

conductor-status について

conductor-status は、プロジェクトファイルから Conductor の進捗、トラック、タスク、ブロッカーを報告する読み取り専用スキルです。計画を変更したり実装コマンドを実行したりせず、記録済みの作業を確認できます。

主な機能

  1. 01Conductor の初期化確認
  2. 02プロジェクトのトラック集計
  3. 03トラック別タスク状態の集計
  4. 04フェーズと次のタスクの特定
  5. 05ブロッカーと依存関係の確認
  6. 06クイック表示と JSON 出力

活用シーン

  1. 01プロジェクト全体の進捗確認
  2. 02個別トラックの状態確認
  3. 03未完了タスクとブロッカーの検索
  4. 04簡潔な状態または JSON の生成

インストール

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

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill conductor-status

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

詳細

Conductor のステータス

Conductor プロジェクトの現在のステータスとして、全体の進捗、進行中のトラック、次のアクションを表示します。

このスキルを使用する場面

  • Conductor のステータスに関するタスクやワークフローに取り組んでいるとき
  • Conductor のステータスに関するガイダンス、ベストプラクティス、チェックリストが必要なとき

このスキルを使用しない場面

  • タスクが Conductor のステータスと無関係な場合
  • この範囲外の別のドメインやツールが必要な場合

手順

  • 目標、制約、必要な入力を明確にします。
  • 関連するベストプラクティスを適用し、結果を検証します。
  • 実行可能な手順と検証方法を提示します。

事前確認

  1. Conductor が初期化されていることを確認します。

    • conductor/product.md が存在することを確認します。
    • conductor/tracks.md が存在することを確認します。
    • ファイルがない場合:エラーを表示し、先に /conductor:setup を実行するよう提案します。
  2. トラックがあるか確認します。

    • conductor/tracks.md を読み取ります。
    • 登録済みのトラックがない場合:セットアップ完了メッセージを表示し、最初のトラックの作成を提案します。

データ収集

1. プロジェクト情報

conductor/product.md を読み取り、以下を抽出します。

  • プロジェクト名
  • プロジェクトの説明
2. トラックの概要

conductor/tracks.md を読み取り、以下を解析します。

  • トラックの総数
  • 完了したトラック([x] のマークが付いたもの)
  • 進行中のトラック([~] のマークが付いたもの)
  • 未着手のトラック([ ] のマークが付いたもの)
3. トラックの詳細分析

conductor/tracks/ 内の各トラックについて:

conductor/tracks/{trackId}/plan.md を読み取ります。

  • タスクの総数(Task プレフィックスが付いた - [x]、- [~]、- [ ] に一致する行の数)
  • 完了したタスク([x])の数
  • 進行中のタスク([~])の数
  • 未着手のタスク([ ])の数
  • 現在のフェーズ(未完了のタスクがある最初のフェーズ)
  • 次の未着手タスク

conductor/tracks/{trackId}/metadata.json を読み取ります。

  • トラックの種類(feature、bug、chore、refactor)
  • 作成日
  • 最終更新日
  • ステータス

conductor/tracks/{trackId}/spec.md を読み取ります。

  • 記載されているブロッカーや依存関係を確認します。
4. ブロッカーの検出

潜在的なブロッカーを確認します。

  • BLOCKED: プレフィックスが付いたタスク
  • 未完了のトラックへの依存関係
  • 失敗した検証タスク

出力形式

プロジェクト全体のステータス(引数なし)
================================================================================
                        PROJECT STATUS: {Project Name}
================================================================================
Last Updated: {current timestamp}

--------------------------------------------------------------------------------
                              OVERALL PROGRESS
--------------------------------------------------------------------------------

Tracks:     {completed}/{total} completed ({percentage}%)
Tasks:      {completed}/{total} completed ({percentage}%)

Progress:   [##########..........] {percentage}%

--------------------------------------------------------------------------------
                              TRACK SUMMARY
--------------------------------------------------------------------------------

| Status | Track ID          | Type    | Tasks      | Last Updated |
|--------|-------------------|---------|------------|--------------|
| [x]    | auth_20250110     | feature | 12/12 (100%)| 2025-01-12  |
| [~]    | dashboard_20250112| feature | 7/15 (47%) | 2025-01-15  |
| [ ]    | nav-fix_20250114  | bug     | 0/4 (0%)   | 2025-01-14  |

--------------------------------------------------------------------------------
                              CURRENT FOCUS
--------------------------------------------------------------------------------

Active Track:  dashboard_20250112 - Dashboard Feature
Current Phase: Phase 2: Core Components
Current Task:  [~] Task 2.3: Implement chart rendering

Progress in Phase:
  - [x] Task 2.1: Create dashboard layout
  - [x] Task 2.2: Add data fetching hooks
  - [~] Task 2.3: Implement chart rendering
  - [ ] Task 2.4: Add filter controls

--------------------------------------------------------------------------------
                              NEXT ACTIONS
--------------------------------------------------------------------------------

1. Complete: Task 2.3 - Implement chart rendering (dashboard_20250112)
2. Then: Task 2.4 - Add filter controls (dashboard_20250112)
3. After Phase 2: Phase verification checkpoint

--------------------------------------------------------------------------------
                               BLOCKERS
--------------------------------------------------------------------------------

{If blockers found:}
! BLOCKED: Task 3.1 in dashboard_20250112 depends on api_20250111 (incomplete)

{If no blockers:}
No blockers identified.

================================================================================
Commands: /conductor:implement {trackId} | /conductor:new-track | /conductor:revert
================================================================================
単一トラックのステータス(track-id 引数あり)
================================================================================
                    TRACK STATUS: {Track Title}
================================================================================
Track ID:    {trackId}
Type:        {feature|bug|chore|refactor}
Status:      {Pending|In Progress|Complete}
Created:     {date}
Updated:     {date}

--------------------------------------------------------------------------------
                              SPECIFICATION
--------------------------------------------------------------------------------

Summary: {brief summary from spec.md}

Acceptance Criteria:
  - [x] {Criterion 1}
  - [ ] {Criterion 2}
  - [ ] {Criterion 3}

--------------------------------------------------------------------------------
                              IMPLEMENTATION
--------------------------------------------------------------------------------

Overall:    {completed}/{total} tasks ({percentage}%)
Progress:   [##########..........] {percentage}%

## Phase 1: {Phase Name} [COMPLETE]
  - [x] Task 1.1: {description}
  - [x] Task 1.2: {description}
  - [x] Verification: {description}

## Phase 2: {Phase Name} [IN PROGRESS]
  - [x] Task 2.1: {description}
  - [~] Task 2.2: {description}  <-- CURRENT
  - [ ] Task 2.3: {description}
  - [ ] Verification: {description}

## Phase 3: {Phase Name} [PENDING]
  - [ ] Task 3.1: {description}
  - [ ] Task 3.2: {description}
  - [ ] Verification: {description}

--------------------------------------------------------------------------------
                              GIT HISTORY
--------------------------------------------------------------------------------

Related Commits:
  abc1234 - feat: add login form ({trackId})
  def5678 - feat: add password validation ({trackId})
  ghi9012 - chore: mark task 1.2 complete ({trackId})

--------------------------------------------------------------------------------
                              NEXT STEPS
--------------------------------------------------------------------------------

1. Current: Task 2.2 - {description}
2. Next: Task 2.3 - {description}
3. Phase 2 verification pending

================================================================================
Commands: /conductor:implement {trackId} | /conductor:revert {trackId}
================================================================================

ステータスマーカーの凡例

必要に応じて、下部に表示します。

Legend:
  [x] = Complete
  [~] = In Progress
  [ ] = Pending
  [!] = Blocked

エラー状態

トラックが見つからない場合
================================================================================
                        PROJECT STATUS: {Project Name}
================================================================================

Conductor is set up but no tracks have been created yet.

To get started:
  /conductor:new-track "your feature description"

================================================================================
Conductor が初期化されていない場合
ERROR: Conductor not initialized

Could not find conductor/product.md

Run /conductor:setup to initialize Conductor for this project.
トラックが見つからない場合(引数あり)
ERROR: Track not found: {argument}

Available tracks:
  - auth_20250115
  - dashboard_20250112
  - nav-fix_20250114

Usage: /conductor:status [track-id]

計算ロジック

読み取り専用のステータス表示として扱います。報告中にプランのチェックボックスを変更したり、セットアップ/リバート/実装コマンドを実行したりしないでください。ファイルの欠落やメタデータの不整合は不明として報告し、記録上の完了と、独立して検証されたテストの証拠を区別してください。タスク数またはトラック数がゼロの場合は、ゼロ除算をせずに N/A と表示します。ブロックされたタスクや検証タスクも一貫して数え、分母を明記してください。

タスクのカウント
For each plan.md:
  - Complete: count lines matching /^- \[x\] Task/
  - In Progress: count lines matching /^- \[~\] Task/
  - Pending: count lines matching /^- \[ \] Task/
  - Total: Complete + In Progress + Pending
フェーズの検出
Current phase = first phase header followed by any incomplete task ([ ] or [~])
進捗バー
filled = floor((completed / total) * 20)
empty = 20 - filled
bar = "[" + "#".repeat(filled) + ".".repeat(empty) + "]"

クイックモード

--quick または -q を指定して呼び出した場合:

{Project Name}: {completed}/{total} tasks ({percentage}%)
Active: {trackId} - Task {X.Y}

JSON 出力

--json を指定して呼び出した場合:

{
  "project": "{name}",
  "timestamp": "ISO_TIMESTAMP",
  "tracks": {
    "total": N,
    "completed": X,
    "in_progress": Y,
    "pending": Z
  },
  "tasks": {
    "total": M,
    "completed": A,
    "in_progress": B,
    "pending": C
  },
  "current": {
    "track": "{trackId}",
    "phase": N,
    "task": "{X.Y}"
  },
  "blockers": []
}

制限事項

  • このスキルは、タスクが上記の範囲に明確に該当する場合にのみ使用してください。
  • 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
  • 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。

コメント