- Add bundled Fusion skill at packages/cli/skill/fusion/ with SKILL.md and reference docs - Include workflow guides for task lifecycle, specifications, dashboard CLI, and task management - Add reference docs for CLI commands, extension tools, capabilities, best practices, and patterns - Add postinstall script to sync skill into ~/.pi/agent/skills/fusion on install - Add skill-sync test coverage and changeset for minor version bump
4.4 KiB
4.4 KiB
Fusion Capabilities Catalog
Overview
Fusion (kb) is an AI-orchestrated task board. Tasks flow through columns: Triage → Todo → In Progress → In Review → Done → Archived
Pi Extension Tools (Available to Agents)
| Tool | Purpose |
|---|---|
kb_task_create |
Create a new task in triage |
kb_task_update |
Update task title, description, or dependencies |
kb_task_list |
List all tasks grouped by column |
kb_task_show |
Show full task details, steps, log |
kb_task_attach |
Attach a file to a task |
kb_task_pause |
Pause automation for a task |
kb_task_unpause |
Resume automation for a task |
kb_task_retry |
Retry a failed task (clears error, moves to todo) |
kb_task_duplicate |
Duplicate a task (copy to triage) |
kb_task_refine |
Create refinement task for follow-up work |
kb_task_archive |
Archive a done task |
kb_task_unarchive |
Restore an archived task |
kb_task_delete |
Permanently delete a task |
kb_task_import_github |
Batch import GitHub issues as tasks |
kb_task_import_github_issue |
Import a single GitHub issue |
kb_task_browse_github_issues |
Browse GitHub issues before importing |
kb_task_plan |
Create task via AI-guided planning mode |
kb_mission_create |
Create a new mission |
kb_mission_list |
List all missions |
kb_mission_show |
Show mission hierarchy |
kb_mission_delete |
Delete a mission |
kb_milestone_add |
Add a milestone to a mission |
kb_slice_add |
Add a slice to a milestone |
kb_feature_add |
Add a feature to a slice |
kb_slice_activate |
Activate a pending slice |
kb_feature_link_task |
Link a feature to a task |
CLI Commands (fn)
Dashboard
fn dashboard— Start web UI + AI enginefn dashboard --paused— Start with automation pausedfn dashboard --dev— Start web UI only (no AI engine)
Task Management
fn task create "description"— Create a new taskfn task plan "description"— AI-guided planning modefn task list— List all tasksfn task show KB-001— Show task detailsfn task move KB-001 todo— Move task to a columnfn task merge KB-001— Merge an in-review taskfn task duplicate KB-001— Duplicate a taskfn task refine KB-001 --feedback "..."— Create refinement taskfn task archive/unarchive KB-001— Archive/restore tasksfn task delete KB-001— Delete a taskfn task retry KB-001— Retry a failed taskfn task comment KB-001 "..."— Add a task commentfn task steer KB-001 "..."— Add steering commentfn task pause/unpause KB-001— Control automationfn task logs KB-001— View task agent logs
GitHub Integration
fn task import owner/repo— Batch import issuesfn task import owner/repo -i— Interactive importfn task pr-create KB-001— Create PR for task
Git Commands
fn git status/fetch/pull/push— Git operations
Settings
fn settings— Show current settingsfn settings set key value— Update a setting
AI Engine Components
- TriageProcessor — Auto-specifications for tasks in triage column
- Scheduler — Dependency resolution, concurrency management
- TaskExecutor — Creates worktrees, executes tasks with coding tools
Task Storage Structure
.kb/
├── kb.db # SQLite database (WAL mode)
├── config.json # Board config
└── tasks/
└── KB-001/
├── PROMPT.md # Task specification
├── agent.log # Execution logs
└── attachments/ # File attachments
Dashboard Features
- Real-time kanban board with drag-and-drop
- Board view and list view
- Task detail modal with tabs (Details, Spec, Model, Workflow, Comments)
- Git manager (commits, branches, worktrees)
- Activity log
- Settings modal
- Workflow step manager
- Scheduled tasks (automations)
- GitHub import modal
- Theme system (8+ themes, dark/light/system)
Key Settings
| Setting | Default | Description |
|---|---|---|
maxConcurrent |
2 | Concurrent task execution |
autoMerge |
true | Auto-merge completed tasks |
requirePlanApproval |
false | Manual approval for specs |
prCompletionMode |
direct | Completion: direct/pr-first |
taskStuckTimeoutMs |
— | Stuck task detection timeout |
recycleWorktrees |
false | Pool and reuse worktrees |