فهرست منبع

docs: add 'When Something Goes Wrong' README section for diagnosing-superpowers

Jesse Vincent 1 هفته پیش
والد
کامیت
0c59ebc9c6
1فایلهای تغییر یافته به همراه7 افزوده شده و 0 حذف شده
  1. 7 0
      README.md

+ 7 - 0
README.md

@@ -22,6 +22,7 @@ Superpowers is a complete software development methodology for your coding agent
   - [Pi](#pi)
   - [Pi](#pi)
   - [Hermes Agent](#hermes-agent)
   - [Hermes Agent](#hermes-agent)
 - [The Basic Workflow](#the-basic-workflow)
 - [The Basic Workflow](#the-basic-workflow)
+- [When Something Goes Wrong](#when-something-goes-wrong)
 - [Community](#community)
 - [Community](#community)
 - [What's Inside](#whats-inside)
 - [What's Inside](#whats-inside)
 - [Philosophy](#philosophy)
 - [Philosophy](#philosophy)
@@ -276,6 +277,12 @@ turn loses the bootstrap — start a fresh session if skills stop triggering.
 
 
 **The agent checks for relevant skills before any task.** Mandatory workflows, not suggestions.
 **The agent checks for relevant skills before any task.** Mandatory workflows, not suggestions.
 
 
+## When Something Goes Wrong
+
+Sometimes a session misbehaves: a skill fires when it shouldn't, stays silent when it should, or the agent ignores its plan, repeats work, or burns more tokens than you'd expect. Ask your coding agent to "figure out what went wrong with superpowers in this session" and it will invoke the **diagnosing-superpowers** skill. To examine an earlier session, name it: "figure out what went wrong with superpowers in session `<id>`".
+
+The skill reads the session transcript, reports what happened with line-level evidence, and, if you want, packages a scrubbed bundle for a bug report.
+
 ## Community
 ## Community
 
 
 Superpowers is built by [Jesse Vincent](https://blog.fsck.com) and the rest of the folks at [Prime Radiant](https://primeradiant.com).
 Superpowers is built by [Jesse Vincent](https://blog.fsck.com) and the rest of the folks at [Prime Radiant](https://primeradiant.com).