chore: move skills to .agents/skills, remove .pi
This commit is contained in:
@@ -1 +0,0 @@
|
||||
../../.pi/skills/hai-board
|
||||
85
.agents/skills/hai-board/SKILL.md
Normal file
85
.agents/skills/hai-board/SKILL.md
Normal file
@@ -0,0 +1,85 @@
|
||||
---
|
||||
name: hai-board
|
||||
description: Start and manage the hai dashboard web UI and AI engine. Use when asked to start the board, run the dashboard, enable the AI engine, or configure hai settings.
|
||||
---
|
||||
|
||||
# hai board
|
||||
|
||||
## Start the dashboard
|
||||
|
||||
```bash
|
||||
hai dashboard
|
||||
```
|
||||
|
||||
Opens the kanban board at http://localhost:4040.
|
||||
|
||||
Options:
|
||||
- `--port <N>` or `-p <N>` — custom port (default: 4040)
|
||||
- `--engine` — enable the AI engine (auto-triage, scheduling, execution)
|
||||
- `--no-open` — don't open the browser automatically
|
||||
|
||||
### With AI engine
|
||||
|
||||
```bash
|
||||
hai dashboard --engine
|
||||
```
|
||||
|
||||
Enables:
|
||||
- **Triage processor** — auto-specifies tasks in the triage column
|
||||
- **Scheduler** — moves todo tasks to in-progress when dependencies are met
|
||||
- **Executor** — runs tasks in git worktrees via AI agents
|
||||
- **Auto-merge** — squash-merges completed tasks to main
|
||||
- **Cross-model review** — independent reviewer agent checks work at step boundaries
|
||||
|
||||
### Development mode
|
||||
|
||||
Run in two terminals:
|
||||
|
||||
```bash
|
||||
# Terminal 1: start the server + engine
|
||||
hai dashboard --engine
|
||||
|
||||
# Terminal 2: watch-rebuild the React dashboard UI
|
||||
pnpm dev:ui
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
Settings are in `.hai/config.json`:
|
||||
|
||||
```json
|
||||
{
|
||||
"nextId": 27,
|
||||
"settings": {
|
||||
"maxConcurrent": 4,
|
||||
"maxWorktrees": 4,
|
||||
"pollIntervalMs": 15000,
|
||||
"autoMerge": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| Setting | Description | Default |
|
||||
|---------|-------------|---------|
|
||||
| `maxConcurrent` | Max tasks executing simultaneously | 2 |
|
||||
| `maxWorktrees` | Max git worktrees | 4 |
|
||||
| `pollIntervalMs` | Scheduler/triage poll interval | 15000 |
|
||||
| `autoMerge` | Auto-merge tasks when they reach in-review | false |
|
||||
|
||||
## Task storage
|
||||
|
||||
Tasks live in `.hai/tasks/`:
|
||||
|
||||
```
|
||||
.hai/
|
||||
├── config.json
|
||||
└── tasks/
|
||||
└── HAI-001/
|
||||
├── task.json # Metadata, steps, log
|
||||
└── PROMPT.md # Task specification
|
||||
```
|
||||
|
||||
## Prerequisites
|
||||
|
||||
The AI engine requires [pi](https://github.com/badlogic/pi-mono) with
|
||||
configured API keys. Run `pi` first to set up authentication.
|
||||
@@ -1 +0,0 @@
|
||||
../../.pi/skills/hai-task
|
||||
110
.agents/skills/hai-task/SKILL.md
Normal file
110
.agents/skills/hai-task/SKILL.md
Normal file
@@ -0,0 +1,110 @@
|
||||
---
|
||||
name: hai-task
|
||||
description: Create, manage, and track tasks on the hai board. Use when asked to create a task, file a bug, report an issue, check task status, update progress, or interact with the hai task board in any way.
|
||||
---
|
||||
|
||||
# hai task
|
||||
|
||||
hai is an AI-orchestrated task board. Tasks flow through columns:
|
||||
**triage → todo → in-progress → in-review → done**
|
||||
|
||||
## Commands
|
||||
|
||||
### Create a task
|
||||
|
||||
```bash
|
||||
hai task create "description of what needs to be done"
|
||||
```
|
||||
|
||||
Creates a task in **triage**. The AI triage agent will specify it into a full
|
||||
PROMPT.md with steps, file scope, review level, and acceptance criteria, then
|
||||
move it to **todo**.
|
||||
|
||||
Tips:
|
||||
- Be descriptive — the triage agent uses this to write the spec
|
||||
- Include the problem AND desired outcome when possible
|
||||
- For bugs, describe the current behavior and expected behavior
|
||||
- No need to specify how to fix it — the triage agent figures that out
|
||||
|
||||
### List tasks
|
||||
|
||||
```bash
|
||||
hai task list
|
||||
```
|
||||
|
||||
Shows all tasks grouped by column with IDs and descriptions.
|
||||
|
||||
### Show task details
|
||||
|
||||
```bash
|
||||
hai task show HAI-001
|
||||
```
|
||||
|
||||
Shows full task info: steps, progress, log entries, dependencies.
|
||||
|
||||
### Move a task
|
||||
|
||||
```bash
|
||||
hai task move HAI-001 <column>
|
||||
```
|
||||
|
||||
Columns: `triage`, `todo`, `in-progress`, `in-review`, `done`
|
||||
|
||||
Transitions are validated:
|
||||
- triage → todo
|
||||
- todo → in-progress, triage
|
||||
- in-progress → in-review
|
||||
- in-review → done, in-progress
|
||||
- done → (none)
|
||||
|
||||
### Update step status
|
||||
|
||||
```bash
|
||||
hai task update HAI-001 <step-number> <status>
|
||||
```
|
||||
|
||||
Status: `pending`, `in-progress`, `done`, `skipped`
|
||||
|
||||
Steps are 0-indexed and auto-parsed from the PROMPT.md headings.
|
||||
|
||||
### Log an entry
|
||||
|
||||
```bash
|
||||
hai task log HAI-001 "what happened"
|
||||
```
|
||||
|
||||
Adds a timestamped log entry visible on the task card.
|
||||
|
||||
### Merge a completed task
|
||||
|
||||
```bash
|
||||
hai task merge HAI-001
|
||||
```
|
||||
|
||||
Squash-merges the task's branch into main with an AI-written commit message.
|
||||
Only works for tasks in **in-review**. Resolves conflicts via AI if needed.
|
||||
Cleans up the worktree and branch after merge.
|
||||
|
||||
## Workflow
|
||||
|
||||
1. **Create** — `hai task create "description"` → goes to triage
|
||||
2. **Triage** — AI agent reads the codebase, writes a PROMPT.md spec, moves to todo
|
||||
3. **Schedule** — Scheduler moves to in-progress when deps are met and concurrency allows
|
||||
4. **Execute** — AI agent works the task in a git worktree, reports progress via tools
|
||||
5. **Review** — Cross-model reviewer checks plan/code at step boundaries
|
||||
6. **Merge** — `hai task merge HAI-001` squash-merges to main
|
||||
|
||||
## Filing good tasks
|
||||
|
||||
A task can be anything from a rough idea to a detailed spec:
|
||||
|
||||
```bash
|
||||
# Rough — triage agent will flesh it out
|
||||
hai task create "the login page is slow"
|
||||
|
||||
# Specific — triage agent will structure it
|
||||
hai task create "Add rate limiting to POST /api/tasks. Use a token bucket algorithm with 100 req/min per IP. Return 429 with Retry-After header when exceeded."
|
||||
|
||||
# Bug report
|
||||
hai task create "hai task show truncates description to 60 chars. Should show the full text."
|
||||
```
|
||||
Reference in New Issue
Block a user