AGENT SKILL

ck:kanban

AI agent orchestration board for task visualization and team coordination.

License 许可
MIT
所属仓库
manhvann/codexkit
最近更新
2026-08-29
Stars
★ 88
Forks
79

01 前言 Front Matter

name
ck:kanban
description
AI agent orchestration board for task visualization and team coordination.
argument-hint
[dir]

03 SKILL.md 正文

Plans Dashboard

Plans dashboard with progress tracking and timeline visualization.

Usage

  • ck:kanban - View dashboard for the configured plans directory
  • ck:kanban <dir> - View dashboard for specific directory
  • ck:kanban --stop - Stop running server

Features

  • Plan cards with progress bars
  • Phase status breakdown (completed, in-progress, pending)
  • Timeline/Gantt visualization
  • Activity heatmap
  • Issue and branch links

Execution

IMPORTANT: Run the server as a background command when the runtime supports it, so it remains manageable from the active session.

The skill is located at .agents/skills/plans-kanban/.

Stop Server

If --stop flag is provided:

node .agents/skills/plans-kanban/scripts/server.cjs --stop

Start Server

Otherwise, run the kanban server with --foreground flag so the process stays alive:

# Determine plans directory
INPUT_DIR="$1"
PLANS_DIR="${INPUT_DIR:-${CK_PLANS_PATH:-plans}}"

# Start kanban dashboard
node .agents/skills/plans-kanban/scripts/server.cjs \
  --dir "$PLANS_DIR" \
  --host 0.0.0.0 \
  --open \
  --foreground

Critical: When calling the Bash tool:

  • Set run_in_background: true when the shell tool supports background processes
  • Set timeout: 300000 (5 minutes) to prevent premature termination
  • Parse JSON output and report URL to user

Example Bash tool call:

{
  "command": "node .agents/skills/plans-kanban/scripts/server.cjs --dir \"${CK_PLANS_PATH:-plans}\" --host 0.0.0.0 --open --foreground",
  "run_in_background": true,
  "timeout": 300000,
  "description": "Start kanban server in background"
}

After starting, parse the JSON output and report:

  • Local URL for browser access
  • Network URL for remote device access (if available)
  • Inform user that server is now running in the background when supported

CRITICAL: MUST display the FULL URL including path and query string. NEVER truncate to just host:port.

Future Plans

The ck:kanban command will evolve into VibeKanban-inspired AI agent orchestration:

Phase 1 (Current - MVP)

  • Task board with progress tracking
  • Visual representation of plans/tasks
  • Click to view plan details

Phase 2 (Worktree Integration)

  • Create tasks → spawn git worktrees
  • Assign agents to tasks
  • Track agent progress per worktree

Phase 3 (Full Orchestration)

  • Parallel agent execution monitoring
  • Code diff/review interface
  • PR creation workflow
  • Agent output streaming
  • Conflict detection

Track progress in the configured repository's issue tracker (for example, issue #189).

04 同仓库更多 Skills