Install shared authoring skill and add retained drafts browser
This commit is contained in:
+24
-11
@@ -2,16 +2,16 @@
|
||||
|
||||
`pipelines help` lists commands; `pipelines help edit` (or `edit --help`) shows
|
||||
command-specific flags and examples. Installed commands work from any directory.
|
||||
The installed command is a compiled Go binary; only service lifecycle management
|
||||
delegates to the private Python helper. The binary discovers its manifest through
|
||||
the system command symlink. A separately `go install ./cmd/pipelines`-installed
|
||||
binary can select a managed installation using `PIPELINES_PREFIX`.
|
||||
The installed command is a compiled Go binary. Optional autostart uses the OS user
|
||||
service manager directly. Legacy Python-managed installations require an explicit
|
||||
`PIPELINES_PREFIX`; no configuration is inferred from the executable's location.
|
||||
For source development, use `go run ./cmd/pipelines help`; start the native server
|
||||
separately. Set `PIPELINES_URL` or pass `--url` to select another server.
|
||||
|
||||
## Draft-first OpenCode workflow
|
||||
|
||||
```sh
|
||||
pipelines new # OpenCode asks what to build and names it
|
||||
pipelines edit # fuzzy pipeline selection
|
||||
pipelines edit "bug fix" # ask OpenCode what to change
|
||||
pipelines edit "bug fix" "Add a review step"
|
||||
@@ -19,19 +19,32 @@ pipelines new "release notes" "Summarize changes and notify my phone"
|
||||
pipelines new "weekly digest" --template scheduled-summary
|
||||
```
|
||||
|
||||
`new` asks for a name when omitted. `edit` accepts an exact name or ID, with names
|
||||
taking precedence over numeric IDs. Both copy a definition into a private draft
|
||||
and launch the host OpenCode interface. An isolated authoring workspace contains
|
||||
the bundled `pipelines` skill and format reference. The CLI creates an OpenCode
|
||||
session and **explicitly activates the skill with `resume=false` before opening
|
||||
the interface**. It does not modify shared OpenCode configuration or copy login
|
||||
credentials. Your OpenCode permissions remain in effect; auto-approval is not used.
|
||||
`new` opens OpenCode immediately when its name/request is omitted. The skill asks
|
||||
only for missing decisions and records the chosen name in draft metadata. `edit`
|
||||
accepts an exact name or ID, with names taking precedence over numeric IDs.
|
||||
Both retain private drafts and launch the host interface once with a short
|
||||
`@pipelines` reference and context-file path. There is no preliminary OpenCode
|
||||
API call, temporary service, session creation, or instruction preload.
|
||||
`install.sh` installs/updates the global skill and format reference. Plain
|
||||
`go install` users run `pipelines skill install` separately. Shared login/config
|
||||
and user-modified skills are preserved; OpenCode permissions remain in effect.
|
||||
|
||||
The skill encourages editing only the draft, running server validation, summarizing
|
||||
the changes, and leaving submission to the user. This is an instruction, not a
|
||||
security sandbox: an agent with CLI/shell access can submit when explicitly asked.
|
||||
Every submission, including agent-issued `submit`/`rpc`, still uses server validation.
|
||||
|
||||
## Drafts in the TUI
|
||||
|
||||
Press `d` on the dashboard or use `:drafts` to browse the same retained drafts as
|
||||
`pipelines drafts`. Use `n/p` to select, `j/k` to scroll source, `e`/Enter to reopen
|
||||
the existing draft, `v` for server validation, and `s` for submission confirmation.
|
||||
`r` refreshes the list. Submission preserves create-only/version guards and rejects
|
||||
drafts belonging to another server. An unnamed draft must be named through OpenCode
|
||||
or CLI `submit --name`. Draft selection/editor completion never publishes it.
|
||||
New unnamed drafts open OpenCode so the skill can name them. For named drafts,
|
||||
the default editor is OpenCode; explicit `VISUAL`/`EDITOR` overrides remain.
|
||||
|
||||
For agents or scripts that should not open a terminal:
|
||||
|
||||
```sh
|
||||
|
||||
Reference in New Issue
Block a user