@wenaixi/dsh-superpower 7.3.0 → 7.5.1

package/skills/diagnosing-superpowers/templates/bundle-README.md

@@ -1,51 +1,77 @@
-# superpowers 会话诊断 bundle
-
-会话：<session-id>
-harness：<name> <version>（<来源标签>）    superpowers：<version>（<sha 或 "not a checkout">；<来源标签>）
-脱敏级别：skeleton | evidence | full
-构建时间：<ISO 时间戳>
-
-头部版本字段按 历史证据 / 未验证快照 / 当前观察 / 未知 限定。`environment.json` 对每个环境字段及其支撑位置携带同样的来源区分。
-
-## 这是什么
-
-一份安装过 superpowers 且出过问题的编码代理会话的脱敏记录。它让未在场的代理或人决定 superpowers 是否起作用，以及若起作用要改什么。其中报告以 `path:line` 证据说明发生了什么。按设计它不含对 superpowers 的诊断与建议修复；那是读者的工作。
-
-## 文件
-
-- `report.md` — 诊断报告（问题陈述、结论、环境、会话、时间线、发现、参与程度、覆盖范围说明）。
-- `case.md` — 分析师们依据的 case 文件。
-- `environment.json` — 环境部分的机器可读副本。
-- `timeline.md` — 逐回合时间线。
-- `findings/<dimension>.md` — 各维度的分析师原始发现。
-- `transcripts/<session-id>.md` — 每个被检会话的逐回合压缩渲染（绝不是原始 JSONL）。工具结果正文按级别：
-
-  | 级别 | 工具结果正文 |
+# Superpowers session diagnosis bundle
+
+Session: <session-id>
+Harness: <name> <version> (<provenance label>)    Superpowers: <version> (<sha or "not a checkout">; <provenance label>)
+Redaction level: skeleton | evidence | full
+Built: <ISO timestamp>
+
+Qualify header version fields as historical evidence, unverified snapshot,
+current observation, or unknown. `environment.json` carries the same
+provenance distinctions for every environment field and its supporting
+location.
+
+## What this is
+
+A scrubbed record of a coding-agent session that had superpowers installed
+and went wrong. It lets an agent or person who was not present decide
+whether superpowers contributed and, if so, what to change. The report
+inside states what happened with `path:line` evidence. By design it
+contains no diagnosis of superpowers and no proposed fix; that is the
+reader's job.
+
+## Files
+
+- `report.md` — the diagnosis report (problem statement, verdict,
+  environment, sessions, timeline, findings, involvement, coverage notes).
+- `case.md` — the case file the analysts worked from.
+- `environment.json` — machine-readable copy of the environment section.
+- `timeline.md` — the per-turn timeline.
+- `findings/<dimension>.md` — raw analyst findings per dimension.
+- `transcripts/<session-id>.md` — condensed per-turn rendering of each
+  examined session (never the raw JSONL). Tool-result bodies by level:
+
+  | Level | Tool-result bodies |
   |---|---|
-  | skeleton | 有意省略；替换为 `[tool result: <tool>, <bytes> bytes, exit <code>]` |
-  | evidence | 被引用事件保留，包括支撑发现所需的命令与结果 |
-  | full | 全部保留 |
-
-- `scrub-log.md` — 用到的每个占位符及其类别（绝不是原始值）。
+  | skeleton | intentionally limited; replaced by `[tool result: <tool>, <bytes> bytes, exit <code>]` |
+  | evidence | kept for cited events, including the commands and results needed to support findings |
+  | full | all kept |
+- `scrub-log.md` — every placeholder used and its category (never the
+  original value).
 
-## 如何阅读
+## How to read it
 
-从 `report.md` §1–2 开始，然后 §7（参与程度）及其引用的证据行，再读 `transcripts/` 中对应的回合。`path:line` 引用指向报告者机器上的原始文件；同一行号在压缩 transcript 中以 `[L<n>]` 标记保留。
+Start with `report.md` §1–2, then §7 (involvement) and the evidence lines
+it cites, then the matching turns in `transcripts/`. `path:line` references
+point at the original files on the reporter's machine; the same line
+numbers are preserved in the condensed transcripts as `[L<n>]` markers.
 
-## 脱敏
+## Redaction
 
