project-tiny-context-harness 0.2.67 → 0.2.68
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 +95 -95
- package/assets/README.md +106 -106
- package/assets/skills/normal-long-task/SKILL.md +486 -473
- package/assets/skills/superpowers-long-task/SKILL.md +256 -241
- package/package.json +1 -1
|
@@ -1,241 +1,256 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: superpowers-long-task
|
|
3
|
-
description: Use when directly invoked for Superpowers long-running task target prompt preparation.
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Superpowers Long Task Skill
|
|
7
|
-
|
|
8
|
-
## Package-Managed Boundary
|
|
9
|
-
|
|
10
|
-
This Skill is generated by `ty-context sync` and owned by the Harness package. Do not edit the generated `superpowers-long-task` Skill directly in a consumer project.
|
|
11
|
-
|
|
12
|
-
This is Tiny Context's adapter for feeding a complete acceptance packet into the external Superpowers workflow. It is not a Superpowers official schema and 不是 Superpowers 官方 schema. It only makes the target-mode prompt explicit enough that the official Superpowers skills can do their intended work without losing Tiny Context acceptance authority.
|
|
13
|
-
|
|
14
|
-
## Purpose
|
|
15
|
-
|
|
16
|
-
Consumes a complete acceptance packet and emits a paste-ready Superpowers target-mode prompt. The input packet normally comes from `/normal-long-task`.
|
|
17
|
-
|
|
18
|
-
Use this Skill only after the implementation/source plan and full acceptance checklist already exist or are pasted in full. Do not generate, derive, rewrite, strengthen, or repair the full checklist in this Skill. If the checklist is incomplete, stop and send the user back to `/normal-long-task` or ask for the missing fields.
|
|
19
|
-
|
|
20
|
-
## Direct Invocation
|
|
21
|
-
|
|
22
|
-
Use this Skill through explicit invocation:
|
|
23
|
-
|
|
24
|
-
```text
|
|
25
|
-
/superpowers-long-task
|
|
26
|
-
```
|
|
27
|
-
|
|
28
|
-
Do not rely on broad automatic keyword routing. Use `/normal-long-task` first when the implementation/source plan and full acceptance checklist do not already exist.
|
|
29
|
-
|
|
30
|
-
## Use Cases
|
|
31
|
-
|
|
32
|
-
Use this Skill when a complete plan/checklist packet needs:
|
|
33
|
-
|
|
34
|
-
- Superpowers target-mode prompt.
|
|
35
|
-
- Superpowers goal-mode prompt.
|
|
36
|
-
- Superpowers 目标模式文本.
|
|
37
|
-
- Superpowers-compatible Codex target prompt.
|
|
38
|
-
- Maximum official Superpowers workflow value from an existing acceptance checklist.
|
|
39
|
-
|
|
40
|
-
Do not trigger merely because a plan mentions TDD or subagents. The user must ask for a Superpowers target/goal prompt or equivalent execution adapter.
|
|
41
|
-
|
|
42
|
-
## Required Input Packet
|
|
43
|
-
|
|
44
|
-
The input must fully expose these fields:
|
|
45
|
-
|
|
46
|
-
- Original requirement source or original plan summary.
|
|
47
|
-
- implementation/source plan path or pasted text.
|
|
48
|
-
- full acceptance checklist path or pasted text.
|
|
49
|
-
- local audit path, normally `tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md`.
|
|
50
|
-
- relevant Context that must be read before execution.
|
|
51
|
-
- required tests / core paths.
|
|
52
|
-
- Evidence Layer Separation rules.
|
|
53
|
-
- Invalid Evidence Rules.
|
|
54
|
-
- Completion State Machine rules.
|
|
55
|
-
- UI-Facing Gate rules when any AC touches UI.
|
|
56
|
-
- hard blockers or an explicit no-blocker statement.
|
|
57
|
-
|
|
58
|
-
If any of these are missing required fields, stop. Do not generate the Superpowers target-mode prompt. Report the missing fields and say whether they belong in the development plan, full checklist, local audit rule, blocker section or Context reference.
|
|
59
|
-
|
|
60
|
-
## Source Roles
|
|
61
|
-
|
|
62
|
-
- Original requirement source prevents implementation/source plan or checklist shrinkage.
|
|
63
|
-
- implementation/source plan is execution direction, not proof.
|
|
64
|
-
- full acceptance checklist is the highest-priority completion standard.
|
|
65
|
-
- local audit records progress, evidence, blockers and invalidating evidence only; it is not proof.
|
|
66
|
-
- relevant Context remains the durable repo intent and boundary source.
|
|
67
|
-
- required tests / core paths bind AC gaps to executable verification.
|
|
68
|
-
|
|
69
|
-
Do not let a compact target prompt override the full checklist. The compact prompt is direction, priority and recovery navigation only. The full checklist wins conflicts.
|
|
70
|
-
|
|
71
|
-
## Evidence Layer Separation
|
|
72
|
-
|
|
73
|
-
Keep these layers separate in the prompt when relevant:
|
|
74
|
-
|
|
75
|
-
- code implemented.
|
|
76
|
-
- runtime configured.
|
|
77
|
-
- runtime exercised.
|
|
78
|
-
- artifact generated.
|
|
79
|
-
- artifact accepted by validator.
|
|
80
|
-
- API/UI reflected or API/UI reflects accepted evidence.
|
|
81
|
-
- browser or user path verified.
|
|
82
|
-
- final gate/check command passed.
|
|
83
|
-
|
|
84
|
-
An AC cannot be complete when its required layer is missing.
|
|
85
|
-
|
|
86
|
-
## Invalid Evidence Rules
|
|
87
|
-
|
|
88
|
-
The prompt must reject false proof:
|
|
89
|
-
|
|
90
|
-
- viewmodel-only does not prove a real page.
|
|
91
|
-
- unit test does not prove real API behavior or latency.
|
|
92
|
-
- artifact exists does not prove artifact accepted by validator.
|
|
93
|
-
- old result does not prove current state.
|
|
94
|
-
- build passes does not prove product acceptance.
|
|
95
|
-
- stale, partial, smoke-only, dry-run or research evidence cannot prove full completion.
|
|
96
|
-
- unresolved API/UI/data/test contradictions invalidate completion claims.
|
|
97
|
-
|
|
98
|
-
## Completion State Machine
|
|
99
|
-
|
|
100
|
-
Every AC starts as `unknown / not_run`.
|
|
101
|
-
|
|
102
|
-
Only fresh required evidence can mark an AC complete.
|
|
103
|
-
|
|
104
|
-
Any fresh browser / API / runtime / data / test contradiction must downgrade the affected AC and overall status and must be recorded as invalidating evidence. Do not preserve a previous complete status after contradictory fresh evidence appears.
|
|
105
|
-
|
|
106
|
-
## UI-Facing Gate
|
|
107
|
-
|
|
108
|
-
For UI-facing acceptance, the executor must open the real page path and confirm the user-visible state matches the AC. component / viewmodel / mock / unit test evidence is auxiliary unless the full checklist explicitly says otherwise.
|
|
109
|
-
|
|
110
|
-
##
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
-
|
|
115
|
-
|
|
116
|
-
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
Superpowers
|
|
167
|
-
|
|
168
|
-
-
|
|
169
|
-
-
|
|
170
|
-
-
|
|
171
|
-
-
|
|
172
|
-
-
|
|
173
|
-
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
-
|
|
203
|
-
-
|
|
204
|
-
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
-
|
|
218
|
-
-
|
|
219
|
-
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
1
|
+
---
|
|
2
|
+
name: superpowers-long-task
|
|
3
|
+
description: Use when directly invoked for Superpowers long-running task target prompt preparation.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Superpowers Long Task Skill
|
|
7
|
+
|
|
8
|
+
## Package-Managed Boundary
|
|
9
|
+
|
|
10
|
+
This Skill is generated by `ty-context sync` and owned by the Harness package. Do not edit the generated `superpowers-long-task` Skill directly in a consumer project.
|
|
11
|
+
|
|
12
|
+
This is Tiny Context's adapter for feeding a complete acceptance packet into the external Superpowers workflow. It is not a Superpowers official schema and 不是 Superpowers 官方 schema. It only makes the target-mode prompt explicit enough that the official Superpowers skills can do their intended work without losing Tiny Context acceptance authority.
|
|
13
|
+
|
|
14
|
+
## Purpose
|
|
15
|
+
|
|
16
|
+
Consumes a complete acceptance packet and emits a paste-ready Superpowers target-mode prompt. The input packet normally comes from `/normal-long-task`.
|
|
17
|
+
|
|
18
|
+
Use this Skill only after the implementation/source plan and full acceptance checklist already exist or are pasted in full. Do not generate, derive, rewrite, strengthen, or repair the full checklist in this Skill. If the checklist is incomplete, stop and send the user back to `/normal-long-task` or ask for the missing fields.
|
|
19
|
+
|
|
20
|
+
## Direct Invocation
|
|
21
|
+
|
|
22
|
+
Use this Skill through explicit invocation:
|
|
23
|
+
|
|
24
|
+
```text
|
|
25
|
+
/superpowers-long-task
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Do not rely on broad automatic keyword routing. Use `/normal-long-task` first when the implementation/source plan and full acceptance checklist do not already exist.
|
|
29
|
+
|
|
30
|
+
## Use Cases
|
|
31
|
+
|
|
32
|
+
Use this Skill when a complete plan/checklist packet needs:
|
|
33
|
+
|
|
34
|
+
- Superpowers target-mode prompt.
|
|
35
|
+
- Superpowers goal-mode prompt.
|
|
36
|
+
- Superpowers 目标模式文本.
|
|
37
|
+
- Superpowers-compatible Codex target prompt.
|
|
38
|
+
- Maximum official Superpowers workflow value from an existing acceptance checklist.
|
|
39
|
+
|
|
40
|
+
Do not trigger merely because a plan mentions TDD or subagents. The user must ask for a Superpowers target/goal prompt or equivalent execution adapter.
|
|
41
|
+
|
|
42
|
+
## Required Input Packet
|
|
43
|
+
|
|
44
|
+
The input must fully expose these fields:
|
|
45
|
+
|
|
46
|
+
- Original requirement source or original plan summary.
|
|
47
|
+
- implementation/source plan path or pasted text.
|
|
48
|
+
- full acceptance checklist path or pasted text.
|
|
49
|
+
- local audit path, normally `tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md`.
|
|
50
|
+
- relevant Context that must be read before execution.
|
|
51
|
+
- required tests / core paths.
|
|
52
|
+
- Evidence Layer Separation rules.
|
|
53
|
+
- Invalid Evidence Rules.
|
|
54
|
+
- Completion State Machine rules.
|
|
55
|
+
- UI-Facing Gate rules when any AC touches UI.
|
|
56
|
+
- hard blockers or an explicit no-blocker statement.
|
|
57
|
+
|
|
58
|
+
If any of these are missing required fields, stop. Do not generate the Superpowers target-mode prompt. Report the missing fields and say whether they belong in the development plan, full checklist, local audit rule, blocker section or Context reference.
|
|
59
|
+
|
|
60
|
+
## Source Roles
|
|
61
|
+
|
|
62
|
+
- Original requirement source prevents implementation/source plan or checklist shrinkage.
|
|
63
|
+
- implementation/source plan is execution direction, not proof.
|
|
64
|
+
- full acceptance checklist is the highest-priority completion standard.
|
|
65
|
+
- local audit records progress, evidence, blockers and invalidating evidence only; it is not proof.
|
|
66
|
+
- relevant Context remains the durable repo intent and boundary source.
|
|
67
|
+
- required tests / core paths bind AC gaps to executable verification.
|
|
68
|
+
|
|
69
|
+
Do not let a compact target prompt override the full checklist. The compact prompt is direction, priority and recovery navigation only. The full checklist wins conflicts.
|
|
70
|
+
|
|
71
|
+
## Evidence Layer Separation
|
|
72
|
+
|
|
73
|
+
Keep these layers separate in the prompt when relevant:
|
|
74
|
+
|
|
75
|
+
- code implemented.
|
|
76
|
+
- runtime configured.
|
|
77
|
+
- runtime exercised.
|
|
78
|
+
- artifact generated.
|
|
79
|
+
- artifact accepted by validator.
|
|
80
|
+
- API/UI reflected or API/UI reflects accepted evidence.
|
|
81
|
+
- browser or user path verified.
|
|
82
|
+
- final gate/check command passed.
|
|
83
|
+
|
|
84
|
+
An AC cannot be complete when its required layer is missing.
|
|
85
|
+
|
|
86
|
+
## Invalid Evidence Rules
|
|
87
|
+
|
|
88
|
+
The prompt must reject false proof:
|
|
89
|
+
|
|
90
|
+
- viewmodel-only does not prove a real page.
|
|
91
|
+
- unit test does not prove real API behavior or latency.
|
|
92
|
+
- artifact exists does not prove artifact accepted by validator.
|
|
93
|
+
- old result does not prove current state.
|
|
94
|
+
- build passes does not prove product acceptance.
|
|
95
|
+
- stale, partial, smoke-only, dry-run or research evidence cannot prove full completion.
|
|
96
|
+
- unresolved API/UI/data/test contradictions invalidate completion claims.
|
|
97
|
+
|
|
98
|
+
## Completion State Machine
|
|
99
|
+
|
|
100
|
+
Every AC starts as `unknown / not_run`.
|
|
101
|
+
|
|
102
|
+
Only fresh required evidence can mark an AC complete.
|
|
103
|
+
|
|
104
|
+
Any fresh browser / API / runtime / data / test contradiction must downgrade the affected AC and overall status and must be recorded as invalidating evidence. Do not preserve a previous complete status after contradictory fresh evidence appears.
|
|
105
|
+
|
|
106
|
+
## UI-Facing Gate
|
|
107
|
+
|
|
108
|
+
For UI-facing acceptance, the executor must open the real page path and confirm the user-visible state matches the AC. component / viewmodel / mock / unit test evidence is auxiliary unless the full checklist explicitly says otherwise.
|
|
109
|
+
|
|
110
|
+
## Autonomous Progress Protocol
|
|
111
|
+
|
|
112
|
+
The Superpowers target prompt must require maximum safe autonomous progress within current platform, repository, tool and user-authorized permission boundaries. Do not ask the user for work the executor can safely discover, run, inspect or verify itself.
|
|
113
|
+
|
|
114
|
+
The Superpowers target prompt must inherit current repository/global `AGENTS.md` or agent-instruction permission policy. Authorized `sudo` / `gsudo` / administrator elevation is not a user blocker; the executor must try it before pausing. Pause only if elevation is unavailable, fails, or requires user/system authorization.
|
|
115
|
+
|
|
116
|
+
Pause only for locally unsatisfiable hard blockers such as missing accounts, credentials, production access, paid services, legal/security approval, user-only browser sessions or sensitive fields the executor cannot access safely. When pausing, give the minimum user action list: exact page, system, command or owner to open/contact; exact field or value location; how to redact or avoid sending sensitive values; what the executor will do immediately after receiving the input.
|
|
117
|
+
|
|
118
|
+
## Official Superpowers Binding
|
|
119
|
+
|
|
120
|
+
Bind the target prompt to the official Skill names and their documented roles:
|
|
121
|
+
|
|
122
|
+
- If the implementation/source plan is not bite-sized enough, use `superpowers:writing-plans`.
|
|
123
|
+
- Prefer `superpowers:subagent-driven-development` when subagents are available.
|
|
124
|
+
- Use `superpowers:executing-plans` when executing a written plan without the same-session subagent workflow.
|
|
125
|
+
- AC gap -> TDD: every behavior acceptance gap uses `superpowers:test-driven-development` to write a failing test, observe failure, then implement minimally.
|
|
126
|
+
- Before any completion claim, use `superpowers:verification-before-completion` against the full checklist and fresh evidence.
|
|
127
|
+
- review / finish cannot override the full checklist; if the checklist is unsatisfied, continue implementation or report blockers.
|
|
128
|
+
|
|
129
|
+
If Superpowers is missing, install it through the current platform's official Superpowers installation path. If installation is blocked by permissions, network or platform limits, record the blocker in local audit and do not count it as complete.
|
|
130
|
+
|
|
131
|
+
## Local Audit Requirements
|
|
132
|
+
|
|
133
|
+
The Superpowers target prompt must require the future executor to update local audit after each round with:
|
|
134
|
+
|
|
135
|
+
- overall status.
|
|
136
|
+
- each AC status and current evidence.
|
|
137
|
+
- command/result/time and failure reason.
|
|
138
|
+
- required test command/result/failure.
|
|
139
|
+
- artifact or evidence paths.
|
|
140
|
+
- blockers, missing evidence and acceptance impact.
|
|
141
|
+
- deferred or narrowed scope.
|
|
142
|
+
- stale, partial, smoke, dry-run, research or other invalid evidence.
|
|
143
|
+
|
|
144
|
+
The local audit is not Context, not proof, not a global task manager, and not a replacement for project tests, CI, review, human acceptance, Task Contract or workflow-contract `plan.md`.
|
|
145
|
+
|
|
146
|
+
## Prompt Generation Rules
|
|
147
|
+
|
|
148
|
+
- The prompt must visibly output `Superpowers 输入包` for Chinese prompts or `Superpowers input packet` for English prompts.
|
|
149
|
+
- The prompt must visibly output `Superpowers 执行绑定` for Chinese prompts or `Superpowers execution binding` for English prompts.
|
|
150
|
+
- The prompt must identify plan path, full checklist path and local audit path at the top.
|
|
151
|
+
- The prompt must state that the full checklist is the complete acceptance standard and wins conflicts.
|
|
152
|
+
- The prompt must preserve hard-blocker semantics: if only locally unsatisfiable hard blockers remain, pause for the user or external owner instead of marking complete.
|
|
153
|
+
- The prompt must require maximum safe autonomous progress within current platform, repository, tool and user-authorized permission boundaries and must include the minimum user action list for locally unsatisfiable hard blockers.
|
|
154
|
+
- The prompt must inherit current repository/global `AGENTS.md` or agent-instruction permission policy. Authorized `sudo` / `gsudo` / administrator elevation is not a user blocker; the executor must try it before pausing. Pause only if elevation is unavailable, fails, or requires user/system authorization.
|
|
155
|
+
- The prompt must include the resource lifecycle line: `可多开agent,agent名额不够了就关掉不用的。` or `You may use multiple agents; if agent slots run low, close idle or unnecessary agents.`
|
|
156
|
+
- The prompt must fit 3850 characters including line breaks.
|
|
157
|
+
- Do not include explanatory preface inside the generated prompt.
|
|
158
|
+
|
|
159
|
+
Recommended compact Chinese prompt shape:
|
|
160
|
+
|
|
161
|
+
```text
|
|
162
|
+
实施计划: tmp/ty-context/plan-acceptance/<plan-slug>.md(source/implementation plan,非验收证明)
|
|
163
|
+
完整验收清单: tmp/ty-context/plan-acceptance/<plan-slug>-acceptance-checklist.md(该文件是完整验收标准,验收以这个为准。完成前必须逐项检查,不满足则继续实现。)
|
|
164
|
+
执行审计: tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md(临时 progress state,非 Context/proof)
|
|
165
|
+
可多开agent,agent名额不够了就关掉不用的。
|
|
166
|
+
本摘要只负责 direction/priority/recovery navigation;允许与完整 checklist 重叠,冲突时以完整 checklist 为准。This is not a Superpowers official schema / 不是 Superpowers 官方 schema。
|
|
167
|
+
Superpowers 输入包:
|
|
168
|
+
- 原始需求源/原始方案摘要:防止计划/checklist 缩水
|
|
169
|
+
- 实施计划:执行方向;不够 bite-sized 时用 superpowers:writing-plans
|
|
170
|
+
- 完整验收清单:最高优先级完成标准;completion gate 以它为准
|
|
171
|
+
- local audit:只记 progress/evidence/blocker/invalidating evidence,非 proof
|
|
172
|
+
- relevant Context:执行前读取;冲突按完整 checklist 和 Context 规则处理
|
|
173
|
+
- required tests / core paths:把每个 AC gap 绑定到测试、API/UI/runtime/browser 验证
|
|
174
|
+
|
|
175
|
+
自主推进:在当前平台/仓库/工具/用户已授权权限内推进到所有 agent 能安全完成的事项;不把可自助发现/执行/验证的事交给用户。
|
|
176
|
+
权限策略:遵循当前仓库/全局 AGENTS.md 或 agent instructions;已授权 sudo/gsudo/admin elevation 不视为用户阻塞,先尝试使用;只有提权不可用/失败/需用户系统授权时才记 blocker。
|
|
177
|
+
强卡点:仅在本地无法解决的账号/凭证/真实环境/人工审批/敏感字段等阻塞时暂停;暂停时给最小用户执行清单(具体页面/系统、字段位置、脱敏/勿发值、拿到后下一步)。
|
|
178
|
+
如果 Superpowers 未安装,先按当前平台 official Superpowers installation path 安装;若 installation is blocked by 权限/网络/平台限制,写入 audit,不得算完成。
|
|
179
|
+
Superpowers 执行绑定:
|
|
180
|
+
- 先读完整验收清单,验收以它为准
|
|
181
|
+
- 计划不够可执行时,用 superpowers:writing-plans 转成 bite-sized implementation plan
|
|
182
|
+
- 有 subagent 支持时优先用 superpowers:subagent-driven-development;否则用 superpowers:executing-plans
|
|
183
|
+
- AC gap -> TDD:每个行为验收缺口先用 superpowers:test-driven-development write a failing test 并 observe failure,再写最小实现
|
|
184
|
+
- 完成声明前用 superpowers:verification-before-completion 按完整 checklist 和 fresh evidence 做 gate
|
|
185
|
+
- review / finish cannot override the full checklist;不满足则继续实现或报告 blocker
|
|
186
|
+
- 每轮后更新 audit:AC status、证据、命令/结果/时间、required test command/result/failure、evidence path、blocker、deferred/narrowed scope、无效证据
|
|
187
|
+
|
|
188
|
+
状态机:AC 初始 unknown / not_run;只有 fresh required evidence 才能 complete;任何 fresh browser / API / runtime / data / test contradiction 必须 downgrade the affected AC and overall status,并记录 invalidating evidence。
|
|
189
|
+
UI-Facing Gate:UI 验收必须打开 real page path 且用户可见状态匹配;component / viewmodel / mock / unit test 只算辅助证据,除非完整 checklist 明确说明。
|
|
190
|
+
禁止完成于:只改代码/计划、只跑部分测试、旧或部分证据、runtime 未配置/未演练、artifact 未被 validator accepted、API/UI 未 reflected、强卡点未解除、API/UI/data/test 矛盾。
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
Recommended compact English prompt shape:
|
|
194
|
+
|
|
195
|
+
```text
|
|
196
|
+
Plan: tmp/ty-context/plan-acceptance/<plan-slug>.md (implementation/source plan, not acceptance proof)
|
|
197
|
+
Full checklist: tmp/ty-context/plan-acceptance/<plan-slug>-acceptance-checklist.md (complete acceptance standard; judge against it; check every item before completion)
|
|
198
|
+
Local audit: tmp/ty-context/plan-acceptance/<plan-slug>-local-audit.md (temporary progress state, not Context or proof)
|
|
199
|
+
You may use multiple agents; if agent slots run low, close idle or unnecessary agents.
|
|
200
|
+
This summary is direction/priority/recovery only; overlap is allowed and the full checklist wins conflicts. This is not a Superpowers official schema / 不是 Superpowers 官方 schema.
|
|
201
|
+
Superpowers input packet:
|
|
202
|
+
- Source/original requirement: prevents plan/checklist shrinkage.
|
|
203
|
+
- Plan: execution direction; if not bite-sized, use superpowers:writing-plans.
|
|
204
|
+
- Full checklist: acceptance authority and completion gate.
|
|
205
|
+
- Local audit: progress/evidence/blockers/invalidating evidence only; not proof.
|
|
206
|
+
- Relevant Context: read before execution; resolve conflicts through checklist + Context.
|
|
207
|
+
- Required tests/core paths: map AC gaps to test/API/UI/runtime/browser evidence.
|
|
208
|
+
|
|
209
|
+
Autonomous progress: within current platform/repo/tool/user-authorized permissions, do everything the agent can safely do; do not hand self-service discovery/execution/verification to the user. Hard blockers: pause only for locally unsatisfiable account/credential/real-env/human-approval/sensitive-field needs; give a minimal user action list (exact page/system, field location, redaction/do-not-send values, next agent step).
|
|
210
|
+
Permission policy: follow current repo/global AGENTS.md or agent instructions; authorized sudo/gsudo/admin elevation is not a user blocker, try it before pausing; pause only if elevation is unavailable, fails, or needs user/system authorization.
|
|
211
|
+
If Superpowers is missing, install it through the current platform's official Superpowers installation path; if installation is blocked by permissions/network/platform, record in audit and do not count as complete.
|
|
212
|
+
Superpowers execution binding:
|
|
213
|
+
- Read the full checklist first; acceptance is judged against it.
|
|
214
|
+
- Use superpowers:writing-plans if the plan is not executable enough.
|
|
215
|
+
- Prefer superpowers:subagent-driven-development with subagents; otherwise use superpowers:executing-plans.
|
|
216
|
+
- AC gap -> TDD: every behavior acceptance gap first uses superpowers:test-driven-development to write a failing test, observe failure, then implement minimally.
|
|
217
|
+
- Before any completion claim, use superpowers:verification-before-completion against fresh evidence.
|
|
218
|
+
- review / finish cannot override the full checklist; if unsatisfied, continue or report blockers.
|
|
219
|
+
- After each round update audit: AC status, evidence, command/result/time, required test command/result/failure, evidence paths, blockers, deferred/narrowed scope, invalid evidence.
|
|
220
|
+
|
|
221
|
+
State machine: ACs start unknown / not_run; only fresh required evidence can mark complete; any fresh browser / API / runtime / data / test contradiction downgrades the affected AC and overall status and is invalidating evidence.
|
|
222
|
+
UI-Facing Gate: open the real page path and confirm visible state; component / viewmodel / mock / unit test evidence is auxiliary unless checklist says otherwise.
|
|
223
|
+
Never complete on: code-only, plan-only, partial tests, stale/partial evidence, unconfigured/unexercised runtime, artifact not accepted by validator, API/UI not reflected, hard blockers, or API/UI/data/test contradictions.
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
Before final response, check the prompt length. If it exceeds 3850 characters, tighten wording while preserving paths, input roles, official Superpowers skill names, state machine, UI gate, blockers and invalid evidence.
|
|
227
|
+
|
|
228
|
+
## Final Response Requirements
|
|
229
|
+
|
|
230
|
+
When successful, return:
|
|
231
|
+
|
|
232
|
+
- The implementation/source plan path.
|
|
233
|
+
- The full checklist path.
|
|
234
|
+
- The local audit path.
|
|
235
|
+
- Whether required input was complete.
|
|
236
|
+
- The paste-ready Superpowers target-mode prompt in a code block.
|
|
237
|
+
|
|
238
|
+
When blocked, return:
|
|
239
|
+
|
|
240
|
+
- Missing required fields.
|
|
241
|
+
- Which source should provide each missing field.
|
|
242
|
+
- A clear statement that no Superpowers target-mode prompt was generated.
|
|
243
|
+
|
|
244
|
+
Do not claim any AC has passed unless the user explicitly asked for current completion audit and current evidence was inspected.
|
|
245
|
+
|
|
246
|
+
## Forbidden Behaviors
|
|
247
|
+
|
|
248
|
+
Do not generate, derive, rewrite, strengthen, or repair the full checklist.
|
|
249
|
+
|
|
250
|
+
Do not execute the generated prompt.
|
|
251
|
+
|
|
252
|
+
Do not mark any goal complete.
|
|
253
|
+
|
|
254
|
+
Do not hide missing source files, ambiguous scope, weak evidence or blockers.
|
|
255
|
+
|
|
256
|
+
Do not include business-domain logic, concrete provider names, API names, UI names, artifact schemas or one-off project details in this package-managed Skill.
|