diagnosing-superpowers로 세션 작업 로그 분석하기
機械翻訳 / Machine-translated

機械翻訳 / Machine-translated
원문: diagnosing-superpowers로 세션 작업 로그 분석하기(cccskills)
스킬 페이지: diagnosing-superpowers
이 글의 결론
superpowers를 사용하면서 작업 중복이나 계획 이탈, 시간·토큰 과다 소비가 신경 쓰이는 분을 위한 스킬이 diagnosing-superpowers입니다.
세션 기록을 행 번호가 포함된 보고서로 정리할 수 있습니다.
이 글에서는 분석 가능한 7가지 관점과 설치 방법, 요청문 예시를 소개합니다.
버그 보고에 사용할 때의 주의 사항도 함께 다루었습니다.
diagnosing-superpowers를 도입하면 superpowers를 사용한 세션의 경위를 보고서로 받을 수 있습니다.
보고서에는 기록 파일의 행 번호가 포함되는 구조입니다.
예를 들어 다음과 같이 요청합니다.
방금 세션에서 같은 테스트를 여러 번 다시 실행한 이유를 기록에서 조사해 주세요
에이전트는 바로 분석을 시작하지 않고 질문을 하나씩 되돌아옵니다.
확인하는 내용은 대상 세션, 기대했던 결과, 실제로 일어난 일, 신경 쓰이는 지표 4가지입니다.
지표란 경과 시간이나 토큰, 반복된 작업 등을 말합니다.
문제가 명확해지면 에이전트는 세션 기록 파일을 절대 경로로 특정합니다.
과거 세션의 경우 최초 요청문과 타임스탬프를 인용해 대상을 확인합니다.
후보에서 제외한 항목도 이유를 첨부하여 표시하는 규칙입니다.
이어서 작업용 폴더를 만들고 그 경로를 알려옵니다.
~/.superpowers/diagnosing-superpowers/<세션ID>/
분석은 7가지 관점으로 나뉘며, 각각을 서브에이전트(병렬로 동작하는 보조 에이전트)가 담당하는 구조입니다.
보고서는 이 폴더에 출력되며 화면에도 표시됩니다.
지적 사항에는 모두 "파일 경로:행 번호"가 첨부되며, 근거 행이 없는 지적은 보고에서 제외됩니다.
이 스킬을 사용하면 잘 풀리지 않았던 세션을 7가지 관점으로 분석하여 무슨 일이 있었는지 증거와 함께 확인할 수 있습니다.
관점과 조사 내용은 다음과 같습니다.
| 관점 | 조사 내용 |
|---|---|
| 스킬 사용 현황 | 어떤 스킬이 언제 사용되었는지, 사용되지 않았는지 |
| 계획 준수 여부 | 작성한 계획대로 작업이 진행되었는지 |
| 작업 중복 | 같은 작업을 반복하지 않았는지 |
| 걸림돌 | 작업이 막힌 지점 |
| 품질과 근거 | 결과의 품질과 이를 뒷받침하는 기록 |
| 요청과의 충돌 | 사용자의 요청과 어긋나는 동작 |
| 시간과 소비량 | 경과 시간과 토큰 소비 |
7가지 분석은 매번 모두 실행됩니다.
불만을 표현하는 방식에 따라 달라지는 것은 에이전트가 처음에 직접 읽는 부분과, 결론에서 먼저 제시하는 관점입니다.
| 불만 예시 | 먼저 제시하는 관점 |
|---|---|
| 시간이 너무 걸렸다 | 시간과 소비량, 걸림돌 |
| 왜 불필요한 작업을 했는가 | 작업 중복, 계획 준수 여부 |
| 왜 이렇게 비용이 많이 드는가 | 시간과 소비량 |
| 실행 중에 무엇을 하는지 모르겠다 | 스킬 사용 현황(실행 중임도 기재) |
| 계획을 무시당했다 | 계획 준수 여부(대화 압축이 발생한 행부터 확인) |
| 특정 스킬이 작동하지 않았다 | 스킬 사용 현황 |
수치 처리가 엄격한 점도 특징입니다.
토큰 수나 시간은 모두 기록이나 에이전트가 실행한 명령의 결과에서 가져옵니다.
기억이나 일반적인 단가로 보완하지 않습니다.
분석 대상은 현재 세션에 한정되지 않습니다.
ID나 경로로 지정한 과거 세션이나 서브에이전트 기록도 대상이 됩니다.
설치는 명령어로 직접 하는 방법과 에이전트에게 요청하는 방법, 두 가지입니다.
명령어를 사용하는 경우 다음을 실행하세요.
설치 대상 에이전트는 실행 후 Claude Code나 Codex 등에서 선택할 수 있습니다.
npx skills add https://github.com/obra/superpowers --skill diagnosing-superpowers
에이전트에게 요청하는 경우 다음 문장을 그대로 전송하세요.
내용 확인을 먼저 마친 후 배치하는 흐름입니다.
次の 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/ に配置してください。
저장 위치는 다음 표와 같습니다.
모든 프로젝트에서 사용하려면 사용자 단위로, 특정 프로젝트에서만 사용하려면 프로젝트 단위로 저장합니다.
| 에이전트 | 사용자 단위 | 프로젝트 단위 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
배포처는 obra/superpowers입니다.
이 스킬이 읽는 것은 superpowers를 사용한 세션의 기록뿐이므로, 분석하고 싶은 세션에서 superpowers를 사용했을 것이 전제 조건입니다.
요청은 대상 세션과 신경 쓰이는 점을 명확히 적을수록 빠르게 진행됩니다.
대상과 조사 내용이 정해진 요청은 그 자체가 문제 설명으로 처리되기 때문입니다.
어제 세션(ID: ○○)이 예상보다 오래 걸린 이유를 시간과 토큰 소비를 중심으로 조사해 주세요
반환되는 것은 시간과 소비량, 걸림돌 지적을 맨 앞에 배치한 보고서입니다.
시간이나 토큰 수치에는 기록의 어느 행에서 가져왔는지가 첨부됩니다.
이 세션에서 brainstorming 스킬이 사용되지 않은 경위를 기록에 근거하여 보고해 주세요
이 경우의 보고서는 스킬 사용 현황이 중심입니다.
어느 시점에 어떤 스킬이 사용되었는지의 경과가 행 번호와 함께 제시됩니다.
보고서를 바탕으로 superpowers GitHub 이슈 문안을 작성해 주세요
에이전트는 먼저 공개 중인 이슈와 종료된 이슈에서 유사한 증상을 찾습니다.
비슷한 것이 있으면 해당 이슈에 추가 댓글을 제안하고, 없으면 문안을 작성하여 전문을 보여줍니다.
게시는 승인을 받은 후에 합니다.
버그 보고용으로 세션 기록을 정리한 공유용 데이터(번들)도 만들 수 있습니다.
번들은 요청했을 때만 만들어집니다.
포함 범위는 다음 3단계에서 선택할 수 있습니다.
| 단계 | 포함되는 내용 |
|---|---|
| skeleton | 도구 실행 결과 본문을 포함하지 않음 |
| evidence | 보고에서 인용한 부분만 본문을 포함 |
| full | 모두 포함 |
가장 중요한 것은 이 스킬이 원인을 단정 짓지 않고 수정안도 제시하지 않는다는 점입니다.
보고서가 서술하는 것은 superpowers가 관여했는지 여부까지입니다.
스킬의 결함을 지목하거나 변경을 제안하지는 않습니다.
수정을 강하게 요구해도 이 선은 바뀌지 않는 규칙입니다.
그 외 확인해 두고 싶은 점은 다음과 같습니다.
스크러빙을 거쳐도 정보가 남아 있을 수 있습니다.
공유하기 전에 번들의 모든 파일을 직접 확인하세요.
보고서에 대해서도 행 번호를 단서로 원래 기록을 열어 인용된 내용을 직접 확인하면 확실합니다.
라이선스는 MIT입니다.
설치하기 전에 SKILL.md와 첨부 파일에 외부 전송 등 수상한 처리가 없는지 확인하세요.
같은 obra/superpowers 스킬 중 분석 대상이 되는 작업 자체를 담당하는 것들을 소개합니다.
executing-plans는 작성된 구현 계획을 같은 세션에서 태스크별로 실행하는 스킬입니다.
계획에서 벗어났다고 느꼈을 때, 이 스킬로 진행한 세션을 diagnosing-superpowers로 되돌아보는 흐름이 됩니다.
subagent-driven-development는 계획의 태스크를 다른 에이전트에게 맡겨 진행하는 스킬입니다.
서브에이전트의 기록도 분석 대상이 되므로, 작업 중복이나 시간 사용 방식을 확인할 때 조합해 사용할 수 있습니다.
이 스킬은 superpowers를 사용한 세션이 잘 풀리지 않았을 때를 위한 것입니다.
보고서도 superpowers의 관여 여부를 서술하는 구성으로 되어 있습니다.
superpowers와 관계없는 작업의 회고에는 적합하지 않습니다.
없습니다.
기록 파일은 읽기만 하며, 변경·이동·삭제는 하지 않는 규칙입니다.
보고서 등의 산출물은 전용 작업 폴더에 출력됩니다.
자동으로 게시되지 않습니다.
에이전트가 이슈 전문을 보여주고 승인을 받은 후 작성합니다.
플레이스홀더가 남아 있는 문안으로 게시하는 일도 없습니다.
알려주지 않습니다.
보고하는 것은 기록에서 확인된 사실까지이며, 스킬의 결함 특정이나 변경 제안은 범위 밖입니다.
superpowers를 변경할지 여부는 이슈와 번들을 받아 분류하는 쪽이 판단합니다.
diagnosing-superpowers는 superpowers를 사용한 세션의 경위를 행 번호가 포함된 보고서로 정리하는 스킬입니다.
작업 중복이나 계획 이탈, 시간·토큰 소비를 기록에서 확인할 수 있으며 버그 보고 준비에도 활용할 수 있습니다.
단, 게시와 공유용 데이터 작성은 승인을 거쳐 진행하는 구조입니다.
자세한 정보는 cccskills 페이지에서 확인할 수 있습니다.
이 글은 cccskills의 읽을거리 「diagnosing-superpowers로 세션 작업 로그 분석하기」의 전재입니다.
스킬의 상세 내용과 설치 방법은 cccskills의 diagnosing-superpowers 페이지에 있습니다.