-占位符形如 `<EMAIL-1>`、`<PERSON-2>`、`<SECRET-3>`、`<HOST-4>`、`<REPO-5>`、`<ORG-6>`、`<PROPRIETARY-7>`；家目录路径改写为 `~/…`。同一占位符在本 bundle 内始终指向同一原始值。
+Placeholders look like `<EMAIL-1>`, `<PERSON-2>`, `<SECRET-3>`, `<HOST-4>`,
+`<REPO-5>`, `<ORG-6>`, `<PROPRIETARY-7>`; home paths are rewritten to `~/…`. The same placeholder
+always refers to the same original value within this bundle.
 
-## 生产者说明
+## Producer instructions
 
-完成后的 bundle 用实际结果替换这些说明。
+Completed bundles replace these instructions with actual results.
 
-脱敏后，仅用本 bundle 检查每条实质导出的发现：把其引用解析到包含的 transcript/来源标记，读取被引用的命令/结果或引文，验证它是否支撑该论断。仅有路径与行号存在并不足够。当脱敏级别或必要扣留移除了支撑时，记录具体局限。
+After scrubbing, check every material exported finding using only this bundle:
+resolve its citation to an included transcript/source marker, read the cited
+command/result or quotation, and verify that it supports the claim. Path and
+line existence alone are insufficient. Record specific limitations when the
+redaction level or necessary withholding removes support.
 
-对账 report、case、environment、findings、README 与任何本地 issue 草稿。对照最终文件（不含日志本身）刷新脱敏日志计数。移除过时的导出声明；区分 bundle 准备与归档交付。保留从历史锚点到包含证据的映射。
+Reconcile report, case, environment, findings, README and any local issue
+draft. Refresh scrub-log counts against final files excluding the log itself.
+Remove stale export statements; distinguish bundle preparation from archive
+delivery. Retain a mapping from historical anchors to included evidence.
 
-把独立隐私审计与证据可用性分开记录：
-- 隐私审计：CLEAN 或未解决的遗漏。
-- 证据支撑：受支撑或受限，注明受影响的发现与原因。
+Record the independent privacy audit separately from evidence usefulness:
+- Privacy audit: CLEAN or unresolved misses.
+- Evidence support: supported or limited, with affected findings and reasons.
 
-检查后内容有变，重跑受影响的检查。展示最终日志、文件清单与两项结论，供既有归档批准使用。归档已审阅文件并验证交付的归档与之匹配。在已审阅 bundle 之外记录归档交付，而不是在批准后改动其内容。脱敏不是穷尽的隐私认证。
+If content changes after checking, repeat the affected checks. Present the
+final log, file list and both outcomes for the existing archive approval.
+Archive the reviewed files and verify the delivered archive matches them.
+Record archive delivery outside the reviewed bundle rather than changing its
+contents after approval. Scrubbing is not exhaustive privacy certification.

package/skills/diagnosing-superpowers/templates/case.md

@@ -1,57 +1,64 @@
-# Case：<session-id>
+# Case: <session-id>
 
-workspace：~/.superpowers/diagnosing-superpowers/<session-id>/
-创建时间：<ISO 时间戳>
+Workspace: ~/.superpowers/diagnosing-superpowers/<session-id>/
+Created: <ISO timestamp>
 
-## 问题陈述（与你的 human partner 达成一致）
+## Problem statement (agreed with your human partner)
 
-<一段话。指明会话（们）、已知的回合范围、期望什么、发生了什么、以及重要的可观察量：墙钟时间、token 数、重复动作、某个具体的意外动作。>
+<One paragraph. Names the session(s), the turn range if known, what was
+expected, what happened, and the observable that matters: wall-clock,
+tokens, repeated actions, a specific unexpected action.>
 
-目标是提交 superpowers 缺陷报告：是 | 否
+Goal is a superpowers bug report: yes | no
 
-## 会话
+## Sessions
 
-| 角色 | 会话 id | 绝对路径 | 行数 | 字节 | 最长行（字节） | 首个 prompt（前 120 字符） | 首个时间戳 |
+| Role | Session id | Absolute path | Lines | Bytes | Longest line (bytes) | First prompt (first 120 chars) | First timestamp |
 |---|---|---|---|---|---|---|---|
-| 主会话 | | | | | | | |
+| main | | | | | | | |
 | subagent | | | | | | | |
 
-被拒候选：<id — 路径 — 拒绝原因>，或"无"。
+Rejected candidates: <id — path — why rejected>, or "none".
 
