使用 diagnosing-superpowers 分析会话作业日志
機械翻訳 / Machine-translated

機械翻訳 / Machine-translated
原文链接:使用 diagnosing-superpowers 分析会话作业日志(cccskills)
技能页面:diagnosing-superpowers
本文结论
diagnosing-superpowers 是一款面向 superpowers 用户的技能,适用于担心作业重复、计划偏离、时间或 Token 消耗过多的情况。
它能将会话记录整理成附有行号的报告。
本文将介绍可分析的 7 个维度、安装方法及请求示例,同时附上用于缺陷报告时的注意事项。
安装 diagnosing-superpowers 后,即可以报告形式收到使用 superpowers 的会话经过。
报告中附有记录文件的行号。
例如,可以这样请求:
请从记录中查明刚才的会话中反复执行同一测试的原因
Agent 不会立即开始分析,而是逐一提问。
确认的内容包括四点:目标会话、期望结果、实际发生的情况,以及关注的指标。
指标是指经过时间、Token、重复操作等内容。
问题确定后,Agent 会以绝对路径定位会话记录文件。
若为历史会话,则引用最初的请求内容和时间戳来确认目标。
被排除的候选项也会附上理由一并说明。
随后,Agent 会创建工作文件夹并告知其路径:
~/.superpowers/diagnosing-superpowers/<会话ID>/
分析分为 7 个维度,各由一个子 Agent(并行运行的辅助 Agent)负责。
报告会写入该文件夹,同时在屏幕上显示。
所有指摘均附有"文件路径:行号",无依据行的指摘不会出现在报告中。
使用本技能,可从 7 个维度梳理进展不顺的会话,并附证据确认发生了什么。
各维度及分析内容如下:
| 维度 | 分析内容 |
|---|---|
| 技能使用情况 | 哪些技能在何时被调用或未被调用 |
| 计划执行情况 | 作业是否按照既定计划推进 |
| 作业重复情况 | 是否重复执行了相同的作业 |
| 卡点情况 | 作业卡住的位置 |
| 质量与依据 | 结果质量及支撑记录 |
| 与请求的冲突 | 与用户请求不符的行为 |
| 时间与消耗 | 经过时间与 Token 消耗 |
7 项分析每次全部执行。
根据不满的表达方式不同,变化的是 Agent 最初自行阅读的部分,以及结论中优先展示的维度。
| 不满示例 | 优先展示的维度 |
|---|---|
| 花时间太长 | 时间与消耗、卡点情况 |
| 为何做了多余的作业 | 作业重复情况、计划执行情况 |
| 为何花费这么多 | 时间与消耗 |
| 执行过程中不知道在做什么 | 技能使用情况(同时注明正在执行中) |
| 计划被忽略 | 计划执行情况(从对话压缩发生的行开始确认) |
| 某个技能未正常运行 | 技能使用情况 |
数字处理严格也是本技能的特点。
Token 数量和时间均取自记录或 Agent 执行命令的结果,不以记忆或一般单价补充。
分析对象不限于当前会话,也可针对通过 ID 或路径指定的历史会话及子 Agent 的记录。
安装方式有两种:通过命令安装或请求 Agent 安装。
使用命令时,请执行以下内容。
执行后可从 Claude Code、Codex 等选项中选择目标 Agent。
npx skills add https://github.com/obra/superpowers --skill diagnosing-superpowers
请求 Agent 安装时,请直接发送以下内容。
Agent 会先确认文件内容,再进行部署。
请安装以下 Agent Skill。
https://github.com/obra/superpowers/tree/main/skills/diagnosing-superpowers
请先确认 SKILL.md 及附属文件的内容,确认不存在可疑操作(如向外部发送数据、读取认证信息等),然后将其部署到 Claude Code 对应的 ~/.claude/skills/diagnosing-superpowers/,或 Codex 对应的 ~/.agents/skills/diagnosing-superpowers/ 目录下。
安装位置如下表所示。
若希望在所有项目中使用,请选择用户级;若仅用于特定项目,请选择项目级。
| Agent | 用户级 | 项目级 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
发布来源为 obra/superpowers。
本技能仅读取使用 superpowers 的会话记录,因此前提是待分析的会话中已使用 superpowers。
请求内容越清晰地注明目标会话和关注点,分析进展越快。
目标和分析内容明确的请求,本身即被视为问题说明。
请以时间和 Token 消耗为重点,查明昨天的会话(ID: ○○)比预期花费更长时间的原因
返回的报告以时间与消耗、卡点指摘为首要内容。
时间和 Token 数字均附有取自记录中哪一行的说明。
请根据记录,报告本次会话中 brainstorming 技能未被调用的经过
此情况下的报告以技能使用情况为主,附行号说明各技能在何时被调用的经过。
请根据报告,起草提交至 superpowers GitHub 的 issue 文案
Agent 会首先在已有的开放和已关闭 issue 中查找类似症状。
若存在相似 issue,会建议追加评论;若不存在,则起草文案并完整展示。
提交前需获得用户确认。
此外,还可创建包含会话记录的共享数据包(bundle),用于缺陷报告。
bundle 仅在明确请求时才会创建,包含范围可从以下三个级别中选择:
| 级别 | 包含内容 |
|---|---|
| skeleton | 不包含工具执行结果的正文 |
| evidence | 仅包含报告中引用部分的正文 |
| full | 包含全部内容 |
最重要的一点是:本技能不会断定原因,也不提供修复方案。
报告仅说明 superpowers 是否与事件相关,不会点名指出技能缺陷或建议变更。
即使强烈要求修复,这一界限也不会改变。
其他需确认的事项如下:
即使经过脱敏处理,也可能存在遗漏。
共享前,请务必自行检查 bundle 中的所有文件。
对于报告内容,也建议以行号为线索打开原始记录,自行核实引用内容。
许可证为 MIT。
安装前请确认 SKILL.md 及附属文件中是否存在向外部发送数据等可疑操作。
以下介绍同属 obra/superpowers、负责本技能分析对象作业本身的技能。
executing-plans 是在同一会话中按任务执行既有实现计划的技能。
若感觉偏离了计划,可用 diagnosing-superpowers 回顾通过该技能推进的会话。
subagent-driven-development 是将计划任务委托给其他 Agent 推进的技能。
由于子 Agent 的记录也是分析对象,可与本技能结合使用,核实作业重复情况和时间消耗。
本技能专为使用 superpowers 的会话进展不顺时设计。
报告结构也是围绕 superpowers 的关联程度进行说明。
不适用于与 superpowers 无关的作业回顾。
不会。
记录文件仅供读取,规定不进行修改、移动或删除。
报告等成果物会写入专用工作文件夹。
不会自动提交。
Agent 会展示 issue 全文,获得用户批准后再创建。
也不会在存在占位符的情况下提交。
不会。
报告范围仅限于从记录中确认到的事件,定位技能缺陷或提出变更建议不在范围之内。
是否修改 superpowers,由接收 issue 和 bundle 并进行分类的一方决定。
diagnosing-superpowers 是一款将 superpowers 会话经过整理成附行号报告的技能。
可凭记录核实作业重复、计划偏离、时间和 Token 消耗情况,也可用于准备缺陷报告。
但提交和共享数据的创建均需经过用户确认后推进。
详细信息请参阅 cccskills 页面。
本文转载自 cccskills 的文章「使用 diagnosing-superpowers 分析会话作业日志」。
技能详情及安装方法请参见 cccskills 的 diagnosing-superpowers 页面。