cli: route the default skill to existing workflows

Remove authoring from the skill description and move the authoring commands
and examples behind an explicit-request section in help. A skill test keeps the
default description from advertising authoring again.
This commit is contained in:
2026-10-20 13:24:53 +01:00
parent 122eca8e1b
commit 7758d20feb
3 changed files with 36 additions and 21 deletions
+1 -1
View File
@@ -1,6 +1,6 @@
---
name: Pipelines
description: Use and author Pipelines workflows, inspect runs, and recover or deliver project work directly when that is the simpler route.
description: Use existing Pipelines workflows to run, inspect, wait, recover and deliver project work. Use only when the work belongs in an existing pipeline; authoring is a separate, explicit task.
---
# Pipelines
+13
View File
@@ -50,6 +50,19 @@ func TestEveryEmbeddedReferenceIsInstalledAndLinksResolve(t *testing.T) {
}
}
func TestDefaultSkillDoesNotAdvertiseAuthoring(t *testing.T) {
main, err := content.ReadFile("skill/SKILL.md")
if err != nil {
t.Fatal(err)
}
if !strings.Contains(string(main), "description: Use existing Pipelines workflows") {
t.Fatal("default skill description must route to existing workflows only")
}
if strings.Contains(string(main), "description: Use and author Pipelines workflows") {
t.Fatal("default skill must not advertise authoring")
}
}
func TestThreeFileSkillUpgradesWithAllNewReferences(t *testing.T) {
t.Setenv("XDG_CONFIG_HOME", t.TempDir())
dir, err := InstallSkill()
+22 -20
View File
@@ -4,23 +4,6 @@ const help = `PIPELINES — reusable workflows for your repositories
Usage: pipelines <command> [arguments] [options]
AUTHOR
new [name] [prompt] Create a draft and open the configured harness
edit [name|id] [prompt] Pick a pipeline, draft changes, open a configured harness
drafts List retained draft files (including TUI drafts)
validate <draft.md> Check a draft using the server's validator
submit <draft.md> Explicitly publish a new immutable version
BROWSE
list List registered pipelines
search QUERY Search pipelines, versions, runs, steps, field text, artifacts
show <name|id> Inspect graph, settings, source and history
versions <name|id> List immutable versions
export [name|id ...] Select/export definitions as ZIP; one name prints Markdown
import [FILE.zip] Select/import definitions; explicitly resolve conflicts
templates List optional templates (never seeds the DB)
template <key> Inspect a template; --source prints Markdown
EXECUTE
provider-check Validate a provider/model with a tool-free response
run [name] [prompt] Fuzzy selection, multiline prompt, live inspector
@@ -41,6 +24,23 @@ EXECUTE
version Identify this CLI build without connecting (--version)
rpc <request.json|-> Send any protocol command (automation escape hatch)
BROWSE
list List registered pipelines
search QUERY Search pipelines, versions, runs, steps, field text, artifacts
show <name|id> Inspect graph, settings, source and history
versions <name|id> List immutable versions
export [name|id ...] Select/export definitions as ZIP; one name prints Markdown
templates List optional templates (never seeds the DB)
template <key> Inspect a template; --source prints Markdown
AUTHORING — only when the user explicitly asks to create or change a definition
new [name] [prompt] Create a draft and open the configured harness
edit [name|id] [prompt] Pick a pipeline, draft changes, open a configured harness
drafts List retained draft files (including TUI drafts)
validate <draft.md> Check a draft using the server's validator
submit <draft.md> Explicitly publish a new immutable version
import [FILE.zip] Select/import definitions; explicitly resolve conflicts
MAINTAIN
retention report Show what a run-history policy would remove (read-only)
retention apply Remove it after approval; artifacts go with their run
@@ -52,7 +52,7 @@ SERVER / INTERFACE
serve Start native server in the foreground (Ctrl+C stops it)
service enable Configure user autostart
service disable | status Stop/remove autostart, or inspect OS service status
skill install Install/update the shared Pi/OpenCode authoring skill
skill install Install/update the shared Pi/OpenCode workflow skill
uninstall [--yes] Remove verified Go binaries; retain data and drafts
Legacy managed installs: select PIPELINES_PREFIX explicitly for start/stop,
@@ -69,13 +69,15 @@ Stage result format:
envelope remains accepted for compatibility.
Examples:
pipelines run "bug fix" "Fix the layout" --json
pipelines run "bug fix" "Fix the layout" --model openai/gpt-5 --stage-model review=openai/o4 --json
Authoring examples — use only when the operator explicitly requested a definition change:
pipelines edit "bug fix" "Add a review step"
pipelines new "release notes" "Summarize changes and notify my phone"
pipelines new "Add a feature" --template task --no-open --json --yes
pipelines validate /path/to/draft.md --json
pipelines submit /path/to/draft.md
pipelines run "bug fix" "Fix the layout" --json
pipelines run "bug fix" "Fix the layout" --model openai/gpt-5 --stage-model review=openai/o4 --json
Run retention (local, explicit, never automatic):
pipelines retention report --db ~/.local/share/pipelines/data/pipelines.db --keep 200 --json