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
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: fusion
|
||||
description: AI-orchestrated task board (Fusion) interface. Use when working with the Fusion task management system, creating or managing tasks, understanding task workflows, organizing work into missions, or interfacing with the fusion dashboard. Triggers on "create a task", "list tasks", "show board", "plan a mission", "check task status", "import issues", or any Fusion interaction.
|
||||
description: AI-orchestrated task board (Fusion) interface. Use when working with the Fusion task management system, creating or managing tasks, understanding task workflows, organizing work into missions, or interfacing with the Fusion dashboard. Triggers on "create a task", "list tasks", "show board", "plan a mission", "check task status", "import issues", or any Fusion interaction.
|
||||
---
|
||||
|
||||
<essential_principles>
|
||||
@@ -61,7 +61,7 @@ Use `fn_task_create` with a descriptive message. Include the problem AND desired
|
||||
Use `fn_task_list` to see all tasks grouped by column. Use `column` param to filter.
|
||||
|
||||
**Show task details:**
|
||||
Use `fn_task_show` with the task ID (e.g., KB-001) to see steps, progress, and log.
|
||||
Use `fn_task_show` with the task ID (e.g., FN-001) to see steps, progress, and log.
|
||||
|
||||
**Plan complex work:**
|
||||
Use `fn_task_plan` for AI-guided planning that interviews you before creating the task.
|
||||
@@ -84,7 +84,7 @@ These operations are **not available** via pi extension tools and require the da
|
||||
- **Moving tasks between columns** — No tool for column moves (handled by the AI engine)
|
||||
- **Workflow steps** — Creating/managing workflow step definitions requires the dashboard
|
||||
- **Settings** — Changing settings requires the dashboard or `fn settings set` CLI command
|
||||
- **Steering comments** — Adding steering comments to guide task execution requires CLI (`fn task steer`)
|
||||
- **Task comments** — Adding comments or steering guidance requires CLI (`fn task comment`, `fn task steer`) or the dashboard comments tab
|
||||
- **Merge operations** — Merging completed tasks requires CLI (`fn task merge`) or auto-merge
|
||||
|
||||
For these operations, guide the user to the dashboard (`/fn`) or CLI commands documented in workflows/dashboard-cli.md.
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
@@ -32,11 +32,11 @@ These cannot be done with pi extension tools:
|
||||
|
||||
| Operation | CLI Command | Dashboard |
|
||||
|-----------|-------------|-----------|
|
||||
| Move task to column | `fn task move KB-001 todo` | Drag card between columns |
|
||||
| Merge completed task | `fn task merge KB-001` | Click merge in task detail |
|
||||
| Add steering comment | `fn task steer KB-001 "Use TypeScript"` | Comments tab in task detail |
|
||||
| Add general comment | `fn task comment KB-001 "Looks good"` | Comments tab in task detail |
|
||||
| View agent logs | `fn task logs KB-001 --follow` | Agent log tab in task detail |
|
||||
| Move task to column | `fn task move FN-001 todo` | Drag card between columns |
|
||||
| Merge completed task | `fn task merge FN-001` | Click merge in task detail |
|
||||
| Add steering comment | `fn task steer FN-001 "Use TypeScript"` | Comments tab in task detail |
|
||||
| Add general comment | `fn task comment FN-001 "Looks good"` | Comments tab in task detail |
|
||||
| View agent logs | `fn task logs FN-001 --follow` | Agent log tab in task detail |
|
||||
| Change settings | `fn settings set maxConcurrent 4` | Settings modal |
|
||||
| Create workflow steps | — | Workflow Steps button in header |
|
||||
| Git operations | `fn git status/fetch/pull/push` | Git manager panel |
|
||||
@@ -60,7 +60,7 @@ Key settings (configure via dashboard Settings or `fn settings set`):
|
||||
|
||||
When `prCompletionMode` is set to "pr-first":
|
||||
- Completed tasks create a GitHub PR instead of direct-merging
|
||||
- Use `fn task pr-create KB-001` to manually create a PR for any in-review task
|
||||
- Use `fn task pr-create FN-001` to manually create a PR for any in-review task
|
||||
- PRs can be reviewed and merged through the normal GitHub workflow
|
||||
|
||||
**Backup operations:**
|
||||
|
||||
@@ -94,11 +94,11 @@ For large-scale projects spanning multiple tasks, use the mission hierarchy:
|
||||
fn_slice_activate({ id: "SL-001" })
|
||||
```
|
||||
|
||||
6. **Link features to tasks** — Connect features to kb tasks
|
||||
6. **Link features to tasks** — Connect features to Fusion tasks
|
||||
```
|
||||
fn_task_create({ description: "Create user model with email, password hash, and timestamps" })
|
||||
# → Created KB-101
|
||||
fn_feature_link_task({ featureId: "F-001", taskId: "KB-101" })
|
||||
# → Created FN-101
|
||||
fn_feature_link_task({ featureId: "F-001", taskId: "FN-101" })
|
||||
```
|
||||
|
||||
**Mission status flows automatically:**
|
||||
|
||||
@@ -87,7 +87,7 @@ The AI triage agent sets the review level based on task complexity and risk asse
|
||||
**Interpreting `fn_task_show` output:**
|
||||
|
||||
```
|
||||
KB-042: Fix login validation
|
||||
FN-042: Fix login validation
|
||||
Column: In Progress · Size: M · Review: 2
|
||||
|
||||
Steps (2/5):
|
||||
|
||||
@@ -29,7 +29,7 @@ Example:
|
||||
```
|
||||
fn_task_create({
|
||||
description: "The login form doesn't validate email format before submission. Add client-side email validation that shows an inline error message when the email is invalid. Use the existing form validation pattern from the signup form.",
|
||||
depends: ["KB-042"]
|
||||
depends: ["FN-042"]
|
||||
})
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user