@harness-lab/cli 0.2.8 → 0.3.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 +34 -3
- package/assets/workshop-bundle/SKILL.md +28 -0
- package/assets/workshop-bundle/bundle-manifest.json +44 -52
- package/assets/workshop-bundle/content/challenge-cards/deck.md +19 -17
- package/assets/workshop-bundle/content/challenge-cards/locales/en/deck.md +7 -5
- package/assets/workshop-bundle/content/codex-craft.md +190 -0
- package/assets/workshop-bundle/content/facilitation/codex-setup-verification.md +5 -5
- package/assets/workshop-bundle/content/facilitation/master-guide.md +137 -67
- package/assets/workshop-bundle/content/project-briefs/code-review-helper.md +9 -9
- package/assets/workshop-bundle/content/project-briefs/devtoolbox-cli.md +11 -9
- package/assets/workshop-bundle/content/project-briefs/doc-generator.md +10 -8
- package/assets/workshop-bundle/content/project-briefs/locales/en/devtoolbox-cli.md +4 -2
- package/assets/workshop-bundle/content/project-briefs/locales/en/doc-generator.md +5 -3
- package/assets/workshop-bundle/content/project-briefs/locales/en/metrics-dashboard.md +4 -2
- package/assets/workshop-bundle/content/project-briefs/locales/en/standup-bot.md +4 -2
- package/assets/workshop-bundle/content/project-briefs/metrics-dashboard.md +14 -12
- package/assets/workshop-bundle/content/project-briefs/standup-bot.md +11 -9
- package/assets/workshop-bundle/content/talks/codex-demo-script.md +12 -10
- package/assets/workshop-bundle/content/talks/context-is-king.md +26 -23
- package/assets/workshop-bundle/docs/harness-cli-foundation.md +23 -11
- package/assets/workshop-bundle/docs/learner-resource-kit.md +37 -37
- package/assets/workshop-bundle/materials/coaching-codex.md +76 -0
- package/assets/workshop-bundle/materials/locales/en/participant-resource-kit.md +14 -2
- package/assets/workshop-bundle/materials/participant-resource-kit.md +23 -11
- package/assets/workshop-bundle/workshop-blueprint/README.md +2 -5
- package/assets/workshop-bundle/workshop-blueprint/day-structure.md +14 -0
- package/assets/workshop-bundle/workshop-skill/analyze-checklist.md +3 -3
- package/assets/workshop-bundle/workshop-skill/closing-skill.md +5 -5
- package/assets/workshop-bundle/workshop-skill/commands.md +13 -13
- package/assets/workshop-bundle/workshop-skill/facilitator.md +95 -0
- package/assets/workshop-bundle/workshop-skill/follow-up-package.md +13 -8
- package/assets/workshop-bundle/workshop-skill/install.md +8 -8
- package/assets/workshop-bundle/workshop-skill/locales/en/follow-up-package.md +8 -3
- package/assets/workshop-bundle/workshop-skill/locales/en/recap.md +8 -1
- package/assets/workshop-bundle/workshop-skill/locales/en/reference.md +19 -3
- package/assets/workshop-bundle/workshop-skill/locales/en/setup.md +1 -1
- package/assets/workshop-bundle/workshop-skill/recap.md +12 -5
- package/assets/workshop-bundle/workshop-skill/reference.md +45 -29
- package/assets/workshop-bundle/workshop-skill/setup.md +11 -11
- package/assets/workshop-bundle/workshop-skill/template-agents.md +4 -4
- package/package.json +1 -1
- package/src/client.js +18 -0
- package/src/io.js +11 -2
- package/src/run-cli.js +266 -8
- package/src/session-store.js +1 -0
- package/src/skill-install.js +108 -7
- package/src/workshop-bundle.js +48 -3
- package/assets/workshop-bundle/content/czech-editorial-review-checklist.md +0 -88
- package/assets/workshop-bundle/content/style-examples.md +0 -127
- package/assets/workshop-bundle/content/style-guide.md +0 -108
- package/assets/workshop-bundle/workshop-blueprint/edit-boundaries.md +0 -64
|
@@ -7,29 +7,34 @@ Pošli účastníkům:
|
|
|
7
7
|
1. Krátké připomenutí hlavních principů:
|
|
8
8
|
- Kontext je pracovní systém
|
|
9
9
|
- `AGENTS.md` je týmová infrastruktura
|
|
10
|
-
- `Done When` a
|
|
10
|
+
- `Done When` a build/test příkazy zvyšují šanci na dobrý handoff
|
|
11
11
|
2. Odkaz na `/workshop recap`
|
|
12
12
|
3. Odkaz nebo výřez z `workshop-skill/template-agents.md`
|
|
13
|
-
4.
|
|
13
|
+
4. Jednu větu, která vrátí room contract:
|
|
14
|
+
- „Nejde o chytřejší prompt. Jde o repo, ze kterého naváže další tým.“
|
|
15
|
+
5. Výzvu týdne:
|
|
14
16
|
- „Přidejte `AGENTS.md` do jednoho reálného projektu.“
|
|
15
|
-
- „Přesuňte jedno trvalé pravidlo z
|
|
16
|
-
|
|
17
|
+
- „Přesuňte jedno trvalé pravidlo z promptu do repa.“
|
|
18
|
+
6. Odkaz na learner kit:
|
|
17
19
|
- [`docs/learner-resource-kit.md`](../docs/learner-resource-kit.md)
|
|
18
20
|
- [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md)
|
|
19
21
|
- [`materials/participant-resource-kit.md`](../materials/participant-resource-kit.md)
|
|
20
|
-
|
|
22
|
+
7. Připomeňte, že stejné materiály lze vyžádat i přes skill:
|
|
21
23
|
- `workshop resources`
|
|
22
24
|
- `workshop gallery`
|
|
23
25
|
- `workshop follow-up`
|
|
26
|
+
8. Přidejte malý závazek:
|
|
27
|
+
- „Pošlete si sami sobě nebo týmu jeden commit, task nebo PR, který tenhle týden opravdu vznikne.“
|
|
24
28
|
|
|
25
29
|
## 1 týden po workshopu
|
|
26
30
|
|
|
27
31
|
Krátký navazující dotaz:
|
|
28
32
|
|
|
29
|
-
- Vytvořili jste `AGENTS.md` v
|
|
33
|
+
- Vytvořili jste `AGENTS.md` v reálném projektu?
|
|
30
34
|
- Přidali jste build/test příkazy nebo sekci `Done When`?
|
|
31
|
-
-
|
|
35
|
+
- Přidali jste další safe move nebo krátký handoff runbook?
|
|
36
|
+
- Co vám pomohlo a co vás zablokovalo?
|
|
32
37
|
|
|
33
38
|
## W³ připomínka
|
|
34
39
|
|
|
35
|
-
Pokud máš fotku sticky notes z
|
|
40
|
+
Pokud máš fotku sticky notes z části `A teď?`, pošli každému jeho vlastní závazek jako osobní připomínku.
|
|
@@ -5,9 +5,9 @@
|
|
|
5
5
|
Výchozí doporučení pro Harness Lab je instalace přes `@harness-lab/cli` do vašeho aktuálního pracovního repa.
|
|
6
6
|
|
|
7
7
|
Proč:
|
|
8
|
-
- skill je pořád obsah opřený o
|
|
9
|
-
- stejné soubory slouží jako fallback i
|
|
10
|
-
- účastník má mít funkční workshop companion přímo v
|
|
8
|
+
- skill je pořád obsah opřený o repo, ale nemá záviset na tom, že máte zrovna klon tohoto veřejného repa
|
|
9
|
+
- stejné soubory slouží jako fallback i jako dokumentace
|
|
10
|
+
- účastník má mít funkční workshop companion přímo v týmovém repu
|
|
11
11
|
|
|
12
12
|
## Doporučený postup pro účastníka
|
|
13
13
|
|
|
@@ -35,8 +35,8 @@ harness skill install --target /cesta/k/repu
|
|
|
35
35
|
- Codex: `$workshop commands`, `$workshop reference`, `$workshop brief`
|
|
36
36
|
- pi: `/skill:workshop`, potom si říct o `commands`, `reference` nebo `brief`
|
|
37
37
|
|
|
38
|
-
Po úspěšné instalaci `harness skill install` rovnou vypíše doporučené první kroky, aby účastník věděl, že může začít buď v
|
|
39
|
-
Když příkaz pustíte znovu později, CLI zkontroluje, jestli je bundle v
|
|
38
|
+
Po úspěšné instalaci `harness skill install` rovnou vypíše doporučené první kroky, aby účastník věděl, že může začít buď v Codexu přes `$workshop ...`, nebo v pi přes `/skill:workshop`.
|
|
39
|
+
Když příkaz pustíte znovu později, CLI zkontroluje, jestli je bundle v cílovém repu aktuální. Pokud je zastaralý, rovnou ho obnoví. `--force` používejte jen tehdy, když chcete vynutit plný reinstall.
|
|
40
40
|
|
|
41
41
|
## Co čekat dál
|
|
42
42
|
|
|
@@ -47,12 +47,12 @@ Doporučený další postup:
|
|
|
47
47
|
1. rozběhnout `workshop` skill
|
|
48
48
|
2. otevřít `commands`, `reference` a `brief`
|
|
49
49
|
3. doplnit `AGENTS.md`
|
|
50
|
-
4. podle potřeby použít `brainstorm`,
|
|
51
|
-
5. když chcete materiály pro účastníky bez hledání v
|
|
50
|
+
4. podle potřeby použít `brainstorm`, `$plan`, `$work`, `$review` nebo `$compound`, pokud je ve svém agent setupu máte k dispozici
|
|
51
|
+
5. když chcete materiály pro účastníky bez hledání v GitHubu, použijte `workshop resources`, `workshop gallery` a `workshop follow-up`
|
|
52
52
|
|
|
53
53
|
## Poznámka
|
|
54
54
|
|
|
55
|
-
`harness skill install` vytvoří projektový bundle v `.agents/skills/harness-lab-workshop`, aby skill šel objevit v
|
|
55
|
+
`harness skill install` vytvoří projektový bundle v `.agents/skills/harness-lab-workshop`, aby skill šel objevit v repu bez další distribuční vrstvy.
|
|
56
56
|
Tuto složku berte jako generovaný workshop bundle, ne jako hlavní autorský zdroj.
|
|
57
57
|
|
|
58
58
|
Přihlášení účastníka není potřeba pro samotnou existenci skillu. `workshop login` je až krok pro odemčení live event contextu.
|
|
@@ -10,17 +10,21 @@ Send participants:
|
|
|
10
10
|
- `Done When` and build/test commands improve the chances of a good handoff
|
|
11
11
|
2. A pointer to `/workshop recap`
|
|
12
12
|
3. A link to or excerpt from `workshop-skill/template-agents.md`
|
|
13
|
-
4.
|
|
13
|
+
4. One sentence that brings the room contract back:
|
|
14
|
+
- "This is not about a smarter prompt. It is about a repo another team can continue from."
|
|
15
|
+
5. A challenge for the week:
|
|
14
16
|
- "Add `AGENTS.md` to one real project."
|
|
15
17
|
- "Move one durable rule from a prompt into the repo."
|
|
16
|
-
|
|
18
|
+
6. Links to the learner kit:
|
|
17
19
|
- [`docs/locales/en/learner-resource-kit.md`](../../../docs/locales/en/learner-resource-kit.md)
|
|
18
20
|
- [`docs/locales/en/learner-reference-gallery.md`](../../../docs/locales/en/learner-reference-gallery.md)
|
|
19
21
|
- [`materials/locales/en/participant-resource-kit.md`](../../../materials/locales/en/participant-resource-kit.md)
|
|
20
|
-
|
|
22
|
+
7. A reminder that the same materials are available through the skill too:
|
|
21
23
|
- `workshop resources`
|
|
22
24
|
- `workshop gallery`
|
|
23
25
|
- `workshop follow-up`
|
|
26
|
+
8. Add one small commitment:
|
|
27
|
+
- "Send yourself or your team one commit, task, or PR that will actually happen this week."
|
|
24
28
|
|
|
25
29
|
## 1 week after the workshop
|
|
26
30
|
|
|
@@ -28,6 +32,7 @@ Short follow-up questions:
|
|
|
28
32
|
|
|
29
33
|
- Did you create `AGENTS.md` in a real project?
|
|
30
34
|
- Did you add build/test commands or a `Done When` section?
|
|
35
|
+
- Did you add the next safe move or a short handoff runbook?
|
|
31
36
|
- What helped you and what blocked you?
|
|
32
37
|
|
|
33
38
|
## W³ reminder
|
|
@@ -6,12 +6,19 @@
|
|
|
6
6
|
- `AGENTS.md`, skills, and runbooks are not extra garnish. They are tools that help a team keep direction.
|
|
7
7
|
- A good handoff is visible when the next team can start work without verbal backfilling.
|
|
8
8
|
|
|
9
|
+
## 3 things to take out of the room
|
|
10
|
+
|
|
11
|
+
- One signal you want to install permanently in your own repo.
|
|
12
|
+
- One weakness you do not want to leave in conversation next time.
|
|
13
|
+
- One concrete move for next week.
|
|
14
|
+
|
|
9
15
|
## Try this this week
|
|
10
16
|
|
|
11
17
|
- Add `AGENTS.md` to one real project.
|
|
12
18
|
- Add build and test commands plus a `Done When` section.
|
|
13
19
|
- Move one durable rule from a prompt into the repo.
|
|
14
20
|
- After a larger change, try writing a short runbook for the next person.
|
|
21
|
+
- After one handoff or review, write down what the next team actually needed and what was missing.
|
|
15
22
|
|
|
16
23
|
## Your commitment
|
|
17
24
|
|
|
@@ -19,4 +26,4 @@ Return to the sticky note from the `And now?` segment and turn it into the first
|
|
|
19
26
|
|
|
20
27
|
## When you are not sure
|
|
21
28
|
|
|
22
|
-
Start simply: write down what you want to do, where the context is, what the constraints are,
|
|
29
|
+
Start simply: write down what you want to do, where the context is, what the constraints are, how you will know it is done, and what the next safe move is if the work stays unfinished.
|
|
@@ -24,6 +24,20 @@
|
|
|
24
24
|
- Can you find what was actually verified?
|
|
25
25
|
- Can a new team find the first safe move within a few minutes?
|
|
26
26
|
|
|
27
|
+
## 3 questions to return to when you get stuck
|
|
28
|
+
|
|
29
|
+
- What are we trying to prove right now?
|
|
30
|
+
- Which artifact or repo signal is missing?
|
|
31
|
+
- What is the smallest check that moves the work from confidence back to reality?
|
|
32
|
+
|
|
33
|
+
## What to reach for during the day
|
|
34
|
+
|
|
35
|
+
- After the opening and talk: `workshop setup` or `workshop reference`
|
|
36
|
+
- In Build 1: `template-agents`, the brief, the plan, and the first check
|
|
37
|
+
- Before lunch: write the next safe move and use `workshop analyze` if the handoff still feels vague
|
|
38
|
+
- After rotation: `workshop analyze`, the learner kit, and challenge cards instead of verbal rescue
|
|
39
|
+
- At the end of the day: `workshop recap` and `workshop follow-up`
|
|
40
|
+
|
|
27
41
|
## Recommended commands
|
|
28
42
|
|
|
29
43
|
- Workshop skill in Codex: `$workshop ...`
|
|
@@ -39,7 +53,7 @@
|
|
|
39
53
|
- `Codex: $brainstorm` when the scope is still unclear
|
|
40
54
|
- `Codex: $plan` before larger implementation
|
|
41
55
|
- `Codex: $work` once you have a plan and want to keep implementation in one line
|
|
42
|
-
- `Codex: $test-writer` or your own
|
|
56
|
+
- `Codex: $test-writer` or your own executable check before implementation when you need to keep the agent inside real boundaries
|
|
43
57
|
- `Codex: $review` after a larger slice of work
|
|
44
58
|
- `Codex: $compound` when a learning, fix, or workflow rule is worth preserving as a durable repo-native artifact
|
|
45
59
|
- `Codex: $workshop` for orientation during the day
|
|
@@ -59,7 +73,7 @@
|
|
|
59
73
|
|
|
60
74
|
- The more work the agent does independently, the less “I skimmed it quickly” is enough.
|
|
61
75
|
- If you let the agent write without tests, you often just accelerate unverified complexity.
|
|
62
|
-
-
|
|
76
|
+
- An executable check (unit test, tracer bullet, or simple end-to-end probe) is often the fastest way to tell the agent what must actually be true.
|
|
63
77
|
|
|
64
78
|
## Safe UI workflow
|
|
65
79
|
|
|
@@ -71,10 +85,12 @@
|
|
|
71
85
|
|
|
72
86
|
## Quick reminder
|
|
73
87
|
|
|
74
|
-
A good prompt is not enough. If the work should survive handoff, the context must live in the repo and verification must
|
|
88
|
+
A good prompt is not enough. If the work should survive handoff, the context must live in the repo, the next safe move must stay traceable, and verification must remain legible to a different team.
|
|
75
89
|
|
|
76
90
|
## Where to go after the workshop
|
|
77
91
|
|
|
78
92
|
- Official docs, the OpenAI Harness Engineering article, and verified public skill repos are collected in [`docs/learner-reference-gallery.md`](../../../docs/learner-reference-gallery.md).
|
|
93
|
+
- Codex-specific craft (approval modes, sandboxing, long-horizon drift, a representative before/after prompt pair, and a failure-recovery walkthrough) lives in [`content/codex-craft.md`](../../../content/codex-craft.md).
|
|
94
|
+
- The one-page pocket card of conversational moves for coaching an agent is [`materials/coaching-codex.md`](../../../materials/coaching-codex.md).
|
|
79
95
|
- If you already use another workflow pack or toolkit, treat it as an extension on top of this foundation, not as a replacement for `AGENTS.md`, verification, and repo-native handoff.
|
|
80
96
|
- If you do not want to search the repo, use `workshop resources`, `workshop gallery`, or `workshop follow-up` directly.
|
|
@@ -70,7 +70,7 @@ npm install -g @mariozechner/pi-coding-agent
|
|
|
70
70
|
4. Name the first safe move:
|
|
71
71
|
- ideally through `plan`, or `brainstorm` if the scope is still unclear
|
|
72
72
|
5. Add one executable check:
|
|
73
|
-
-
|
|
73
|
+
- an executable check (unit test, tracer bullet), or at least a clear review or checklist step
|
|
74
74
|
6. If you want materials for later too:
|
|
75
75
|
- `Codex: $workshop resources`
|
|
76
76
|
- `Codex: $workshop gallery`
|
|
@@ -3,20 +3,27 @@
|
|
|
3
3
|
## Co si odnést
|
|
4
4
|
|
|
5
5
|
- Kontext není kosmetika. Je to pracovní systém.
|
|
6
|
-
- `AGENTS.md`, skills a
|
|
6
|
+
- `AGENTS.md`, skills a runbooky nejsou doplněk navíc. Jsou to nástroje, díky kterým tým drží směr.
|
|
7
7
|
- Dobrý handoff poznáte podle toho, že nový tým začne pracovat bez ústního dovysvětlování.
|
|
8
8
|
|
|
9
|
+
## 3 věci, které si máte odnést z místnosti
|
|
10
|
+
|
|
11
|
+
- Jeden signál, který chcete zavést natrvalo ve vlastním repu.
|
|
12
|
+
- Jednu slabinu, kterou už příště nenecháte žít jen v hovoru.
|
|
13
|
+
- Jeden konkrétní tah pro příští týden.
|
|
14
|
+
|
|
9
15
|
## Zkuste tento týden
|
|
10
16
|
|
|
11
17
|
- Přidejte `AGENTS.md` do jednoho reálného projektu.
|
|
12
|
-
- Doplňte build/test příkazy a
|
|
13
|
-
- Jedno trvalé pravidlo přesuňte z
|
|
18
|
+
- Doplňte build/test příkazy a sekci `Done When`.
|
|
19
|
+
- Jedno trvalé pravidlo přesuňte z promptu do repa.
|
|
14
20
|
- Po větší změně zkuste udělat krátký runbook pro dalšího člověka.
|
|
21
|
+
- Po jednom handoffu nebo review si napište, co další tým skutečně potřeboval a co mu chybělo.
|
|
15
22
|
|
|
16
23
|
## Váš závazek
|
|
17
24
|
|
|
18
|
-
Vraťte se ke sticky note z
|
|
25
|
+
Vraťte se ke sticky note z části `A teď?` a převeďte ji na první konkrétní commit, pull request nebo task v repu.
|
|
19
26
|
|
|
20
27
|
## Až si nebudete jistí
|
|
21
28
|
|
|
22
|
-
Začněte jednoduše: napište, co chcete udělat, kde je kontext, jaká jsou
|
|
29
|
+
Začněte jednoduše: napište, co chcete udělat, kde je kontext, jaká jsou omezení, podle čeho poznáte hotovo a jaký je další safe move, když práce zůstane rozdělaná.
|
|
@@ -2,79 +2,95 @@
|
|
|
2
2
|
|
|
3
3
|
## 4 pracovní výchozí body pro dnešek
|
|
4
4
|
|
|
5
|
-
- `Mapa před pohybem` — nejdřív udělejte z
|
|
6
|
-
- `Co není v repu, neexistuje` — důležité dohody, pravidla a
|
|
7
|
-
- `Ověření je hranice důvěry` — s
|
|
5
|
+
- `Mapa před pohybem` — nejdřív udělejte z repa místo, kde se dá orientovat
|
|
6
|
+
- `Co není v repu, neexistuje` — důležité dohody, pravidla a další kroky patří do souborů
|
|
7
|
+
- `Ověření je hranice důvěry` — s větší autonomií musí růst i kvalita evidence
|
|
8
8
|
- `Handoff je průběžná podmínka práce` — další tým má najít první bezpečný krok bez vašeho výkladu
|
|
9
9
|
|
|
10
10
|
## 4 prvky dobrého zadání
|
|
11
11
|
|
|
12
12
|
- `Cíl` — co má agent konkrétně vytvořit nebo změnit
|
|
13
|
-
- `Kontext` — které soubory, rozhodnutí a
|
|
14
|
-
- `Omezení` — pravidla, standardy a
|
|
13
|
+
- `Kontext` — které soubory, rozhodnutí a souvislosti jsou pro úkol důležité
|
|
14
|
+
- `Omezení` — pravidla, standardy a hranice řešení
|
|
15
15
|
- `Hotovo když` — podle čeho poznáte, že je práce opravdu dokončená
|
|
16
16
|
|
|
17
17
|
## Rychlý checklist pro handoff
|
|
18
18
|
|
|
19
19
|
- Existuje `AGENTS.md`?
|
|
20
20
|
- Je `AGENTS.md` krátká mapa, ne přerostlý dump?
|
|
21
|
-
- Jsou v
|
|
22
|
-
- Je jasné, co už funguje, co je rozpracované a
|
|
23
|
-
- Je v
|
|
21
|
+
- Jsou v repu build/test příkazy, které umí spustit i další tým?
|
|
22
|
+
- Je jasné, co už funguje, co je rozpracované a co je jen nápad?
|
|
23
|
+
- Je v repu plán, runbook nebo jiný dokument, ze kterého další tým pochopí záměr?
|
|
24
24
|
- Je dohledatelné, co bylo skutečně ověřeno?
|
|
25
25
|
- Najde nový tým během pár minut první bezpečný krok?
|
|
26
26
|
|
|
27
|
+
## 3 otázky, ke kterým se vraťte, když se zaseknete
|
|
28
|
+
|
|
29
|
+
- Čeho se právě snažíme dosáhnout?
|
|
30
|
+
- Který artefakt nebo signál v repu nám chybí?
|
|
31
|
+
- Jaké je nejmenší ověření, které vrátí práci z dojmu do reality?
|
|
32
|
+
|
|
33
|
+
## Kdy po čem sáhnout během dne
|
|
34
|
+
|
|
35
|
+
- Po openingu a talku: `workshop setup` nebo `workshop reference`
|
|
36
|
+
- V prvním buildu: `template-agents`, brief, plán a první ověření
|
|
37
|
+
- Před obědem: dopsat další bezpečný krok a použít `workshop analyze`, když si nejste jistí handoffem
|
|
38
|
+
- Po rotaci: `workshop analyze`, learner kit a challenge cards místo ústního rescue
|
|
39
|
+
- Na konci dne: `workshop recap` a `workshop follow-up`
|
|
40
|
+
|
|
27
41
|
## Doporučené příkazy
|
|
28
42
|
|
|
29
|
-
- Workshop skill v
|
|
30
|
-
- Workshop skill v
|
|
43
|
+
- Workshop skill v Codexu: `$workshop ...`
|
|
44
|
+
- Workshop skill v pi: `/skill:workshop`, potom si řekněte o `reference`, `setup`, `brief` nebo jinou workshop akci
|
|
31
45
|
- Když nevíte, co skill umí: `Codex: $workshop commands`
|
|
32
|
-
- Workshop skill je garantovaný výchozí nástroj. Workflow skills a
|
|
33
|
-
- Workflow skills jako `$brainstorm`, `$plan`, `$work`, `$test-writer`, `$review` a `$compound` jsou v
|
|
46
|
+
- Workshop skill je garantovaný výchozí nástroj. Workflow skills a externí toolkity jsou doporučené akcelerátory, ne povinný bootstrap.
|
|
47
|
+
- Workflow skills jako `$brainstorm`, `$plan`, `$work`, `$test-writer`, `$review` a `$compound` jsou v tomto workshopu popsané hlavně pro Codex. V pi je berte jako volitelnou součást vlastního setupu, ne jako garantovaný výchozí stav.
|
|
34
48
|
- `Codex: $workshop reference` na začátku dne nebo po ztrátě orientace
|
|
35
49
|
- `Codex: $workshop brief` když potřebujete znovu ukotvit zadání
|
|
36
|
-
- `Codex: $workshop resources` když chcete účastnický kit a
|
|
37
|
-
- `Codex: $workshop gallery` když chcete další veřejné docs, repozitáře a
|
|
50
|
+
- `Codex: $workshop resources` když chcete účastnický kit a learner kit bez hledání v repu
|
|
51
|
+
- `Codex: $workshop gallery` když chcete další veřejné docs, repozitáře a volitelné toolkity
|
|
38
52
|
- `Codex: $workshop follow-up` když řešíte, co si odnést po workshopu
|
|
39
53
|
- `Codex: $brainstorm` když ještě není jasné, co je nejrozumnější scope nebo slice
|
|
40
54
|
- `Codex: $plan` před větší implementací
|
|
41
|
-
- `Codex: $work` když už máte
|
|
42
|
-
- `Codex: $test-writer` nebo vlastní
|
|
55
|
+
- `Codex: $work` když už máte plán a chcete držet implementaci v jedné linii
|
|
56
|
+
- `Codex: $test-writer` nebo vlastní spustitelné ověření před implementací, když potřebujete držet agenta v mezích
|
|
43
57
|
- `Codex: $review` po větším kusu práce
|
|
44
|
-
- `Codex: $compound` když chcete převést nové zjištění, fix nebo workflow pravidlo do trvalého artefaktu v
|
|
58
|
+
- `Codex: $compound` když chcete převést nové zjištění, fix nebo workflow pravidlo do trvalého artefaktu v repu
|
|
45
59
|
- `Codex: $workshop` pro orientaci během dne
|
|
46
60
|
- `Codex: $workshop template` když repu chybí základní kontext
|
|
47
|
-
- `Codex: $workshop analyze` před handoffem nebo po rotaci, když chcete rychle odhalit slepá místa v
|
|
61
|
+
- `Codex: $workshop analyze` před handoffem nebo po rotaci, když chcete rychle odhalit slepá místa v repu
|
|
48
62
|
|
|
49
63
|
## Doporučený pracovní rytmus
|
|
50
64
|
|
|
51
|
-
- `workshop` pro orientaci a
|
|
52
|
-
- `brainstorm` nebo rovnou
|
|
65
|
+
- `workshop` pro orientaci a další bezpečný krok
|
|
66
|
+
- `brainstorm` nebo rovnou `$plan`, když už je scope zřejmý
|
|
53
67
|
- `work` proti jednomu ověřitelnému cíli
|
|
54
68
|
- `review` před tím, než změně uvěříte
|
|
55
69
|
- `compound` nebo krátký runbook, když něco stojí za zachování
|
|
56
|
-
- průběžný úklid: build/test příkazy, omezení a
|
|
70
|
+
- průběžný úklid: build/test příkazy, omezení a handoff poznámky přesouvejte z chatu do repa
|
|
57
71
|
|
|
58
72
|
## Testy jako hranice důvěry
|
|
59
73
|
|
|
60
74
|
- Čím víc práce dělá agent samostatně, tím méně stačí „já jsem to rychle projel očima“.
|
|
61
75
|
- Když necháte agenta psát bez testů, často jen urychlíte vznik neověřené složitosti.
|
|
62
|
-
-
|
|
76
|
+
- Spustitelné ověření (unit test, tracer bullet nebo jednoduché e2e ověření) je často nejrychlejší způsob, jak agentovi říct, co přesně má být pravda.
|
|
63
77
|
|
|
64
78
|
## Bezpečný UI workflow
|
|
65
79
|
|
|
66
80
|
- Výchozí pattern je: `agent exploration -> Playwright regression -> human review`.
|
|
67
|
-
- Nechte agenta rychle projít UI, screenshoty a
|
|
81
|
+
- Nechte agenta rychle projít UI, screenshoty a konzoli v izolovaném lokálním prostředí.
|
|
68
82
|
- Jakmile najdete důležitý flow, převeďte ho do opakovatelného browser testu.
|
|
69
|
-
- Nakonec změnu projděte člověkem. Testy chrání proti regresi, ale neřeší automaticky smysl a
|
|
70
|
-
- „Nech model řídit můj běžný přihlášený browser“ není výchozí doporučení. To patří jen do sandboxovaného a
|
|
83
|
+
- Nakonec změnu projděte člověkem. Testy chrání proti regresi, ale neřeší automaticky smysl a trade-offy.
|
|
84
|
+
- „Nech model řídit můj běžný přihlášený browser“ není výchozí doporučení. To patří jen do sandboxovaného a záměrně omezeného prostředí.
|
|
71
85
|
|
|
72
86
|
## Rychlá připomínka
|
|
73
87
|
|
|
74
|
-
Dobrý prompt nestačí. Když má práce přežít handoff, musí být kontext uložený v
|
|
88
|
+
Dobrý prompt nestačí. Když má práce přežít handoff, musí být kontext uložený v repu, další bezpečný krok musí být dohledatelný a ověření musí zůstat čitelné i pro cizí tým.
|
|
75
89
|
|
|
76
90
|
## Kam dál po workshopu
|
|
77
91
|
|
|
78
|
-
- Oficiální docs, OpenAI článek o
|
|
79
|
-
-
|
|
80
|
-
-
|
|
92
|
+
- Oficiální docs, OpenAI článek o Harness Engineering a ověřené veřejné skill repozitáře najdete v [`docs/learner-reference-gallery.md`](../docs/learner-reference-gallery.md).
|
|
93
|
+
- Codex-specific craft (approval módy, sandboxing, long-horizon drift, před/po příklad) je v [`content/codex-craft.md`](../content/codex-craft.md).
|
|
94
|
+
- Conversational moves pro coaching agenta sežene v jedné straně v [`materials/coaching-codex.md`](../materials/coaching-codex.md).
|
|
95
|
+
- Když už používáte další workflow pack nebo toolkit, berte ho jako rozšíření nad tímto základem, ne jako náhradu za `AGENTS.md`, ověřování a handoff opřený o repo.
|
|
96
|
+
- Když nechcete hledat v repu, použijte přímo `workshop resources`, `workshop gallery` nebo `workshop follow-up`.
|
|
@@ -18,7 +18,7 @@ Garantovaný výchozí nástroj pro dnešek je `workshop` skill. Další workflo
|
|
|
18
18
|
- terminálový, hackovatelný multi-model setup: `pi`
|
|
19
19
|
- macOS / Linux: `Codex CLI`
|
|
20
20
|
- Windows nebo macOS: `Codex App`
|
|
21
|
-
- Když se zaseknete: web fallback nebo pairing s
|
|
21
|
+
- Když se zaseknete: web fallback nebo pairing s někým, komu už setup běží
|
|
22
22
|
|
|
23
23
|
## pi
|
|
24
24
|
|
|
@@ -31,7 +31,7 @@ npm install -g @mariozechner/pi-coding-agent
|
|
|
31
31
|
2. Přihlaste provider nebo účet, který chcete používat.
|
|
32
32
|
3. Otevřete repozitář.
|
|
33
33
|
4. Spusťte `pi`.
|
|
34
|
-
5. Načtěte workshop skill přes `/skill:workshop` a
|
|
34
|
+
5. Načtěte workshop skill přes `/skill:workshop` a řekněte si o `setup`, `reference` nebo `brief`.
|
|
35
35
|
|
|
36
36
|
## Codex CLI
|
|
37
37
|
|
|
@@ -39,7 +39,7 @@ npm install -g @mariozechner/pi-coding-agent
|
|
|
39
39
|
2. Nainstalujte CLI podle interního setup flow vaší organizace.
|
|
40
40
|
3. Přihlaste se.
|
|
41
41
|
4. Otevřete repozitář.
|
|
42
|
-
5. Pošlete první smysluplný prompt a
|
|
42
|
+
5. Pošlete první smysluplný prompt a ověřte, že dostáváte odpověď.
|
|
43
43
|
|
|
44
44
|
## Codex App
|
|
45
45
|
|
|
@@ -53,8 +53,8 @@ npm install -g @mariozechner/pi-coding-agent
|
|
|
53
53
|
|
|
54
54
|
- Neztrácejte 20 minut sólo debugováním setupu.
|
|
55
55
|
- Po 7 minutách blokace přepněte na App, web fallback nebo pairing.
|
|
56
|
-
- Když nefunguje autentizace, pokračujte s
|
|
57
|
-
- Když si nejste jistí dalším krokem, použijte v
|
|
56
|
+
- Když nefunguje autentizace, pokračujte s někým od stolu a vraťte se k vlastnímu setupu později.
|
|
57
|
+
- Když si nejste jistí dalším krokem, použijte v Codexu `$workshop setup`. V pi načtěte `/skill:workshop` a řekněte si o setup pomoc. Nebo si zavolejte facilitátora.
|
|
58
58
|
|
|
59
59
|
## Prvních 15 minut po setupu
|
|
60
60
|
|
|
@@ -68,10 +68,10 @@ npm install -g @mariozechner/pi-coding-agent
|
|
|
68
68
|
3. Doplňte krátké `AGENTS.md`:
|
|
69
69
|
- Codex: `$workshop template`
|
|
70
70
|
4. Pojmenujte první bezpečný krok:
|
|
71
|
-
- ideálně přes
|
|
72
|
-
5. Přidejte
|
|
73
|
-
-
|
|
74
|
-
6. Když chcete materiály i
|
|
71
|
+
- ideálně přes `$plan`, případně `brainstorm`, když scope ještě není jasný
|
|
72
|
+
5. Přidejte jedno spustitelné ověření:
|
|
73
|
+
- unit test, tracer bullet nebo aspoň jasný review/checklist krok
|
|
74
|
+
6. Když chcete materiály i po workshopu:
|
|
75
75
|
- `Codex: $workshop resources`
|
|
76
76
|
- `Codex: $workshop gallery`
|
|
77
77
|
- `Codex: $workshop follow-up`
|
|
@@ -80,5 +80,5 @@ npm install -g @mariozechner/pi-coding-agent
|
|
|
80
80
|
|
|
81
81
|
- Umíte otevřít repo.
|
|
82
82
|
- Umíte poslat prompt.
|
|
83
|
-
- Máte jednu funkční cestu, jak během workshopu pracovat s
|
|
84
|
-
- Víte, jaký je první bezpečný krok v
|
|
83
|
+
- Máte jednu funkční cestu, jak během workshopu pracovat s agentem.
|
|
84
|
+
- Víte, jaký je první bezpečný krok v repu po setupu.
|
|
@@ -6,15 +6,15 @@ Nejdůležitější pravidlo:
|
|
|
6
6
|
- napište, kam má agent sáhnout jako první
|
|
7
7
|
- napište, co je zdroj pravdy
|
|
8
8
|
- napište, jak se práce ověří
|
|
9
|
-
- když se text nafukuje, přidejte navazující dokument a
|
|
9
|
+
- když se text nafukuje, přidejte navazující dokument a odkažte na něj
|
|
10
10
|
|
|
11
11
|
## Goal
|
|
12
12
|
|
|
13
|
-
Popiš, co má agent v
|
|
13
|
+
Popiš, co má agent v tomto repozitáři vytvořit nebo udržovat.
|
|
14
14
|
|
|
15
15
|
## Context
|
|
16
16
|
|
|
17
|
-
- Klíčové soubory a
|
|
17
|
+
- Klíčové soubory a složky
|
|
18
18
|
- Rozhodnutí, která už padla
|
|
19
19
|
- Systémy nebo integrace, na které se navazuje
|
|
20
20
|
- Kam má agent sáhnout jako první
|
|
@@ -23,7 +23,7 @@ Popiš, co má agent v tomto repozitáři vytvořit nebo udržovat.
|
|
|
23
23
|
## Constraints
|
|
24
24
|
|
|
25
25
|
- Build/test/lint příkazy
|
|
26
|
-
- Jazykové, architektonické a
|
|
26
|
+
- Jazykové, architektonické a bezpečnostní standardy
|
|
27
27
|
- Co agent nesmí dělat bez explicitního souhlasu
|
|
28
28
|
- Public/private nebo auth boundary, pokud existuje
|
|
29
29
|
|
package/package.json
CHANGED
package/src/client.js
CHANGED
|
@@ -96,12 +96,30 @@ export function createHarnessClient({ fetchFn, session }) {
|
|
|
96
96
|
getWorkshopInstance(instanceId) {
|
|
97
97
|
return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}`);
|
|
98
98
|
},
|
|
99
|
+
getWorkshopParticipantAccess(instanceId) {
|
|
100
|
+
return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}/participant-access`);
|
|
101
|
+
},
|
|
102
|
+
issueWorkshopParticipantAccess(instanceId, input = {}) {
|
|
103
|
+
return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}/participant-access`, {
|
|
104
|
+
method: "POST",
|
|
105
|
+
body: { action: "rotate", ...input },
|
|
106
|
+
});
|
|
107
|
+
},
|
|
99
108
|
getAgenda() {
|
|
100
109
|
return request("/api/agenda");
|
|
101
110
|
},
|
|
111
|
+
getWorkshopAgenda(instanceId) {
|
|
112
|
+
return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}/agenda`);
|
|
113
|
+
},
|
|
102
114
|
setCurrentPhase(currentId) {
|
|
103
115
|
return request("/api/agenda", { method: "PATCH", body: { currentId } });
|
|
104
116
|
},
|
|
117
|
+
setCurrentPhaseForInstance(instanceId, currentId) {
|
|
118
|
+
return request(`/api/workshop/instances/${encodeURIComponent(instanceId)}/agenda`, {
|
|
119
|
+
method: "PATCH",
|
|
120
|
+
body: { itemId: currentId },
|
|
121
|
+
});
|
|
122
|
+
},
|
|
105
123
|
archiveWorkshop(notes) {
|
|
106
124
|
return request("/api/workshop/archive", { method: "POST", body: notes ? { notes } : {} });
|
|
107
125
|
},
|
package/src/io.js
CHANGED
|
@@ -84,7 +84,9 @@ function writeWrapped(stream, text, options = {}) {
|
|
|
84
84
|
}
|
|
85
85
|
}
|
|
86
86
|
|
|
87
|
-
export function createCliUi(io) {
|
|
87
|
+
export function createCliUi(io, options = {}) {
|
|
88
|
+
const jsonMode = options.jsonMode === true;
|
|
89
|
+
|
|
88
90
|
function streamFor(target) {
|
|
89
91
|
return target === "stderr" ? io.stderr : io.stdout;
|
|
90
92
|
}
|
|
@@ -115,6 +117,10 @@ export function createCliUi(io) {
|
|
|
115
117
|
function status(kind, text, options = {}) {
|
|
116
118
|
const target = options.stream ?? (kind === "error" ? "stderr" : "stdout");
|
|
117
119
|
const stream = streamFor(target);
|
|
120
|
+
if (jsonMode) {
|
|
121
|
+
writeLine(stream, JSON.stringify({ ok: kind !== "error", level: kind, message: text }));
|
|
122
|
+
return;
|
|
123
|
+
}
|
|
118
124
|
const chalk = createStyler(stream, io.env);
|
|
119
125
|
const prefixMap = {
|
|
120
126
|
ok: chalk.green.bold("[ok]"),
|
|
@@ -178,7 +184,9 @@ export function createCliUi(io) {
|
|
|
178
184
|
|
|
179
185
|
function json(title, value, options = {}) {
|
|
180
186
|
const target = options.stream ?? "stdout";
|
|
181
|
-
|
|
187
|
+
if (!jsonMode) {
|
|
188
|
+
heading(title, { stream: target });
|
|
189
|
+
}
|
|
182
190
|
writeLine(streamFor(target), JSON.stringify(value, null, 2));
|
|
183
191
|
}
|
|
184
192
|
|
|
@@ -192,5 +200,6 @@ export function createCliUi(io) {
|
|
|
192
200
|
numberedList,
|
|
193
201
|
commandList,
|
|
194
202
|
json,
|
|
203
|
+
jsonMode,
|
|
195
204
|
};
|
|
196
205
|
}
|