@operatorstack/yield 0.3.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -32
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -36,37 +36,6 @@ coding-agent judgment, then continue with structured data in normal code.
|
|
|
36
36
|
Verified with Cursor, Codex, and Claude Code. Registry-backed project paths are
|
|
37
37
|
available for 73 more coding agents.
|
|
38
38
|
|
|
39
|
-
## Start with your coding agent
|
|
40
|
-
|
|
41
|
-
Run the command for your project:
|
|
42
|
-
|
|
43
|
-
| Language | Command |
|
|
44
|
-
| ---------- | -------------------------------------------------------------------------------------------------------------- |
|
|
45
|
-
| TypeScript | `npm create @operatorstack/yield@latest` |
|
|
46
|
-
| Python | `uvx --from yieldskill yskill bootstrap --language python` |
|
|
47
|
-
| Rust | `cargo install yieldskill --root .yield --locked`, then `.yield/bin/yskill bootstrap --root . --language rust` |
|
|
48
|
-
| Go | `go run github.com/operatorstack/yield/cmd/yskill@latest bootstrap --root . --language go` |
|
|
49
|
-
|
|
50
|
-
Yield detects the repository, language, and installed coding agents. It shows
|
|
51
|
-
every proposed file and dependency change. It asks before it writes. It then
|
|
52
|
-
installs, tests, and registers the `yield-workflow-builder` skill workflow.
|
|
53
|
-
|
|
54
|
-
Restart your coding agent. To create a new skill workflow, ask:
|
|
55
|
-
|
|
56
|
-
```text
|
|
57
|
-
Use Yield to create a tested skill workflow for releasing my package.
|
|
58
|
-
```
|
|
59
|
-
|
|
60
|
-
To convert an existing `SKILL.md`, ask:
|
|
61
|
-
|
|
62
|
-
```text
|
|
63
|
-
Use Yield to convert my existing release SKILL.md into a tested skill workflow.
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
The builder can create a skill workflow from a description. It can also
|
|
67
|
-
convert an existing `SKILL.md`. Yield does not use install hooks to change the
|
|
68
|
-
repository.
|
|
69
|
-
|
|
70
39
|
## Move repeated instructions into code
|
|
71
40
|
|
|
72
41
|
A release skill often starts as prose:
|
|
@@ -136,7 +105,7 @@ Replace them with the test, publish, and registry commands for your project.
|
|
|
136
105
|
The complete tested source is in
|
|
137
106
|
[`examples/release-checklist`](https://github.com/operatorstack/yield/tree/main/examples/release-checklist/).
|
|
138
107
|
|
|
139
|
-
##
|
|
108
|
+
## Create a workflow
|
|
140
109
|
|
|
141
110
|
### 1. Install Yield
|
|
142
111
|
|
|
@@ -231,6 +200,32 @@ Use the release skill to publish this package.
|
|
|
231
200
|
The agent follows the generated adapter, runs the canonical workflow in
|
|
232
201
|
`skills/release`, and asks for each required agent or user response.
|
|
233
202
|
|
|
203
|
+
## Optional: install the developer helper
|
|
204
|
+
|
|
205
|
+
Package installation does not create skills or coding-agent adapters. After
|
|
206
|
+
you understand the manual flow above, you can explicitly install the guided
|
|
207
|
+
helper:
|
|
208
|
+
|
|
209
|
+
| Language | Command |
|
|
210
|
+
| ---------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
211
|
+
| TypeScript | `npm exec -- yskill helper install --language typescript` |
|
|
212
|
+
| Python | `python -m yieldskill helper install --language python` |
|
|
213
|
+
| Rust | `cargo install yieldskill --root .yield --locked`, then `.yield/bin/yskill helper install --root . --language rust` |
|
|
214
|
+
| Go | `go run github.com/operatorstack/yield/cmd/yskill@latest helper install --root . --language go` |
|
|
215
|
+
|
|
216
|
+
The installer first prints one ordered plan with resolved paths, dependency
|
|
217
|
+
preparation, workflow testing, registration for the selected agents, and final
|
|
218
|
+
adapter verification. Review it before answering
|
|
219
|
+
`Apply this helper install plan? [y/N]`.
|
|
220
|
+
|
|
221
|
+
The helper is installed as `skills/yield-workflow-builder`. It can explain,
|
|
222
|
+
create, convert, check, repair, upgrade, and register skill workflows. Before a
|
|
223
|
+
mutation it shows the summary, relevant primitives, exact files, and exact
|
|
224
|
+
commands, then asks for approval. Restart your coding agent after installation.
|
|
225
|
+
|
|
226
|
+
`yskill bootstrap` and `npm create @operatorstack/yield@latest` remain
|
|
227
|
+
compatibility aliases for `yskill helper install`.
|
|
228
|
+
|
|
234
229
|
## How Yield runs and resumes
|
|
235
230
|
|
|
236
231
|
1. Your workflow emits one typed operation.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@operatorstack/yield",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.5.0",
|
|
4
4
|
"description": "Yield skill-program SDK for TypeScript: turn SKILL.md workflows into resumable programs.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -50,11 +50,11 @@
|
|
|
50
50
|
"registry": "https://registry.npmjs.org/"
|
|
51
51
|
},
|
|
52
52
|
"optionalDependencies": {
|
|
53
|
-
"@operatorstack/yield-darwin-amd64": "0.
|
|
54
|
-
"@operatorstack/yield-darwin-arm64": "0.
|
|
55
|
-
"@operatorstack/yield-linux-amd64": "0.
|
|
56
|
-
"@operatorstack/yield-linux-arm64": "0.
|
|
57
|
-
"@operatorstack/yield-windows-amd64": "0.
|
|
58
|
-
"@operatorstack/yield-windows-arm64": "0.
|
|
53
|
+
"@operatorstack/yield-darwin-amd64": "0.5.0",
|
|
54
|
+
"@operatorstack/yield-darwin-arm64": "0.5.0",
|
|
55
|
+
"@operatorstack/yield-linux-amd64": "0.5.0",
|
|
56
|
+
"@operatorstack/yield-linux-arm64": "0.5.0",
|
|
57
|
+
"@operatorstack/yield-windows-amd64": "0.5.0",
|
|
58
|
+
"@operatorstack/yield-windows-arm64": "0.5.0"
|
|
59
59
|
}
|
|
60
60
|
}
|