From 7758d20feb6cdea3538861b37d5fc2aae9ea3bbc Mon Sep 17 00:00:00 2001 From: Alan Silva Date: Tue, 20 Oct 2026 13:24:53 +0100 Subject: [PATCH] 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. --- internal/author/skill/SKILL.md | 2 +- internal/author/skill_reference_test.go | 13 ++++++++ internal/cli/help.go | 42 +++++++++++++------------ 3 files changed, 36 insertions(+), 21 deletions(-) diff --git a/internal/author/skill/SKILL.md b/internal/author/skill/SKILL.md index 08af722b..cd0a3c12 100644 --- a/internal/author/skill/SKILL.md +++ b/internal/author/skill/SKILL.md @@ -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 diff --git a/internal/author/skill_reference_test.go b/internal/author/skill_reference_test.go index 97fc6249..ff33e483 100644 --- a/internal/author/skill_reference_test.go +++ b/internal/author/skill_reference_test.go @@ -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() diff --git a/internal/cli/help.go b/internal/cli/help.go index 51ddf8d7..16b33982 100644 --- a/internal/cli/help.go +++ b/internal/cli/help.go @@ -4,23 +4,6 @@ const help = `PIPELINES — reusable workflows for your repositories Usage: pipelines [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 Check a draft using the server's validator - submit Explicitly publish a new immutable version - -BROWSE - list List registered pipelines - search QUERY Search pipelines, versions, runs, steps, field text, artifacts - show Inspect graph, settings, source and history - versions 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 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 Send any protocol command (automation escape hatch) +BROWSE + list List registered pipelines + search QUERY Search pipelines, versions, runs, steps, field text, artifacts + show Inspect graph, settings, source and history + versions List immutable versions + export [name|id ...] Select/export definitions as ZIP; one name prints Markdown + templates List optional templates (never seeds the DB) + template 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 Check a draft using the server's validator + submit 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