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:
@@ -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
|
||||
|
||||
@@ -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
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user