diagnosing-superpowers SKILL.md skillA

diagnosing-superpowers from jnmetacode/superpowers-zh is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jnmetacode/superpowers-zh/diagnosing-superpowers@v1.0.0

Pins v1.0.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jnmetacode/superpowers-zh
Path
skills/diagnosing-superpowers/SKILL.md
Versions recorded
1
Latest version
v1.0.0, committed Sep 26, 2026
Size
7,195 bytes
Repository stars
8,348
License
MIT

当一次 superpowers 会话出了问题、你的人类伙伴想知道原因时使用——重复劳动、无视计划、磕磕绊绊、结果质量差、某个技能没触发、"太慢了"、"为什么这么贵"、"它到底在干什么"——或者想给 superpowers 维护者整理一份 bug 报告;适用于当前会话,或按 id / 路径指定的过往会话,任何工具均可.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 诊断 Superpowers

## 概述

和你的人类伙伴一起明确一次会话到底哪里出了问题,读取磁盘上的会话记录(transcript),
用证据报告发生了什么。你负责报告,不负责诊断 superpowers。superpowers 要不要改,
由分诊这份打包材料或这条 issue 的人决定。

**核心原则:** 每条发现都要引用 `path:line`。没有引用,就不算发现。每个数字都来自
会话记录或你亲自跑过的命令,绝不凭记忆。

## 工作流

每一步建一个待办。第 5–7 步只在各自注明的条件下执行。

1. **问题受理。** 一次只问一个问题,直到你能写出一段陈述:点名是哪个(些)会话、
   已知的话给出轮次范围、你的伙伴期望什么、实际发生了什么、他们关心的可观测量
   (耗时、token、重复动作、某一个具体动作)。"太慢了"是抱怨,不是问题陈述。
   记下目标是否是一份 superpowers bug 报告。
2. **定位。** 按 `references/session-discovery.md` 把每个会话解析成经过核实的
   绝对文件系统路径。确认过往会话时,引用它的第一条提示词和时间戳,并列出你排除的
   每个候选及理由,没有就写"none"。枚举子智能体的会话记录。创建
   `~/.superpowers/diagnosing-superpowers/<session-id>/`,把路径告诉你的伙伴,
   在其中填写 `templates/case.md`,环境与技能观察遵循其中的来源标注规则。
3. **分诊。** 先亲自读报告问题附近的那一段。然后为每个维度并行派发一个分析员子智能体,
   每个都给它:案例文件路径、`prompts/analyst-common.md`,以及 `prompts/` 下的一个
   维度文件:`skill-timeline.md`、
   `plan-adherence.md`、`repeated-work.md`、`stumbles.md`、
   `quality-evidence.md`、`request-conflicts.md`、`cost-and-time.md`。
   会话记录很长时,按轮次范围拆分一个维度。凡是返回的发现没有 `path:line`,一律丢弃。
4. **报告。** 按顺序填写 `templates/report.md` 的每一节,写入工作区,展示出来,
   并给出路径。核对被引用的内容实际能证明什么,并保留支撑它的案例;符号链接别名
   不算冗余副本。
5. **GitHub issue** —— 当报告 §7 写的是 possible 或 likely,或你的伙伴要求时。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jnmetacode/superpowers-zh/diagnosing-superpowers@sha256:6af901dddfcc91dc