-读取时会话仍在运行：是 | 否（mtime <ISO>，行数 <N>）
+Session still running at read time: yes | no (mtime <ISO>, lines <N>)
 
-## 环境
+## Environment
 
-- OS：<名称与版本>
-- harness：<name> <version>
-- 所见模型：<model id — 位置（主会话 / subagent id）>
-- superpowers 安装根：<路径>；版本 <x.y.z>；git sha <sha 或 "not a checkout">
-- 会话期间读取或注入的技能文件：
+- OS: <name and version>
+- Harness: <name> <version>
+- Models seen: <model id — where (main / subagent id)>
+- Superpowers install root: <path>; version <x.y.z>; git sha <sha or "not a checkout">
+- Skill files read or injected during the session:
 
-| 技能 / 来源路径 | sha1 或不可用 | 来源 | 支撑位置 |
+| Skill / source path | sha1 or unavailable | Provenance | Supporting location |
 |---|---|---|---|
 
-把环境与技能观察标记为 历史证据 / 未验证快照 / 当前观察 / 未知。在宣布历史信息不可用之前，检查提供的来源说明、归档与被捕获的技能正文。缺失原始路径不会抹去保留的副本。当前版本/mtime 不能确立历史版本；一份被捕获的技能正文不能认证整个安装。
-
-- 已配置的其他插件 / 扩展 / MCP 服务器：<列表，或 "none found">
-- 存在的指令文件（仅路径）：<列表>
-
-## 这些文件的每个读者都应遵守的上下文安全规则
-
-- 读取此处列出的任何文件前，遵循 `references/context-safety.md`。
-- 在 subagent transcript 中，"user"是父代理。
-
-## 已发现来源与记录含义
-
-- 查阅的来源：<绝对路径、工具、帮助或文档来源>
-- 提取命令或查询：<对每个来源使用的有界命令或工具查询>
-- 目标身份证据：<会话 id、工作目录、时间戳、匹配内容与支撑记录位置>
-- 关联会话：<会话 id、关系与支撑记录位置，或 "none found">
-- 人类消息：<记录形状与含义证据>
-- 注入消息与父代理派发：<记录形状与含义证据>
-- 助手消息：<记录形状与含义证据>
-- 工具调用与结果：<记录形状、如何匹配及含义证据>
-- 用量计数器：<字段、增量或累计语义、单位与证据，或 "unavailable">
-- 时序：<字段、单位、事件边界与证据，或 "unavailable">
-- 其他相关记录：<模型、版本、压缩或其它含义与证据>
-- 未解决信息：<缺失、不可访问、歧义或不存在的信息，或 "none">
+Label environment and skill observations as historical evidence, unverified
+snapshot, current observation, or unknown. Check supplied provenance notes,
+archives and captured skill bodies before declaring historical information
+unavailable. Missing original paths do not erase retained copies. Current
+versions/mtimes do not establish historical versions; one captured skill body
+does not authenticate an entire installation.
+
+- Other plugins / extensions / MCP servers configured: <list, or "none found">
+- Instruction files present (paths only): <list>
+
+## Context-safety rules for every reader of these files
+
+- Follow `references/context-safety.md` before reading any file listed here.
+- In a subagent transcript, "user" is the parent agent.
+
+## Discovered sources and record meanings
+
+- Sources consulted: <absolute path, tool, help, or documentation source>
+- Extraction commands or queries: <bounded commands or tool queries used for each source>
+- Target identity evidence: <session id, working directory, timestamps, matching content, and supporting record locations>
+- Associated sessions: <session id, relationship, and supporting record locations, or "none found">
+- Human messages: <record shape and evidence for its meaning>
+- Injected messages and parent dispatches: <record shape and evidence for its meaning>
+- Assistant messages: <record shape and evidence for its meaning>
+- Tool calls and results: <record shapes, how they match, and evidence for those meanings>
+- Usage counters: <fields, incremental or cumulative semantics, units, and evidence, or "unavailable">
+- Timing: <fields, units, event boundaries, and evidence, or "unavailable">
+- Other relevant records: <models, versions, compactions, or other meanings and evidence>
+- Unresolved information: <missing, inaccessible, ambiguous, or absent information, or "none">

package/skills/diagnosing-superpowers/templates/issue.md

@@ -1,45 +1,51 @@
-标题：<技能或症状>：<一行可观察量>（<harness>）
+Title: <skill or symptom>: <one-line observable> (<harness>)
 
