superpowers-zh 1.7.12 → 1.8.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/.claude-plugin/marketplace.json +3 -3
- package/.claude-plugin/plugin.json +2 -2
- package/.codex-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +2 -2
- package/.opencode/INSTALL.md +82 -14
- package/.opencode/plugins/superpowers.js +319 -31
- package/GEMINI.md +3 -2
- package/README.md +68 -36
- package/README.zh-Hant.md +66 -37
- package/RELEASE-NOTES.zh.md +154 -0
- package/assets/sponsors/88api.jpg +0 -0
- package/assets/sponsors/apinebula.png +0 -0
- package/assets/sponsors/logo-infistar-icon.png +0 -0
- package/assets/sponsors/logo-sidrune-ai.png +0 -0
- package/assets/sponsors/logo-volcengine-icon.png +0 -0
- package/assets/sponsors/volcengine.png +0 -0
- package/bin/superpowers-zh.js +21 -2
- package/docs/README.aider.md +2 -2
- package/docs/README.claw.md +1 -1
- package/docs/README.cline.md +3 -3
- package/docs/README.codearts.md +1 -1
- package/docs/README.codebuddy.md +1 -1
- package/docs/README.codex.md +26 -0
- package/docs/README.crush.md +1 -1
- package/docs/README.deepseek-harness.md +1 -1
- package/docs/README.deerflow.md +1 -1
- package/docs/README.hermes.md +1 -1
- package/docs/README.kilocode.md +3 -3
- package/docs/README.kiro.md +1 -1
- package/docs/README.opencode.md +128 -19
- package/docs/README.qoder.md +1 -1
- package/docs/README.qwen.md +1 -1
- package/docs/README.trae-cn.md +62 -0
- package/docs/README.vscode.md +1 -1
- package/docs/README.zcode.md +2 -2
- package/gemini-extension.json +1 -1
- package/hooks/run-hook.cmd +34 -18
- package/hooks/session-start +45 -9
- package/index.js +9 -0
- package/package.json +4 -3
- package/skills/brainstorming/SKILL.md +111 -181
- package/skills/brainstorming/builder-check-prompt.md +15 -0
- package/skills/brainstorming/scripts/server.cjs +1 -1
- package/skills/brainstorming/visual-companion.md +36 -33
- package/skills/chinese-code-review/SKILL.md +1 -1
- package/skills/chinese-commit-conventions/SKILL.md +1 -1
- package/skills/diagnosing-superpowers/SKILL.md +102 -0
- package/skills/diagnosing-superpowers/prompts/analyst-common.md +32 -0
- package/skills/diagnosing-superpowers/prompts/cost-and-time.md +20 -0
- package/skills/diagnosing-superpowers/prompts/plan-adherence.md +21 -0
- package/skills/diagnosing-superpowers/prompts/quality-evidence.md +20 -0
- package/skills/diagnosing-superpowers/prompts/repeated-work.md +24 -0
- package/skills/diagnosing-superpowers/prompts/request-conflicts.md +14 -0
- package/skills/diagnosing-superpowers/prompts/scrub-audit.md +26 -0
- package/skills/diagnosing-superpowers/prompts/scrub.md +22 -0
- package/skills/diagnosing-superpowers/prompts/similar-session.md +34 -0
- package/skills/diagnosing-superpowers/prompts/skill-timeline.md +23 -0
- package/skills/diagnosing-superpowers/prompts/stumbles.md +20 -0
- package/skills/diagnosing-superpowers/references/context-safety.md +20 -0
- package/skills/diagnosing-superpowers/references/github-issues.md +46 -0
- package/skills/diagnosing-superpowers/references/redaction-policy.md +29 -0
- package/skills/diagnosing-superpowers/references/session-discovery.md +23 -0
- package/skills/diagnosing-superpowers/templates/bundle-README.md +65 -0
- package/skills/diagnosing-superpowers/templates/case.md +61 -0
- package/skills/diagnosing-superpowers/templates/issue.md +48 -0
- package/skills/diagnosing-superpowers/templates/report.md +78 -0
- package/skills/executing-plans/SKILL.md +176 -125
- package/skills/executing-plans/scripts/task-done +52 -0
- package/skills/executing-plans/scripts/task-start +28 -0
- package/skills/mcp-builder/SKILL.md +1 -1
- package/skills/requesting-code-review/SKILL.md +2 -2
- package/skills/requesting-code-review/code-reviewer.md +8 -0
- package/skills/subagent-driven-development/SKILL.md +17 -17
- package/skills/subagent-driven-development/re-review-prompt.md +1 -1
- package/skills/subagent-driven-development/scripts/review-package +8 -1
- package/skills/subagent-driven-development/scripts/sdd-workspace +51 -4
- package/skills/subagent-driven-development/scripts/task-brief +3 -1
- package/skills/subagent-driven-development/task-reviewer-prompt.md +2 -2
- package/skills/systematic-debugging/CREATION-LOG.md +1 -1
- package/skills/systematic-debugging/SKILL.md +2 -2
- package/skills/systematic-debugging/root-cause-tracing.md +1 -1
- package/skills/test-driven-development/SKILL.md +2 -0
- package/skills/using-superpowers/SKILL.md +19 -14
- package/skills/using-superpowers/references/claude-code-tools.md +11 -0
- package/skills/using-superpowers/references/muse-tools.md +35 -0
- package/skills/writing-plans/SKILL.md +34 -27
- package/skills/writing-skills/SKILL.md +5 -3
- package/assets/sponsors/apimart.jpg +0 -0
- package/assets/sponsors/compshare.jpg +0 -0
- package/assets/sponsors/logo-apimart-icon.png +0 -0
- package/assets/sponsors/logo-compshare-icon.png +0 -0
- package/skills/brainstorming/spec-document-reviewer-prompt.md +0 -48
- package/skills/writing-plans/plan-document-reviewer-prompt.md +0 -49
|
@@ -261,7 +261,7 @@ function isFullDocument(html) {
|
|
|
261
261
|
}
|
|
262
262
|
|
|
263
263
|
function wrapInFrame(content) {
|
|
264
|
-
return renderBranding(frameTemplate).replace('<!-- CONTENT -->', content);
|
|
264
|
+
return renderBranding(frameTemplate).replace('<!-- CONTENT -->', () => content);
|
|
265
265
|
}
|
|
266
266
|
|
|
267
267
|
function getNewestScreen() {
|
|
@@ -22,59 +22,62 @@
|
|
|
22
22
|
- **技术决策** — API 设计、数据建模、架构方案选择
|
|
23
23
|
- **澄清问题** — 任何回答是文字而非视觉偏好的问题
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
*关于* UI 主题的问题不一定是视觉问题。"你想要什么样的向导?"是概念性的——使用终端。"这些向导布局中哪个感觉对?"是视觉性的——使用浏览器。
|
|
26
26
|
|
|
27
27
|
## 工作原理
|
|
28
28
|
|
|
29
|
-
服务器监视一个目录中的 HTML
|
|
29
|
+
服务器监视一个目录中的 HTML 文件,将最新的文件提供给浏览器。你把 HTML 内容写入 `screen_dir`,用户在浏览器中看到它,并可以点击选择选项。选择结果被记录到 `state_dir/events`,你在下一轮读取它。
|
|
30
30
|
|
|
31
|
-
**内容片段 vs 完整文档:** 如果你的 HTML 文件以 `<!DOCTYPE` 或 `<html` 开头,服务器会原样提供(仅注入辅助脚本)。否则,服务器会自动将你的内容包裹在框架模板中——添加头部、CSS
|
|
31
|
+
**内容片段 vs 完整文档:** 如果你的 HTML 文件以 `<!DOCTYPE` 或 `<html` 开头,服务器会原样提供(仅注入辅助脚本)。否则,服务器会自动将你的内容包裹在框架模板中——添加头部、CSS 主题、连接状态和所有交互基础设施。**默认写内容片段即可。** 只有当你需要完全控制页面时才写完整文档。
|
|
32
32
|
|
|
33
33
|
## 启动会话
|
|
34
34
|
|
|
35
35
|
```bash
|
|
36
|
-
#
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
#
|
|
36
|
+
# 在用户同意使用视觉伴侣之后再启动。--open 会在推送第一个屏幕时自动打开浏览器;
|
|
37
|
+
# --project-dir 让原型持久化,并支持用同一端口重启。
|
|
38
|
+
bash scripts/start-server.sh --project-dir /path/to/project --open
|
|
39
|
+
|
|
40
|
+
# 返回:{"type":"server-started","port":52341,
|
|
41
|
+
# "url":"http://localhost:52341/?key=ab12…",
|
|
42
|
+
# "screen_dir":"/path/to/project/.superpowers/brainstorm/12345-1706000000/content",
|
|
43
|
+
# "state_dir":"/path/to/project/.superpowers/brainstorm/12345-1706000000/state"}
|
|
41
44
|
```
|
|
42
45
|
|
|
43
|
-
保存响应中的 `screen_dir
|
|
46
|
+
保存响应中的 `screen_dir` 和 `state_dir`。使用 `--open` 时,你推送第一个屏幕时浏览器会自己打开——不需要请用户去打开,但仍要把 URL 发给他们作为兜底(无头/远程环境不会自动打开)。
|
|
47
|
+
|
|
48
|
+
**URL 里带有会话密钥(`?key=…`)。** 服务器会拒绝任何不带它的请求,
|
|
49
|
+
所以永远要把 `url` 字段里的**完整** URL 交给用户——
|
|
50
|
+
绝不去掉查询字符串,也绝不给出一个光秃秃的 `http://host:port`。这个
|
|
51
|
+
密钥守着 HTTP 和 WebSocket 访问,让误开的浏览器标签页或网络上的其他机器
|
|
52
|
+
无法读取屏幕内容或注入事件。首次加载后浏览器会通过 cookie 记住密钥,
|
|
53
|
+
所以刷新页面和 `/files/*` 资源都无需再带上它。
|
|
44
54
|
|
|
45
|
-
**查找连接信息:** 服务器将其启动 JSON 写入 `$
|
|
55
|
+
**查找连接信息:** 服务器将其启动 JSON 写入 `$STATE_DIR/server-info`。如果你在后台启动了服务器且没有捕获 stdout,读取该文件以获取 URL 和端口。使用 `--project-dir` 时,检查 `<project>/.superpowers/brainstorm/` 获取会话目录。
|
|
46
56
|
|
|
47
57
|
**注意:** 传入项目根目录作为 `--project-dir`,这样原型会持久化在 `.superpowers/brainstorm/` 中,不会因服务器重启而丢失。不传的话,文件会保存到 `/tmp` 并在清理时被删除。提醒用户将 `.superpowers/` 添加到 `.gitignore`(如果尚未添加)。
|
|
48
58
|
|
|
49
59
|
**按平台启动服务器:**
|
|
50
60
|
|
|
51
|
-
**Claude Code
|
|
61
|
+
**Claude Code:**
|
|
52
62
|
```bash
|
|
53
|
-
#
|
|
54
|
-
scripts/start-server.sh --project-dir /path/to/project
|
|
63
|
+
# 默认模式即可——脚本会自己把服务器放到后台。
|
|
64
|
+
bash scripts/start-server.sh --project-dir /path/to/project --open
|
|
55
65
|
```
|
|
56
66
|
|
|
57
|
-
|
|
58
|
-
```bash
|
|
59
|
-
# Windows 会自动检测并使用前台模式,这会阻塞工具调用。
|
|
60
|
-
# 在 Bash 工具调用上设置 run_in_background: true,
|
|
61
|
-
# 让服务器在会话轮次之间存活。
|
|
62
|
-
scripts/start-server.sh --project-dir /path/to/project
|
|
63
|
-
```
|
|
64
|
-
通过 Bash 工具调用时,设置 `run_in_background: true`。然后在下一轮读取 `$SCREEN_DIR/.server-info` 获取 URL 和端口。
|
|
67
|
+
在 Windows 上,脚本会自动检测并切换到前台模式(这会阻塞工具调用)。在 Bash 工具调用上设置 `run_in_background: true`,让服务器在会话轮次之间存活,然后在下一轮读取 `$STATE_DIR/server-info` 获取 URL 和端口。
|
|
65
68
|
|
|
66
69
|
**Codex:**
|
|
67
70
|
```bash
|
|
68
71
|
# Codex 会回收后台进程。脚本会自动检测 CODEX_CI 并
|
|
69
72
|
# 切换到前台模式。正常运行即可——不需要额外标志。
|
|
70
|
-
scripts/start-server.sh --project-dir /path/to/project
|
|
73
|
+
bash scripts/start-server.sh --project-dir /path/to/project --open
|
|
71
74
|
```
|
|
72
75
|
|
|
73
76
|
**Gemini CLI:**
|
|
74
77
|
```bash
|
|
75
78
|
# 使用 --foreground 并在 shell 工具调用上设置 is_background: true,
|
|
76
79
|
# 让进程在轮次之间存活
|
|
77
|
-
scripts/start-server.sh --project-dir /path/to/project --foreground
|
|
80
|
+
bash scripts/start-server.sh --project-dir /path/to/project --open --foreground
|
|
78
81
|
```
|
|
79
82
|
|
|
80
83
|
**Copilot CLI:**
|
|
@@ -91,7 +94,7 @@ bash scripts/start-server.sh --project-dir /path/to/project --open --foreground
|
|
|
91
94
|
如果浏览器无法访问该 URL(在远程/容器化环境中常见),绑定一个非回环主机:
|
|
92
95
|
|
|
93
96
|
```bash
|
|
94
|
-
scripts/start-server.sh \
|
|
97
|
+
bash scripts/start-server.sh \
|
|
95
98
|
--project-dir /path/to/project \
|
|
96
99
|
--host 0.0.0.0 \
|
|
97
100
|
--url-host localhost
|
|
@@ -102,10 +105,10 @@ scripts/start-server.sh \
|
|
|
102
105
|
## 工作循环
|
|
103
106
|
|
|
104
107
|
1. **检查服务器存活**,然后**将 HTML 写入** `screen_dir` 中的新文件:
|
|
105
|
-
-
|
|
108
|
+
- **必须:在提及 URL 或推送屏幕之前,先确认服务器还活着。** 检查 `$STATE_DIR/server-info` 存在且 `$STATE_DIR/server-stopped` 不存在。如果服务器已关闭,用 `start-server.sh` 以**相同的 `--project-dir`** 重启——它会复用同一端口,用户开着的标签页会自己重新连上(服务器停机期间页面会显示"已暂停"遮罩),你不需要发新的 URL。服务器空闲 4 小时后会自动退出(可用 `--idle-timeout-minutes` 配置)。
|
|
106
109
|
- 使用语义化文件名:`platform.html`、`visual-style.html`、`layout.html`
|
|
107
110
|
- **绝不复用文件名** — 每个屏幕用一个新文件
|
|
108
|
-
-
|
|
111
|
+
- 使用你的文件创建工具 — **绝不使用 cat/heredoc**(会在终端产生噪音)
|
|
109
112
|
- 服务器自动提供最新的文件
|
|
110
113
|
|
|
111
114
|
2. **告诉用户预期内容并结束你的回合:**
|
|
@@ -114,9 +117,9 @@ scripts/start-server.sh \
|
|
|
114
117
|
- 请他们在终端中回复:"看一下,告诉我你的想法。如果你愿意,可以点击选择一个选项。"
|
|
115
118
|
|
|
116
119
|
3. **在你的下一轮** — 用户在终端回复后:
|
|
117
|
-
- 如果存在 `$
|
|
120
|
+
- 如果存在 `$STATE_DIR/events`,读取它——其中包含用户的浏览器交互(点击、选择),格式为 JSON 行
|
|
118
121
|
- 将终端文字和事件合并以获得完整信息
|
|
119
|
-
-
|
|
122
|
+
- 终端消息是主要反馈;`state_dir/events` 提供结构化的交互数据
|
|
120
123
|
|
|
121
124
|
4. **迭代或推进** — 如果反馈要求修改当前屏幕,写入新文件(例如 `layout-v2.html`)。只有当前步骤验证通过后才进入下一个问题。
|
|
122
125
|
|
|
@@ -135,7 +138,7 @@ scripts/start-server.sh \
|
|
|
135
138
|
|
|
136
139
|
## 编写内容片段
|
|
137
140
|
|
|
138
|
-
只写放在页面内部的内容。服务器会自动用框架模板包裹它(头部、主题 CSS
|
|
141
|
+
只写放在页面内部的内容。服务器会自动用框架模板包裹它(头部、主题 CSS、连接状态和所有交互基础设施)。
|
|
139
142
|
|
|
140
143
|
**最简示例:**
|
|
141
144
|
|
|
@@ -181,7 +184,7 @@ scripts/start-server.sh \
|
|
|
181
184
|
</div>
|
|
182
185
|
```
|
|
183
186
|
|
|
184
|
-
**多选:** 在容器上添加 `data-multiselect`
|
|
187
|
+
**多选:** 在容器上添加 `data-multiselect` 让用户选择多个选项。每次点击切换该项的选中样式。
|
|
185
188
|
|
|
186
189
|
```html
|
|
187
190
|
<div class="options" data-multiselect>
|
|
@@ -253,7 +256,7 @@ scripts/start-server.sh \
|
|
|
253
256
|
|
|
254
257
|
## 浏览器事件格式
|
|
255
258
|
|
|
256
|
-
当用户在浏览器中点击选项时,交互记录会保存到 `$
|
|
259
|
+
当用户在浏览器中点击选项时,交互记录会保存到 `$STATE_DIR/events`(每行一个 JSON 对象)。推送新屏幕时文件会自动清空。
|
|
257
260
|
|
|
258
261
|
```jsonl
|
|
259
262
|
{"type":"click","choice":"a","text":"选项 A - 简单布局","timestamp":1706000101}
|
|
@@ -263,7 +266,7 @@ scripts/start-server.sh \
|
|
|
263
266
|
|
|
264
267
|
完整的事件流展示了用户的探索路径——他们可能在确定之前点击了多个选项。最后一个 `choice` 事件通常是最终选择,但点击模式可以揭示犹豫或值得询问的偏好。
|
|
265
268
|
|
|
266
|
-
如果
|
|
269
|
+
如果 `$STATE_DIR/events` 不存在,说明用户没有与浏览器交互——仅使用他们的终端文字。
|
|
267
270
|
|
|
268
271
|
## 设计技巧
|
|
269
272
|
|
|
@@ -284,7 +287,7 @@ scripts/start-server.sh \
|
|
|
284
287
|
## 清理
|
|
285
288
|
|
|
286
289
|
```bash
|
|
287
|
-
scripts/stop-server.sh $
|
|
290
|
+
bash scripts/stop-server.sh $SESSION_DIR
|
|
288
291
|
```
|
|
289
292
|
|
|
290
293
|
如果会话使用了 `--project-dir`,原型文件会持久化在 `.superpowers/brainstorm/` 中以供日后参考。只有 `/tmp` 会话会在停止时被删除。
|
|
@@ -58,7 +58,7 @@ metadata:
|
|
|
58
58
|
原因:攻击者可以通过 name 参数注入 `'; DROP TABLE users; --`。
|
|
59
59
|
|
|
60
60
|
建议:使用参数化查询:
|
|
61
|
-
db.query('SELECT * FROM users WHERE name =
|
|
61
|
+
db.query('SELECT * FROM users WHERE name = ?', [name])
|
|
62
62
|
|
|
63
63
|
参考:https://cheatsheetseries.owasp.org/cheatsheets/SQL_Injection_Prevention_Cheat_Sheet.html
|
|
64
64
|
```
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: diagnosing-superpowers
|
|
3
|
+
description: 当一次 superpowers 会话出了问题、你的人类伙伴想知道原因时使用——重复劳动、无视计划、磕磕绊绊、结果质量差、某个技能没触发、"太慢了"、"为什么这么贵"、"它到底在干什么"——或者想给 superpowers 维护者整理一份 bug 报告;适用于当前会话,或按 id / 路径指定的过往会话,任何工具均可
|
|
4
|
+
version: "1.0.0"
|
|
5
|
+
license: MIT
|
|
6
|
+
metadata:
|
|
7
|
+
hermes:
|
|
8
|
+
tags: [debugging, diagnosis]
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# 诊断 Superpowers
|
|
12
|
+
|
|
13
|
+
## 概述
|
|
14
|
+
|
|
15
|
+
和你的人类伙伴一起明确一次会话到底哪里出了问题,读取磁盘上的会话记录(transcript),
|
|
16
|
+
用证据报告发生了什么。你负责报告,不负责诊断 superpowers。superpowers 要不要改,
|
|
17
|
+
由分诊这份打包材料或这条 issue 的人决定。
|
|
18
|
+
|
|
19
|
+
**核心原则:** 每条发现都要引用 `path:line`。没有引用,就不算发现。每个数字都来自
|
|
20
|
+
会话记录或你亲自跑过的命令,绝不凭记忆。
|
|
21
|
+
|
|
22
|
+
## 工作流
|
|
23
|
+
|
|
24
|
+
每一步建一个待办。第 5–7 步只在各自注明的条件下执行。
|
|
25
|
+
|
|
26
|
+
1. **问题受理。** 一次只问一个问题,直到你能写出一段陈述:点名是哪个(些)会话、
|
|
27
|
+
已知的话给出轮次范围、你的伙伴期望什么、实际发生了什么、他们关心的可观测量
|
|
28
|
+
(耗时、token、重复动作、某一个具体动作)。"太慢了"是抱怨,不是问题陈述。
|
|
29
|
+
记下目标是否是一份 superpowers bug 报告。
|
|
30
|
+
2. **定位。** 按 `references/session-discovery.md` 把每个会话解析成经过核实的
|
|
31
|
+
绝对文件系统路径。确认过往会话时,引用它的第一条提示词和时间戳,并列出你排除的
|
|
32
|
+
每个候选及理由,没有就写"none"。枚举子智能体的会话记录。创建
|
|
33
|
+
`~/.superpowers/diagnosing-superpowers/<session-id>/`,把路径告诉你的伙伴,
|
|
34
|
+
在其中填写 `templates/case.md`,环境与技能观察遵循其中的来源标注规则。
|
|
35
|
+
3. **分诊。** 先亲自读报告问题附近的那一段。然后为每个维度并行派发一个分析员子智能体,
|
|
36
|
+
每个都给它:案例文件路径、`prompts/analyst-common.md`,以及 `prompts/` 下的一个
|
|
37
|
+
维度文件:`skill-timeline.md`、
|
|
38
|
+
`plan-adherence.md`、`repeated-work.md`、`stumbles.md`、
|
|
39
|
+
`quality-evidence.md`、`request-conflicts.md`、`cost-and-time.md`。
|
|
40
|
+
会话记录很长时,按轮次范围拆分一个维度。凡是返回的发现没有 `path:line`,一律丢弃。
|
|
41
|
+
4. **报告。** 按顺序填写 `templates/report.md` 的每一节,写入工作区,展示出来,
|
|
42
|
+
并给出路径。核对被引用的内容实际能证明什么,并保留支撑它的案例;符号链接别名
|
|
43
|
+
不算冗余副本。
|
|
44
|
+
5. **GitHub issue** —— 当报告 §7 写的是 possible 或 likely,或你的伙伴要求时。
|
|
45
|
+
按 `references/github-issues.md` 在已开放和已关闭的 issue 中搜索这些症状。
|
|
46
|
+
展示匹配结果,建议把报告补充到最接近的那条。如果都不匹配,填写
|
|
47
|
+
`templates/issue.md`,写入工作区,展示确切文本,获得批准后才创建 issue。
|
|
48
|
+
`gh` 不能附加文件;如果有打包材料,把路径给你的伙伴,让他们在浏览器里附上。
|
|
49
|
+
6. **导出** —— 只在你的伙伴要求打包时进行;绝不主动打包。如果受理时的目标是 bug
|
|
50
|
+
报告,说一次"可以按需提供脱敏后的打包材料",然后等待。询问脱敏级别,并说明每一级
|
|
51
|
+
包含什么:skeleton(不含工具结果正文)、evidence(只含被引用事件的正文)、full。
|
|
52
|
+
按 `templates/bundle-README.md` 构建打包材料,派发 `prompts/scrub.md`,再派发
|
|
53
|
+
`prompts/scrub-audit.md`,两者反复执行,直到审计返回 CLEAN。
|
|
54
|
+
先完成打包模板里的证据核对与对账,再展示最终的脱敏日志、文件清单,以及隐私与
|
|
55
|
+
证据两方面的结论。获得批准后才归档(`zip -r` 或 `tar -czf`)。给出归档路径时,
|
|
56
|
+
说明其中包含什么,指向脱敏日志查看替换情况,并说明脱敏可能有遗漏:他们必须在
|
|
57
|
+
分享前逐个审阅每个文件。
|
|
58
|
+
7. **相似会话** —— 被要求时进行。把已确认的发现转成一个特征签名,按修改时间和大小
|
|
59
|
+
列出候选,找到标记所在的行号,对每个候选并行派发 `prompts/similar-session.md`,
|
|
60
|
+
然后追加到报告 §9。
|
|
61
|
+
|
|
62
|
+
## 速查
|
|
63
|
+
|
|
64
|
+
七个分析员始终全部运行。这张表说明第 3 步里你自己先读哪一段,以及结论中先讲哪些发现。
|
|
65
|
+
|
|
66
|
+
| 抱怨 | 先读、先讲 |
|
|
67
|
+
|---|---|
|
|
68
|
+
| "太慢了" | cost-and-time、stumbles |
|
|
69
|
+
| "它为什么做了额外的活?" | repeated-work、plan-adherence |
|
|
70
|
+
| "为什么这么贵?" | cost-and-time |
|
|
71
|
+
| "它到底在干什么?"(仍在运行) | skill-timeline;在覆盖说明中注明仍在进行 |
|
|
72
|
+
| "它无视了计划" | plan-adherence,先看压缩(compaction)所在行 |
|
|
73
|
+
| "技能 X 从没触发" | skill-timeline |
|
|
74
|
+
|
|
75
|
+
## 硬性规则
|
|
76
|
+
|
|
77
|
+
- **上下文安全。** 一行会话记录就可能有一兆字节。每个会话文件、每一次,都要遵循
|
|
78
|
+
`references/context-safety.md`。
|
|
79
|
+
- **只读。** 绝不修改、移动或删除会话文件。
|
|
80
|
+
- **给子智能体确切路径。** 子智能体的"当前会话"是它自己的会话。传绝对路径和 id。
|
|
81
|
+
- **只认人类提示词。** hook 输出、system reminder 和工具结果都不是你伙伴说的话。
|
|
82
|
+
在子智能体的会话记录里,"user" 是父智能体。
|
|
83
|
+
- **不诊断 superpowers。** 报告 §7 只陈述是否涉及,到此为止。绝不指出某个技能的缺陷,
|
|
84
|
+
也不提议修改。你的伙伴催着要修复,也不能豁免这一条;指向 issue 那一步,并提一句
|
|
85
|
+
可以按需提供打包材料。也不要给你的伙伴提建议。
|
|
86
|
+
- **批准关卡。** 你的伙伴看过脱敏日志和文件清单之前,不归档。他们批准确切文本之前,
|
|
87
|
+
不发 issue 或评论。
|
|
88
|
+
- **先受理,后分析。** 你的伙伴答复之前,第 2–7 步一律不开始。如果他们不在,写下问题
|
|
89
|
+
然后停下。你替他们重构出来的陈述不算答复。一个范围已经明确的请求——某个具体事件、
|
|
90
|
+
现在正在运行什么、或者要跑哪项分析——本身就是陈述:先回答它,再提问。
|
|
91
|
+
针对整个会话的"为什么"是抱怨。
|
|
92
|
+
|
|
93
|
+
## 危险信号
|
|
94
|
+
|
|
95
|
+
| 想法 | 现实 |
|
|
96
|
+
|---------|---------|
|
|
97
|
+
| "问题很明显,跳过受理" | 问题陈述决定了一切的范围。去问。 |
|
|
98
|
+
| "他们不在,那我来重构陈述" | 你无法重构他们想要什么。写下问题,然后停下。 |
|
|
99
|
+
| "我先全部扫一遍,最后再问" | 无范围的扫描会把他们的预算花在错误的问题上。先问。 |
|
|
100
|
+
| "他们要 bug 报告,那我现在就打包" | 打包材料就是他们打包起来的会话数据。只在他们要求时才构建。 |
|
|
101
|
+
| "只是个小的定点修改,不用重构" | 再小也不归你决定。报告证据;由分诊的人决定。 |
|
|
102
|
+
| "每个 token 的价格众所周知" | 不是从会话记录里算出来的数字就是编造的。要么引用,要么删掉。 |
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
你是一个分析员子智能体。你读取磁盘上的一份编程智能体会话记录(transcript),
|
|
2
|
+
返回附带证据的发现。你不修复任何东西,不修改会话存储下的任何文件,也不说
|
|
3
|
+
superpowers 应该改什么。
|
|
4
|
+
|
|
5
|
+
输入(来自派发你的一方):
|
|
6
|
+
- CASE:案例文件的绝对路径。先读它。它点名了会话文件、要使用的已发现来源和
|
|
7
|
+
记录含义,以及你必须遵守的上下文安全规则。使用其中记录的含义,不要重新做发现,
|
|
8
|
+
也不要假定某种工具的格式。
|
|
9
|
+
- RANGE(可选):一个轮次范围或行号范围。如果给了,只分析该范围,并在你的
|
|
10
|
+
Checked 行里注明。
|
|
11
|
+
|
|
12
|
+
上下文安全:读取任何文件之前,都要遵循 CASE 里点名的 `references/context-safety.md`,
|
|
13
|
+
并用记录下来的命令或查询提取字段。"当前会话"不是你能看的东西:只使用 CASE 里的路径。
|
|
14
|
+
|
|
15
|
+
人类提示词是案例文件认定为人类输入的那些记录。hook 输出、system reminder 和工具结果
|
|
16
|
+
都不是人类提示词。在子智能体的会话记录里,"user" 是父智能体。
|
|
17
|
+
|
|
18
|
+
返回格式(只返回这些):
|
|
19
|
+
|
|
20
|
+
```
|
|
21
|
+
## <Dimension> findings
|
|
22
|
+
|
|
23
|
+
- finding: <一句话,发生了什么>
|
|
24
|
+
evidence: <绝对路径>:<行号> — "<引文,最多 200 个字符>"
|
|
25
|
+
turns: <第一个人类轮次>–<最后一个人类轮次>
|
|
26
|
+
confidence: high | medium | low
|
|
27
|
+
|
|
28
|
+
Checked: <你检查了什么:文件、行号范围、使用的命令>
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
派发方会丢弃任何没有 `path:line` 的发现,所以不要写这种发现。如果什么都没找到,
|
|
32
|
+
返回 `- none found` 和 Checked 行。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
先读 `prompts/analyst-common.md`;它给出你的角色、输入、上下文安全规则和返回格式。
|
|
2
|
+
本文件补充维度。
|
|
3
|
+
|
|
4
|
+
维度:成本与耗时(Cost and time)
|
|
5
|
+
|
|
6
|
+
弄清 token 和墙钟时间都花在了哪里。
|
|
7
|
+
|
|
8
|
+
1. Token。只使用案例文件中确立的用量记录和计数器含义。计算总量之前,先说明每个
|
|
9
|
+
计数器是增量的还是累计的;对累计观测值做差分,不要把缺失的观测值当成零。
|
|
10
|
+
报告有支撑的总量最大的五个轮次,以及每个关联会话有支撑的总量。
|
|
11
|
+
2. 墙钟时间。使用案例文件中记录的、有证据的时间戳字段、事件边界和单位。报告
|
|
12
|
+
有支撑的耗时最长的五个轮次,以及相邻事件之间超过十分钟的任何间隔(空闲、等待
|
|
13
|
+
某个关联会话、或等待你的人类伙伴;只有记录能表明时才说是哪一种)。
|
|
14
|
+
3. 最大的工具结果:用案例文件中有证据的工具结果记录,报告最大的十个结果及其工具和
|
|
15
|
+
轮次。先度量记录大小,再提取有界的内容。
|
|
16
|
+
4. 压缩(compaction):统计并定位那些在发现阶段被确认为压缩事件的记录。报告可得的
|
|
17
|
+
压缩前后计数器,以及每次触发时会话正在做什么;没有支撑的字段标记为缺失。
|
|
18
|
+
5. 关联会话:统计数量,并报告每个会话有支撑的用量、时长和派发它的轮次。
|
|
19
|
+
6. 报告在总量中占主导的轮次、子智能体、工具或重复,附上数字。除了会话记录能表明的
|
|
20
|
+
内容之外,不要推测某个轮次为什么昂贵。
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
先读 `prompts/analyst-common.md`;它给出你的角色、输入、上下文安全规则和返回格式。
|
|
2
|
+
本文件补充维度。
|
|
3
|
+
|
|
4
|
+
维度:计划遵循(Plan adherence)
|
|
5
|
+
|
|
6
|
+
还原会话中约定的计划,然后把计划的每一步对应到实际发生的事。这里的"计划"指任何
|
|
7
|
+
约定好的行动方案,不是 git 提交。
|
|
8
|
+
|
|
9
|
+
1. 找到约定的计划:在对话中约定的设计或计划(找人类回复"yes/ok/go ahead"/"好/可以/
|
|
10
|
+
开始吧"之前的那段助手文本)、会话中写出的规格或计划文件(写到 `docs/`、
|
|
11
|
+
`plans/`、`specs/` 下,或写到人类点名的任何文件的工具调用)、在案例文件中确立了
|
|
12
|
+
含义的待办列表记录,或助手文本中的任何编号清单。引用每个计划步骤及其 `path:line`。
|
|
13
|
+
2. 标记计划与执行之间的结构性事件:发现阶段识别出的压缩事件、恢复(resume)、中止的
|
|
14
|
+
轮次、关联会话的派发。记下它们的行号;紧跟在这些事件之后的计划偏离,是一条单独的发现。
|
|
15
|
+
3. 对每个计划步骤,找到执行它的工具调用和助手文本,或确认没有任何执行。报告:
|
|
16
|
+
- 被跳过的步骤(找不到执行;引用该计划步骤);
|
|
17
|
+
- 乱序执行的步骤(用行号表明顺序);
|
|
18
|
+
- 被悄悄改动的步骤(执行与计划步骤不同,而助手从未说明;两处都引用);
|
|
19
|
+
- 凭空多出的步骤(做了没有任何计划步骤覆盖的工作);
|
|
20
|
+
- 紧跟结构性事件之后的偏离(引用事件所在行和第一个偏离的动作)。
|
|
21
|
+
4. 如果没有可还原的计划,就把这一点作为唯一的发现,并附上你检查过的行。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
先读 `prompts/analyst-common.md`;它给出你的角色、输入、上下文安全规则和返回格式。
|
|
2
|
+
本文件补充维度。
|
|
3
|
+
|
|
4
|
+
维度:质量证据(Quality evidence)
|
|
5
|
+
|
|
6
|
+
用过程自己的声明来检验过程。这不是代码审查;不要评估会话产出的代码。
|
|
7
|
+
|
|
8
|
+
1. 测试:每一次测试运行(包含 `test`、`pytest`、`npm test`、`cargo test`、
|
|
9
|
+
`go test`、`bats`、`bash tests/…`,或指令文件中点名的项目测试运行器的命令)
|
|
10
|
+
及其结果行。报告失败的运行,以及助手接下来做了什么。
|
|
11
|
+
2. 声明背后的验证:找出助手声称已完成、已修复、通过、已验证、可用、完成的文本。
|
|
12
|
+
对每一处,在同一轮次中往前找能证明它的工具结果(一次测试运行、一段命令输出、
|
|
13
|
+
一份 diff)。报告在该轮次中没有任何支撑结果的声明。
|
|
14
|
+
3. 提交:每一次 `git commit` 及其提交信息;把每条信息与前一个(或几个)轮次里的
|
|
15
|
+
工具调用做对比。报告提交信息声称做了、但没有任何工具调用执行过的工作,以及约定的
|
|
16
|
+
计划说会提交、但实际做了却从未提交的工作。
|
|
17
|
+
4. 审查反馈:凡是审查者(人类或子智能体)提出了意见,找到对应的回应。报告已确认但
|
|
18
|
+
没有落实的意见,以及没有给出理由就被驳回的意见。
|
|
19
|
+
5. 验收标准:如果案例文件的问题陈述或约定的计划中写明了标准,逐条报告为
|
|
20
|
+
met / not met / not checked,并附上证据所在行。
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
先读 `prompts/analyst-common.md`;它给出你的角色、输入、上下文安全规则和返回格式。
|
|
2
|
+
本文件补充维度。
|
|
3
|
+
|
|
4
|
+
维度:重复劳动(Repeated work)
|
|
5
|
+
|
|
6
|
+
找出会话中做了不止一次的工作。
|
|
7
|
+
|
|
8
|
+
1. 把每一次工具调用提取为 `(line, turn, tool, key)`,其中 `key` 是:读/改/写文件时
|
|
9
|
+
为文件路径;shell 调用时为命令文本(去掉尾部空白;保留完整命令);子智能体派发时为
|
|
10
|
+
`description` 加上提示词的前 80 个字符;搜索时为查询内容。
|
|
11
|
+
2. 按 `(tool, key)` 分组,报告达到或超过阈值的组:
|
|
12
|
+
|
|
13
|
+
| 类别 | 阈值 | 豁免 |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| 读取、搜索 | 3 | |
|
|
16
|
+
| 编辑 | 2 | |
|
|
17
|
+
| shell 命令 | 2 | 状态检查和测试运行(`git status`、`ls`、`pwd`、测试运行器) |
|
|
18
|
+
| 子智能体派发 | 2(description 相同) | |
|
|
19
|
+
3. 对每一组,检查两次重复之间有没有发生变化(对该文件的写入、一次压缩、一次人类纠正)。
|
|
20
|
+
说明属于哪种情况;编辑之后的重读不算发现,压缩之后的重读是一条归因于压缩的发现,
|
|
21
|
+
中间什么都没发生的重读本身就是一条发现。
|
|
22
|
+
4. 查找重新推导的决定:助手文本得出了一个会话早先已经说过的结论(同一个文件、同一个
|
|
23
|
+
设计选择、同一条要跑的命令)。两处都引用。
|
|
24
|
+
5. 每组一条发现,附上第一个和最后一个行号以及次数。
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
先读 `prompts/analyst-common.md`;它给出你的角色、输入、上下文安全规则和返回格式。
|
|
2
|
+
本文件补充维度。
|
|
3
|
+
|
|
4
|
+
维度:请求冲突(Request conflicts)
|
|
5
|
+
|
|
6
|
+
1. 列出每一条人类提示词及其行号和轮次。对每一条,提取其中包含的指令(祈使句、约束、
|
|
7
|
+
"不要"、"总是"、"绝不"、"只"、范围说明)。
|
|
8
|
+
2. 报告:
|
|
9
|
+
- 两条无法同时遵守的人类指令(两处都引用,附行号),以及助手是怎么做的;
|
|
10
|
+
- 与会话中加载的某个指令文件(CLAUDE.md、AGENTS.md、GEMINI.md,或该工具的等价
|
|
11
|
+
文件;路径在案例文件里)相冲突的人类指令,两处都引用;
|
|
12
|
+
- 要求跳过、忽略或覆盖某个步骤、技能或规则的人类指令,以及之后发生了什么;
|
|
13
|
+
- 助手请求澄清的指令及得到的答复——当答复改变了范围时。
|
|
14
|
+
3. 不要评判你的人类伙伴对不对。报告冲突以及助手的处理方式。
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
检查任何文件之前,先阅读并遵循 `references/redaction-policy.md`。每一项审计判断都
|
|
2
|
+
使用其中的类别以及传入的列表。
|
|
3
|
+
|
|
4
|
+
你是脱敏审计员。另一个智能体已经对 BUNDLE 下的每个文件做过脱敏。你唯一的工作是找出
|
|
5
|
+
它漏掉的东西。你不修复任何东西;你只报告。
|
|
6
|
+
|
|
7
|
+
输入:
|
|
8
|
+
- BUNDLE:打包目录的绝对路径。
|
|
9
|
+
- PUBLIC_REPOS:你的人类伙伴说明为公开的仓库名或 URL 列表(可能为空)。
|
|
10
|
+
- PROPRIETARY:你的人类伙伴点名为专有的术语列表(可能为空)。
|
|
11
|
+
|
|
12
|
+
完整阅读 BUNDLE 下的每个文件(这些是精简后的文件,不是原始会话记录;仍然先跑
|
|
13
|
+
`wc -c`,文件超过 200 KB 时分块读取)。对每个文件应用这份共享策略,包括引用的会话
|
|
14
|
+
记录文本、提交信息、git 作者行和加密载荷。检查发现所需的安全的命令、结果、来源和
|
|
15
|
+
会话行结构是否仍然保留。
|
|
16
|
+
|
|
17
|
+
只有在不存在任何策略遗漏或未决的分类问题时,才返回 CLEAN。否则返回:
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
MISSED
|
|
21
|
+
- <file>:<line> — <category> — <不含敏感信息的描述,或分类问题>
|
|
22
|
+
...
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
绝不包含原始的敏感值。CLEAN 只针对隐私;它并不说明导出的发现仍然有支撑。不要评论
|
|
26
|
+
脱敏的质量。不要提出修复建议。
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
处理任何文件之前,先阅读并遵循 `references/redaction-policy.md`。每一项脱敏判断都
|
|
2
|
+
使用其中的类别以及传入的列表。
|
|
3
|
+
|
|
4
|
+
你是脱敏员。你重写 BUNDLE(派发方给你的一个目录路径)下的每个文件,使其可以离开这台
|
|
5
|
+
机器,并写出 BUNDLE/scrub-log.md。你绝不触碰 BUNDLE 之外的任何东西。
|
|
6
|
+
|
|
7
|
+
输入:
|
|
8
|
+
- BUNDLE:打包目录的绝对路径。
|
|
9
|
+
- PUBLIC_REPOS:你的人类伙伴说明为公开的仓库名或 URL 列表(可能为空)。
|
|
10
|
+
- PROPRIETARY:你的人类伙伴点名为专有的术语列表(可能为空)。
|
|
11
|
+
|
|
12
|
+
共享策略定义了类别和稳定的占位符。同一个原始值在所有文件中都映射到同一个占位符,
|
|
13
|
+
编号按首次出现的顺序分配。保留策略中关于安全的身份、关联、引用和证据的规则。
|
|
14
|
+
|
|
15
|
+
步骤:
|
|
16
|
+
1. `find BUNDLE -type f`,处理每一个文件,包括 `environment.json` 和 `findings/*.md`。
|
|
17
|
+
2. 边处理边构建替换映射,并应用到每个文件,使得首次出现在 `report.md` 里的值在
|
|
18
|
+
`transcripts/` 中也被替换。
|
|
19
|
+
3. 重写完成后,在所有最终的非日志打包文件中(不含 `scrub-log.md`)重新统计出现次数。
|
|
20
|
+
把 `BUNDLE/scrub-log.md` 写成一张 占位符 → 类别 → 次数 的表。绝不把明文替换映射或
|
|
21
|
+
原始值写进日志。
|
|
22
|
+
4. 返回脱敏日志表和被重写的文件列表。别的都不要。
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
你是一个匹配员。你判断一个候选会话是否表现出与已诊断会话相同的行为。你不修改任何文件。
|
|
2
|
+
|
|
3
|
+
输入:
|
|
4
|
+
- CASE:已诊断会话的案例文件的绝对路径。先读它,获取要使用的上下文安全规则、已发现的
|
|
5
|
+
记录含义和提取命令。
|
|
6
|
+
- CANDIDATE:要检查的一份会话记录的绝对路径。
|
|
7
|
+
- SIGNATURE:一组标记。每个标记是以下之一:
|
|
8
|
+
- `skill-sequence: <skill A> then <skill B> within <n> turns`
|
|
9
|
+
- `error-string: "<text>"`
|
|
10
|
+
- `repeated-command: "<command>" ≥ <n> times`
|
|
11
|
+
- `repeated-file: <path pattern> read ≥ <n> times`
|
|
12
|
+
- `compaction-then: <用一行描述的行为>`
|
|
13
|
+
- `missed-trigger: <skill> for requests matching "<text>"`
|
|
14
|
+
- `free: <一行描述>`(只依据会话记录判断)
|
|
15
|
+
|
|
16
|
+
步骤:
|
|
17
|
+
1. 对 CANDIDATE 应用 `references/context-safety.md`。用 CASE 中记录的命令提取它的身份:
|
|
18
|
+
会话 id、cwd、第一条人类提示词、第一个时间戳、工具版本和模型。
|
|
19
|
+
2. 对每个标记,先用只取行号的命令定位证据;再从具体的行中提取截短后的字段。有
|
|
20
|
+
`path:line` 时标记为 `hit`;搜索过但什么都没找到时为 `miss`;会话记录缺少所需字段时
|
|
21
|
+
为 `unknown`(说明缺哪个)。
|
|
22
|
+
3. 严格按如下格式返回:
|
|
23
|
+
|
|
24
|
+
```
|
|
25
|
+
candidate: <session id> — <absolute path>
|
|
26
|
+
identity: <harness> <version>, <first timestamp>, "<first prompt, 100 chars>"
|
|
27
|
+
match: yes | partial | no
|
|
28
|
+
markers:
|
|
29
|
+
- <marker>: hit — <path>:<line> — "<quote ≤ 120 chars>"
|
|
30
|
+
- <marker>: miss — checked <what>
|
|
31
|
+
- <marker>: unknown — <missing field>
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
`yes` = 每个标记都 hit;`partial` = 至少一个 hit;`no` = 一个都没有。
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
先读 `prompts/analyst-common.md`;它给出你的角色、输入、上下文安全规则和返回格式。
|
|
2
|
+
本文件补充维度。
|
|
3
|
+
|
|
4
|
+
维度:技能时间线(Skill timeline)
|
|
5
|
+
|
|
6
|
+
按人类轮次逐轮建立技能和插件的使用记录,然后找出缺口。
|
|
7
|
+
|
|
8
|
+
1. 列出人类提示词及其行号和时间戳。
|
|
9
|
+
2. 使用案例文件中确立的技能调用和归属含义,列出每一次显式调用、活跃技能归属,或对名为
|
|
10
|
+
`SKILL.md` 的文件的读取。记录所在行、技能名,以及发生在哪个人类轮次。
|
|
11
|
+
3. 列出用到的每一个非 superpowers 的插件、技能、智能体类型、MCP 服务器或 hook。只使用
|
|
12
|
+
案例文件中记录的、有证据的工具、归属、智能体派发、MCP 和 hook 含义;识别出与
|
|
13
|
+
`superpowers` 以外的东西相关联的值。
|
|
14
|
+
4. 对每个人类轮次,把请求文本与已安装的 superpowers 技能的触发描述做对比(读取
|
|
15
|
+
`<install root>/skills/*/SKILL.md` frontmatter 中的 `description` 行;install root 在
|
|
16
|
+
案例文件里)。报告为发现:
|
|
17
|
+
- 被调用的技能,以及在它之前的请求(调用不多时每次调用一条发现即可;多时按技能分组);
|
|
18
|
+
- 请求与某个技能的触发描述匹配、但该轮次中没有调用的轮次(说明匹配的是哪条描述,
|
|
19
|
+
并引用该请求);
|
|
20
|
+
- 在匹配的请求之后晚了一个或多个轮次才被调用的技能(迟到);
|
|
21
|
+
- 每一个用到的非 superpowers 插件/技能/工具,以及在哪里用到。
|
|
22
|
+
|
|
23
|
+
不要说漏掉或迟到的触发是不是错的。报告匹配情况和缺失情况;由读者判断。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
先读 `prompts/analyst-common.md`;它给出你的角色、输入、上下文安全规则和返回格式。
|
|
2
|
+
本文件补充维度。
|
|
3
|
+
|
|
4
|
+
维度:磕绊(Stumbles)
|
|
5
|
+
|
|
6
|
+
找出会话停止前进的每一个点。
|
|
7
|
+
|
|
8
|
+
来源,每一种都使用案例文件中有证据的记录含义和提取命令来定位行号:
|
|
9
|
+
- 被标记为错误的工具结果、非零退出,或明确的失败记录;
|
|
10
|
+
- 失败的 shell 命令(结果中非零退出、"command not found"、"No such file");
|
|
11
|
+
- 重试:同一轮次中出错后再次发起的相同工具调用;
|
|
12
|
+
- 被撤回的编辑:一次编辑之后紧跟着一次恢复早先内容的编辑,或对会话动过的文件执行
|
|
13
|
+
`git checkout`/`git restore`/`git revert`/`git reset`;
|
|
14
|
+
- 助手文本中的回退("actually"、"let me instead"、"that was wrong"、"I misread",
|
|
15
|
+
以及"其实"、"我换个方式"、"刚才错了"、"我看错了"这类说法);
|
|
16
|
+
- 人类纠正:与助手紧邻的前一个动作相矛盾或对其进行纠正的人类提示词;
|
|
17
|
+
- 权限拒绝、hook 失败、API 错误、限流、中止的轮次,以及任务中途触发的上下文溢出或压缩。
|
|
18
|
+
|
|
19
|
+
对每一次磕绊,报告所在行、轮次、什么失败了,以及接下来发生了什么(同一轮次内恢复 /
|
|
20
|
+
稍后在第 N 行恢复 / 从未恢复)。相同的重复失败合并成一条发现,并附上次数。
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# 会话记录的上下文安全
|
|
2
|
+
|
|
3
|
+
一条会话记录可能超过一兆字节,或者内嵌整段历史。把一整条记录打印出来,就可能撑爆
|
|
4
|
+
正在做诊断的那个会话的上下文。每一个读取会话文件的人——控制者或子智能体——对每个文件、
|
|
5
|
+
每一次都遵循这些规则。
|
|
6
|
+
|
|
7
|
+
1. **先度量再读取。**
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
wc -lc "$F"
|
|
11
|
+
awk '{ if (length($0) > 100000) print NR, length($0) }' "$F" # long lines
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
2. **绝不用 `cat` 或 `grep` 取内容。** 先拿行号和计数
|
|
15
|
+
(`grep -n … | cut -d: -f1`、`jq -r '.type' | sort | uniq -c`),
|
|
16
|
+
再从具体的行中取小字段(`sed -n Np | jq -c '{…}'` 或 `| cut -c1-500`)。
|
|
17
|
+
对眼前的这个来源,使用发现阶段确立的字段提取命令。
|
|
18
|
+
3. **超过 500 个字符就收窄。** 如果一条命令对一条记录返回了超过 500 个字符,
|
|
19
|
+
收紧字段或切片。
|
|
20
|
+
4. **只读。** 绝不修改、移动或删除会话文件。
|