The line at the top of this page pins the label v1.0.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_j2nvg4bmmctlavym.svg)](https://markdownregistry.com/a/art_j2nvg4bmmctlavym)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Sep 26, 2026.

versioncommittedcommitsizeaudit
v1.0.0 latest2026-09-26 40b0d4f 7,195 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (7195 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jnmetacode/superpowers-zh · 8,348 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_j2nvg4bmmctlavym
GET https://markdownregistry.com/api/v1/resolve?ref=jnmetacode/superpowers-zh/diagnosing-superpowers
GET https://markdownregistry.com/api/v1/blob/6af901dddfcc91dccbe2e9df5844d0835546017437c84a59593f9b1af80acf65

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jnmetacode/superpowers-zh

AGENTS.md AGENTS.md file
jnmetacode/superpowers-zh · AGENTS.md
git:20260510.a9e02b5 · audit B · 8,348 stars
CLAUDE.md CLAUDE.md file
jnmetacode/superpowers-zh · CLAUDE.md
git:20260907.3437ce2 · audit A · 8,348 stars
brainstorming SKILL.md skill
jnmetacode/superpowers-zh · skills/brainstorming/SKILL.md · 在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能、修改行为,或筹划任何新东西,无论是软件还是软件之外(一场分享、一门生意、一次装修)。
v1.0.0 · audit A · 8,348 stars
chinese-code-review SKILL.md skill
jnmetacode/superpowers-zh · skills/chinese-code-review/SKILL.md · 中文 review 沟通参考——话术模板、分级标注(必须修复/建议修改/仅供参考)、国内团队常见反模式应对。仅在用户显式 /chinese-code-review 时调用,不要根据上下文自动触发。
v1.0.0 · audit A · 8,348 stars
chinese-commit-conventions SKILL.md skill
jnmetacode/superpowers-zh · skills/chinese-commit-conventions/SKILL.md · 中文 commit 与 changelog 配置参考——Conventional Commits 中文适配、commitlint/husky/commitizen 中文模板、conventional-changelog…
v1.0.0 · audit A · 8,348 stars
chinese-documentation SKILL.md skill
jnmetacode/superpowers-zh · skills/chinese-documentation/SKILL.md · 中文文档排版参考——中英文空格、全半角标点、术语保留、链接格式、中文文案排版指北约定。仅在用户显式 /chinese-documentation 时调用,不要根据上下文自动触发。
v1.0.0 · audit A · 8,348 stars
chinese-git-workflow SKILL.md skill
jnmetacode/superpowers-zh · skills/chinese-git-workflow/SKILL.md · 国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow…
v1.0.0 · audit A · 8,348 stars
dispatching-parallel-agents SKILL.md skill
jnmetacode/superpowers-zh · skills/dispatching-parallel-agents/SKILL.md · 当面对 2 个以上可以独立进行、无共享状态或顺序依赖的任务时使用
v1.0.0 · audit A · 8,348 stars
executing-plans SKILL.md skill
jnmetacode/superpowers-zh · skills/executing-plans/SKILL.md · 当你要在当前会话里亲自担任实现者执行一份实现计划时使用——你的人类伙伴选择了内联执行,或者没有可用的子智能体工具
v1.0.0 · audit A · 8,348 stars
finishing-a-development-branch SKILL.md skill
jnmetacode/superpowers-zh · skills/finishing-a-development-branch/SKILL.md · 当实现完成、所有测试通过、需要决定如何集成这份工作时使用
v1.0.0 · audit A · 8,348 stars
mcp-builder SKILL.md skill
jnmetacode/superpowers-zh · skills/mcp-builder/SKILL.md · 在构建 MCP 服务器或 MCP 工具时使用 —— 系统化的生产级 MCP 构建方法论,覆盖工具设计、错误处理、传输层选择与测试,让 AI 助手连接外部能力
v1.0.0 · audit A · 8,348 stars
receiving-code-review SKILL.md skill
jnmetacode/superpowers-zh · skills/receiving-code-review/SKILL.md · 收到代码审查反馈后、实施建议之前使用,尤其当反馈不明确或技术上有疑问时——需要技术严谨性和验证,而非敷衍附和或盲目执行
v1.0.0 · audit A · 8,348 stars

Every file in jnmetacode/superpowers-zh

Other files named diagnosing-superpowers

diagnosing-superpowers SKILL.md skill
obra/superpowers · skills/diagnosing-superpowers/SKILL.md · Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans…
git:20260919.5bf4e78 · audit A · 302,424 stars
diagnosing-superpowers SKILL.md skill
aiskillstore/marketplace · pending/obra/diagnosing-superpowers/SKILL.md · Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans…
git:20260924.17dd4d9 · audit A · 439 stars
diagnosing-superpowers SKILL.md skill
osrim/ski · cli/testdata/benign-skills/superpowers/diagnosing-superpowers/SKILL.md · Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans…
git:20260927.e6d3d84 · audit A · 8 stars
diagnosing-superpowers SKILL.md skill
osrim/niksi · cli/testdata/benign-skills/superpowers/diagnosing-superpowers/SKILL.md · Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans…
git:20260927.e6d3d84 · audit A · 8 stars
diagnosing-superpowers SKILL.md skill
ddtcorex/maestro-skills · skills/diagnosing-superpowers/SKILL.md · Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans…
git:20260919.2c4bbac · audit A · 4 stars

Browse by kind, by grade A, or by owner.