-- [x] 我已搜索现有 issue 且这不是重复（搜索：<查询词>；最接近：<#n 标题，或 "none">）
+- [x] I searched existing issues and this is not a duplicate (searched: <query terms>; closest: <#n title, or "none">)
 
-## 环境（必填）
+## Environment (required)
 
-| 字段 | 值 | 来源 / 支撑证据 |
+| Field | Value | Provenance / supporting evidence |
 |-------|-------|-------------------------------|
-| superpowers 版本 | <version>（<sha 或 "not a checkout">） | <历史证据 / 未验证快照 / 当前观察 / 未知>；<位置> |
-| harness (DSH) | <harness> | <标签>；<位置> |
-| harness 版本 | <version> | <标签>；<位置> |
-| 你的模型 + 版本 | <所见 model ids> | <标签>；<位置> |
-| 已安装的全部插件 | <列表> | <标签>；<位置> |
-| OS + shell | <os 版本>, <shell> | <标签>；<位置> |
+| Superpowers version | <version> (<sha or "not a checkout">) | <historical evidence / unverified snapshot / current observation / unknown>; <location> |
+| Harness (Claude Code, Cursor, etc.) | <harness> | <label>; <location> |
+| Harness version | <version> | <label>; <location> |
+| Your model + version | <model ids seen> | <label>; <location> |
+| All plugins installed | <list> | <label>; <location> |
+| OS + shell | <os version>, <shell> | <label>; <location> |
 
-## 这是 superpowers 问题还是平台问题？
+## Is this a Superpowers issue or a platform issue?
 
-- [ ] 我确认未安装 superpowers 时该问题不会出现
+- [ ] I confirmed this issue does not occur without Superpowers installed
 
-报告者尚未尝试在不安装 superpowers 的情况下复现。参与程度的证据见下；它不确立因果。
+The reporter has not tried reproducing without superpowers. Evidence for
+involvement is below; it does not establish cause.
 
-## 发生了什么？
+## What happened?
 
-<问题陈述，然后是分诊结论，`path:line` 引用改写为 `transcript line <n>`。>
+<Problem statement, then the triage verdict, with `path:line` citations
+rewritten as `transcript line <n>`.>
 
-## 复现步骤
+## Steps to reproduce
 
-1. <首个人类 prompt，已脱敏>
-2. <导致问题的回合，每行一个>
-3. <可观察量>
+1. <first human prompt, scrubbed>
+2. <the turns leading to the problem, one line each>
+3. <the observable>
 
-## 预期行为
+## Expected behavior
 
-<来自问题陈述>
+<from the problem statement>
 
-## 实际行为
+## Actual behavior
 
-<来自分诊结论>
+<from the triage verdict>
 
-## 调试日志或会话 transcript
+## Debug log or conversation transcript
 
-会话 id：<ids>。交付的本地归档：<路径，脱敏级别 <级别> | 未构建>。附加 bundle：<不声明；仅在批准后附加>。诊断报告所述的 superpowers 参与程度：<possible | likely>，证据位于 <transcript 行>。本报告不提出修复。
+Session id(s): <ids>. Delivered local archive: <path, redaction level <level>
+| none built>. Attached bundle: <no claim; attach only after approval>.
+Superpowers involvement per the diagnosis report: <possible | likely>, with
+evidence at <transcript lines>. This report does not propose a fix.
 
 ---
-使用 `diagnosing-superpowers` 技能提交。模型、harness、harness 版本与已安装插件列于上方。
+Filed with the `diagnosing-superpowers` skill. Model, harness, harness
+version, and installed plugins are listed above.

package/skills/diagnosing-superpowers/templates/report.md

@@ -1,76 +1,82 @@
-# 会话诊断：<session-id>
+# Session diagnosis: <session-id>
 
-报告路径：~/.superpowers/diagnosing-superpowers/<session-id>/report.md
-撰写时间：<ISO 时间戳>
+Report path: ~/.superpowers/diagnosing-superpowers/<session-id>/report.md
+Written: <ISO timestamp>
 
-## 1. 问题陈述（必填）
+## 1. Problem statement (REQUIRED)
 
-<从 case 文件复制。>
+<Copied from the case file.>
 
-## 2. 分诊结论（必填）
+## 2. Triage verdict (REQUIRED)
 
-<证据显示报告问题周围实际发生了什么。散文式，每条论断后带 `path:line`。说明置信度：高 / 中 / 低，以及什么能提高它。不陈述 superpowers 应该做什么。>
+<What the evidence shows happened around the reported problem. Prose, with
+`path:line` after every claim. State confidence: high / medium / low, and
+what would raise it. No statement about what superpowers should do.>
 
-## 3. 环境（必填）
+## 3. Environment (REQUIRED)
 
-- OS：
-- harness 与版本：
-- 所见模型：
-- superpowers 安装根 / 版本 / git sha：
-- 读取或注入的技能文件（来自 case 文件的 sha1 表）：
-- 其他插件、扩展、MCP 服务器：
-- 存在的指令文件（仅路径）：
+- OS:
+- Harness and version:
+- Models seen:
+- Superpowers install root / version / git sha:
+- Skill files read or injected (sha1 table from the case file):
+- Other plugins, extensions, MCP servers:
+- Instruction files present (paths only):
 
-把每个环境字段与技能观察标记为 历史证据 / 未验证快照 / 当前观察 / 未知，并记录其支撑证据位置。
+Label every environment field and skill observation as historical evidence,
+unverified snapshot, current observation, or unknown, and record its
+supporting evidence location.
 
-## 4. 检视的会话（必填）
+## 4. Sessions examined (REQUIRED)
 
-| 角色 | 会话 id | 绝对路径 | 行数 | 字节 |
+| Role | Session id | Absolute path | Lines | Bytes |
 |---|---|---|---|---|
 
-被拒候选：<id — 路径 — 原因>，或"无"。
+Rejected candidates: <id — path — why>, or "none".
 
-## 5. 时间线（必填）
+## 5. Timeline (REQUIRED)
 
-每条人类输入的 prompt 一行。事件列列出被调用的技能、派发的 subagent、压缩、错误、恢复、中止。
+One row per human-typed prompt. Events column lists skills invoked,
+subagents dispatched, compaction, errors, resumes, aborts.
 
-| 回合 | 行 | 时间 | 请求（一行） | 事件 |
+| Turn | Line | Time | Request (one line) | Events |
 |---|---|---|---|---|
 
-## 6. 发现（必填，每个维度一小节）
+## 6. Findings (REQUIRED, one subsection per dimension)
 
-每条发现：
+Each finding:
 ```
-- finding: <一句话>
-  evidence: <path:line> — "<短引文>"
-  turns: <首>–<末>
-  confidence: 高 | 中 | 低
+- finding: <one sentence>
+  evidence: <path:line> — "<short quote>"
+  turns: <first>–<last>
+  confidence: high | medium | low
 ```
-无内容可报的维度写 `none found — checked: <检查了什么>`。
+A dimension with nothing to report says `none found — checked: <what was checked>`.
 
-### 6.1 技能时间线
-### 6.2 计划遵守
-### 6.3 重复工作
-### 6.4 磕绊
-### 6.5 质量证据
-### 6.6 请求冲突
-### 6.7 成本与时间
-### 6.8 使用的其他插件与技能
+### 6.1 Skill timeline
+### 6.2 Plan adherence
+### 6.3 Repeated work
+### 6.4 Stumbles
+### 6.5 Quality evidence
+### 6.6 Request conflicts
+### 6.7 Cost and time
+### 6.8 Other plugins and skills used
 
-## 7. superpowers 参与程度（必填）
+## 7. Superpowers involvement (REQUIRED)
 
-未指示 | 可能 | 很可能
+not indicated | possible | likely
 
-证据行：<path:line 列表>。本节仅陈述参与程度。它不指认缺陷，也不提出修改。
+Evidence lines: <path:line list>. This section states involvement only. It
+does not name a defect and does not propose a change.
 
-## 8. 覆盖范围说明（必填）
+## 8. Coverage notes (REQUIRED)
 
-- 未读：<范围、文件与原因>
-- harness 功能不可用：<列表或无>
-- 读取时会话在进行中：是/否
-- 需要你的 human partner 复核：<列表或无>
+- Not read: <ranges, files, and why>
+- Harness features unavailable: <list or none>
+- Session was in progress at read time: yes/no
+- For your human partner to double-check: <list or none>
 
-## 9. 相似会话（仅应要求时）
+## 9. Similar sessions (only when requested)
 
-| 会话 id | 路径 | 日期 | harness | 匹配 | 未匹配 |
-|---|---|---|---|---|---|
+| Session id | Path | Date | Harness | Matched | Did not match |
+|---|---|---|---|---|---|