docs(FN-2432): refresh Fusion skill docs for current CLI and extension
- Update top-level Fusion skill guidance and capability descriptions to reflect current terminology and tool behavior - Replace stale KB-* task examples with FN-* IDs across CLI reference, task structure, and workflow guides - Refresh capability and workflow docs with current commands (including node runtime, skills, and comment guidance) - Add a changeset for @runfusion/fusion documenting the shipped skill documentation refresh
This commit is contained in:
Fusion
@@ -17,27 +17,27 @@ fn dashboard --dev # Web UI only (no AI engine)
|
||||
```bash
|
||||
fn task create "description" # Create task → triage
|
||||
fn task create "desc" --attach file.png # Create with attachment
|
||||
fn task create "desc" --depends KB-001 # Create with dependency
|
||||
fn task create "desc" --depends FN-001 # Create with dependency
|
||||
fn task plan "description" # AI-guided planning mode
|
||||
fn task list # List all tasks by column
|
||||
fn task show KB-001 # Show task details + steps + log
|
||||
fn task move KB-001 todo # Move task to column
|
||||
fn task merge KB-001 # Merge in-review task to main
|
||||
fn task duplicate KB-001 # Copy task to triage
|
||||
fn task refine KB-001 --feedback "..." # Create follow-up task
|
||||
fn task archive KB-001 # Move done → archived
|
||||
fn task unarchive KB-001 # Move archived → done
|
||||
fn task delete KB-001 [--force] # Permanently delete
|
||||
fn task retry KB-001 # Retry failed task → todo
|
||||
fn task comment KB-001 "text" # Add general comment
|
||||
fn task comments KB-001 # List task comments
|
||||
fn task steer KB-001 "guidance" # Add steering comment for AI
|
||||
fn task pause KB-001 # Pause automation
|
||||
fn task unpause KB-001 # Resume automation
|
||||
fn task logs KB-001 # View agent execution logs
|
||||
fn task logs KB-001 --follow # Stream logs in real-time
|
||||
fn task logs KB-001 --limit 50 # Limit log lines
|
||||
fn task logs KB-001 --type tool # Filter by log type
|
||||
fn task show FN-001 # Show task details + steps + log
|
||||
fn task move FN-001 todo # Move task to column
|
||||
fn task merge FN-001 # Merge in-review task to main
|
||||
fn task duplicate FN-001 # Copy task to triage
|
||||
fn task refine FN-001 --feedback "..." # Create follow-up task
|
||||
fn task archive FN-001 # Move done → archived
|
||||
fn task unarchive FN-001 # Move archived → done
|
||||
fn task delete FN-001 [--force] # Permanently delete
|
||||
fn task retry FN-001 # Retry failed task → todo
|
||||
fn task comment FN-001 "text" # Add general comment
|
||||
fn task comments FN-001 # List task comments
|
||||
fn task steer FN-001 "guidance" # Add steering comment for AI
|
||||
fn task pause FN-001 # Pause automation
|
||||
fn task unpause FN-001 # Resume automation
|
||||
fn task logs FN-001 # View agent execution logs
|
||||
fn task logs FN-001 --follow # Stream logs in real-time
|
||||
fn task logs FN-001 --limit 50 # Limit log lines
|
||||
fn task logs FN-001 --type tool # Filter by log type
|
||||
```
|
||||
|
||||
## Mission Management
|
||||
@@ -57,9 +57,9 @@ fn task import owner/repo # Import all open issues
|
||||
fn task import owner/repo --interactive # Select issues interactively
|
||||
fn task import owner/repo --limit 10 # Limit import count
|
||||
fn task import owner/repo --labels bug # Filter by labels
|
||||
fn task pr-create KB-001 # Create GitHub PR
|
||||
fn task pr-create KB-001 --title "Fix" # PR with custom title
|
||||
fn task pr-create KB-001 --base main # PR targeting specific base
|
||||
fn task pr-create FN-001 # Create GitHub PR
|
||||
fn task pr-create FN-001 --title "Fix" # PR with custom title
|
||||
fn task pr-create FN-001 --base main # PR targeting specific base
|
||||
```
|
||||
|
||||
## Git Operations
|
||||
|
||||
@@ -241,7 +241,7 @@ Activate a pending slice for implementation.
|
||||
|
||||
### fn_feature_link_task
|
||||
|
||||
Link a feature to a kb task. Updates feature status to triaged.
|
||||
Link a feature to a Fusion task. Updates feature status to triaged.
|
||||
|
||||
| Parameter | Type | Required | Description |
|
||||
|-----------|------|----------|-------------|
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## Overview
|
||||
|
||||
Fusion (kb) is an AI-orchestrated task board. Tasks flow through columns:
|
||||
Fusion is an AI-orchestrated task board. Tasks flow through columns:
|
||||
Triage → Todo → In Progress → In Review → Done → Archived
|
||||
|
||||
## Pi Extension Tools (Available to Agents)
|
||||
@@ -14,7 +14,7 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
|
||||
| `fn_task_create` | Create a new task in triage |
|
||||
| `fn_task_update` | Update task title, description, or dependencies |
|
||||
| `fn_task_list` | List all tasks grouped by column |
|
||||
| `fn_task_show` | Show full task details, steps, log |
|
||||
| `fn_task_show` | Show full task details, steps, and log preview |
|
||||
| `fn_task_attach` | Attach a file to a task |
|
||||
| `fn_task_pause` | Pause automation for a task |
|
||||
| `fn_task_unpause` | Resume automation for a task |
|
||||
@@ -44,45 +44,36 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
|
||||
|
||||
## CLI Commands (fn)
|
||||
|
||||
### Dashboard
|
||||
### Dashboard and Node Runtime
|
||||
- `fn dashboard` — Start web UI + AI engine
|
||||
- `fn dashboard --paused` — Start with automation paused
|
||||
- `fn dashboard --dev` — Start web UI only (no AI engine)
|
||||
- `fn serve` — Start headless node mode (API + engine, no UI)
|
||||
- `fn daemon` — Start daemon mode with auth
|
||||
|
||||
### Task Management
|
||||
- `fn task create "description"` — Create a new task
|
||||
- `fn task plan "description"` — AI-guided planning mode
|
||||
- `fn task list` — List all tasks
|
||||
- `fn task show KB-001` — Show task details
|
||||
- `fn task move KB-001 todo` — Move task to a column
|
||||
- `fn task merge KB-001` — Merge an in-review task
|
||||
- `fn task duplicate KB-001` — Duplicate a task
|
||||
- `fn task refine KB-001 --feedback "..."` — Create refinement task
|
||||
- `fn task archive/unarchive KB-001` — Archive/restore tasks
|
||||
- `fn task delete KB-001` — Delete a task
|
||||
- `fn task retry KB-001` — Retry a failed task
|
||||
- `fn task comment KB-001 "..."` — Add a task comment
|
||||
- `fn task steer KB-001 "..."` — Add steering comment
|
||||
- `fn task pause/unpause KB-001` — Control automation
|
||||
- `fn task logs KB-001` — View task agent logs
|
||||
- `fn task show FN-001` — Show task details
|
||||
- `fn task move FN-001 todo` — Move task to a column
|
||||
- `fn task merge FN-001` — Merge an in-review task
|
||||
- `fn task duplicate FN-001` — Duplicate a task
|
||||
- `fn task refine FN-001 --feedback "..."` — Create refinement task
|
||||
- `fn task archive FN-001` / `fn task unarchive FN-001` — Archive/restore tasks
|
||||
- `fn task delete FN-001` — Delete a task
|
||||
- `fn task retry FN-001` — Retry a failed task
|
||||
- `fn task comment FN-001 "..."` — Add a task comment
|
||||
- `fn task steer FN-001 "..."` — Add steering comment
|
||||
- `fn task pause FN-001` / `fn task unpause FN-001` — Control automation
|
||||
- `fn task logs FN-001` — View task agent logs
|
||||
|
||||
### GitHub Integration
|
||||
### GitHub, Skills, and Settings
|
||||
- `fn task import owner/repo` — Batch import issues
|
||||
- `fn task import owner/repo -i` — Interactive import
|
||||
- `fn task pr-create KB-001` — Create PR for task
|
||||
|
||||
### Git Commands
|
||||
- `fn git status/fetch/pull/push` — Git operations
|
||||
|
||||
### Settings
|
||||
- `fn settings` — Show current settings
|
||||
- `fn settings set key value` — Update a setting
|
||||
|
||||
## AI Engine Components
|
||||
|
||||
1. **TriageProcessor** — Auto-specifications for tasks in triage column
|
||||
2. **Scheduler** — Dependency resolution, concurrency management
|
||||
3. **TaskExecutor** — Creates worktrees, executes tasks with coding tools
|
||||
- `fn task pr-create FN-001` — Create PR for task
|
||||
- `fn skills search "react"` — Search skill registry
|
||||
- `fn skills install owner/repo --skill <name>` — Install a skill
|
||||
- `fn settings` / `fn settings set key value` — View/update settings
|
||||
|
||||
## Task Storage Structure
|
||||
|
||||
@@ -90,7 +81,7 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
|
||||
.fusion/
|
||||
├── fusion.db # SQLite database (WAL mode)
|
||||
└── tasks/
|
||||
└── KB-001/
|
||||
└── FN-001/
|
||||
├── PROMPT.md # Task specification
|
||||
├── agent.log # Execution logs
|
||||
└── attachments/ # File attachments
|
||||
@@ -107,7 +98,7 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
|
||||
- Workflow step manager
|
||||
- Scheduled tasks (automations)
|
||||
- GitHub import modal
|
||||
- Theme system (8+ themes, dark/light/system)
|
||||
- Theme system with dark/light support and color themes
|
||||
|
||||
## Key Settings
|
||||
|
||||
@@ -117,6 +108,6 @@ All skill/extension tool invocations in this catalog use the public `fn_*` names
|
||||
| `maxTriageConcurrent` | 2 | Concurrent triage/specification agents. Falls back to `maxConcurrent` when undefined. |
|
||||
| `autoMerge` | true | Auto-merge completed tasks |
|
||||
| `requirePlanApproval` | false | Manual approval for specs |
|
||||
| `prCompletionMode` | direct | Completion: direct/pr-first |
|
||||
| `prCompletionMode` | direct | Completion mode: direct/pr-first |
|
||||
| `taskStuckTimeoutMs` | — | Stuck task detection timeout |
|
||||
| `recycleWorktrees` | false | Pool and reuse worktrees |
|
||||
|
||||
@@ -12,7 +12,7 @@ Fusion uses a hybrid storage architecture: structured metadata in SQLite, large
|
||||
├── fusion.db # SQLite database (WAL mode)
|
||||
├── config.json # Board config + workflow steps
|
||||
└── tasks/
|
||||
└── KB-001/
|
||||
└── FN-001/
|
||||
├── PROMPT.md # Task specification (generated by triage AI)
|
||||
├── agent.log # Execution logs from the AI agent
|
||||
└── attachments/ # File attachments
|
||||
@@ -26,7 +26,7 @@ Key fields stored in the `tasks` table:
|
||||
|
||||
| Field | Type | Description |
|
||||
|-------|------|-------------|
|
||||
| `id` | string | Task ID (e.g., KB-001) |
|
||||
| `id` | string | Task ID (e.g., FN-001) |
|
||||
| `title` | string? | Short title (optional, can be auto-generated) |
|
||||
| `description` | string | Full task description |
|
||||
| `column` | string | Current column: triage/todo/in-progress/in-review/done/archived |
|
||||
@@ -56,7 +56,7 @@ Key fields stored in the `tasks` table:
|
||||
The AI triage agent generates this file with the following structure:
|
||||
|
||||
```markdown
|
||||
# Task: KB-001 — Task Title
|
||||
# Task: FN-001 — Task Title
|
||||
|
||||
**Created:** 2026-03-31
|
||||
**Size:** M
|
||||
@@ -69,7 +69,7 @@ What the task should accomplish.
|
||||
|
||||
## Dependencies
|
||||
|
||||
- KB-040 — Prerequisite task description
|
||||
- FN-040 — Prerequisite task description
|
||||
|
||||
## Context to Read First
|
||||
|
||||
|
||||
Reference in New Issue
Block a user