Communitygithub.com

revisión-de-caso

Revisa un paquete de caso de habilidad inversa para verificar la preparación del alcance, la trazabilidad de Evidencia a Hallazgo a Ruta, la cobertura de elementos de trabajo, las referencias de la línea de tiempo y la integridad opcional del hash del artefacto antes de la entrega del informe.

¿Qué es revisión-de-caso?

Esta habilidad, diseñada para agentes de IA como Claude Code, Cursor o Codex, automatiza la revisión de paquetes de casos generados por habilidades de ingeniería inversa, forense digital, CTF o seguridad autorizada. Su propósito principal es auditar de forma solo lectura la estructura y consistencia de un caso en `work/<case>/`, asegurando que el alcance, la evidencia, los hallazgos, las rutas y los elementos de trabajo estén correctamente documentados y trazables antes de la entrega del informe. La revisión verifica la existencia de archivos clave como `scope.md` y `timeline.md`, valida que todos los hallazgos tengan IDs de evidencia existentes, que las rutas tengan tipos y referencias correctas, y que no haya evidencia huérfana. Opcionalmente, puede verificar la integridad de los artefactos locales mediante SHA-256. La habilidad no realiza ninguna acción ofensiva ni modifica el caso; su salida puede ser en formato Markdown o JSON, y puede ejecutarse en modo estricto que trata las advertencias como bloqueantes para la entrega. Utiliza únicamente la biblioteca estándar de Python 3, sin dependencias de terceros ni acceso a red, lo que la hace segura y autónoma.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zhaoxuya520/reverse-skill/tree/main/skills/case-review

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Revisión del Grafo de Evidencia

Utilice esta habilidad cuando un caso de ingeniería inversa, análisis forense, CTF o seguridad autorizada necesite una entrega defendible. Audita el paquete existente work/<case>/ sin modificar el caso ni tocar un objetivo.

Alcance

Esta habilidad cubre:

  • Metadatos de alcance y preparación para la actividad objetivo
  • Estructura de registros de evidencia y campos de reproducibilidad
  • Referencias desde elementos de trabajo y entradas de la línea de tiempo a la Evidencia
  • Hallazgos y Rutas estructurados en el informe Markdown
  • Verificación opcional SHA-256 para artefactos locales del caso
  • Un resultado de revisión en Markdown o JSON para la entrega de un informe

NO DEBE realizar reconocimiento, explotación, instrumentación dinámica o cambios en el objetivo. Esas acciones pertenecen a la habilidad de análisis enrutada y requieren la compuerta de alcance del caso.

ACCIÓN REQUERIDA

  1. AHORA: lea ../field-journal/precedent-reverse.md y confirme que se trata de una revisión de un paquete de caso autorizado existente.
  2. AHORA: confirme la ruta del caso y elija el modo de revisión de solo lectura.
  3. DESPUÉS: lea ../tool-index.md; esta habilidad utiliza únicamente la biblioteca estándar de Python 3 y no requiere arranque.
  4. DESPUÉS: ejecute python3 scripts/review_case.py <raíz-del-caso> --format markdown.
  5. ACTUAR: resuelva cada error, luego vuelva a ejecutar la revisión antes de afirmar que una entrega está completa.

Dependencias de herramientas

HerramientaRequeridaPropósitoAuto-arranque
Python 3.9+SíEjecuta el script de revisión de caso de solo lecturaNo, use la instalación de Python de la plataforma

No se requiere acceso a red ni paquetes de terceros.

Flujo de trabajo

Fase 1: Ingreso

Ejecute la revisión contra el directorio del caso existente:

python3 skills/case-review/scripts/review_case.py work/<caso> --format markdown

Confirme que scope.md, timeline.md, workitems.md y evidence/ están presentes. Una revisión no estricta reporta advertencias de alcance, mientras que una revisión estricta trata las advertencias como bloqueadores de la entrega.

建议下一步(选一个编号)

  1. 修复 scope.md 中的授权、范围或 network_profile 字段
  2. 继续检查 Evidence 记录的可复现命令和来源
  3. 导出当前 review 结果并附到阶段性报告
  4. 换 JSON 输出接入 CI 或其他审查工具
  5. 暂停,先确认审查范围

Fase 2: Trazabilidad

Revise las verificaciones para:

  • IDs de Evidencia que no existen
  • Hallazgos sin evidence_ids
  • Rutas sin un path_type permitido o referencia a Evidencia
  • Elementos de trabajo y entradas de la línea de tiempo que apuntan a Evidencia desconocida
  • Registros de Evidencia no vinculados
  • Hallazgos validados con baja confianza

Una observación fuera de línea puede usar repro_command: n/a solo cuando su campo notes documente explícitamente la limitación fuera de línea.

Use JSON cuando otra herramienta necesite campos estables:

python3 skills/case-review/scripts/review_case.py work/<caso> --format json

建议下一步(选一个编号)

  1. 补写缺失的 Evidence,并保留原始命令
  2. 将候选 Finding 绑定到 Evidence 后重新审查
  3. 为调用链或攻击链补充 P-id 和 Path 步骤
  4. 生成 Markdown handoff summary
  5. 换回 PRIMARY skill 继续分析

Fase 3: Verificación de fijación

Cuando un registro de Evidencia contenga tanto content_hash como artifact_path, verifique el artefacto local del caso:

python3 skills/case-review/scripts/review_case.py work/<caso> --verify-hashes --strict

El script acepta sha256:<64 caracteres hexadecimales> y comprueba que el artefacto permanece dentro de la raíz del caso. Una discrepancia de hash es un fallo grave.

El ayudante de Evidencia de PowerShell puede registrar un hash mientras agrega un registro:

powershell -File skills/scripts/append-evidence.ps1 -CaseRoot work\<caso> -Id E-001 -Title "Hash de ejemplo" -ReproCommand "sha256sum evidence/sample.bin" -ArtifactPath "evidence\sample.bin"

建议下一步(选一个编号)

  1. 修复 hash mismatch 或替换已污染的工作副本
  2. 为未固定的原始文件补充 SHA-256 和 artifact_path
  3. 继续进入报告生成阶段
  4. 导出 JSON 结果供 CI 保存
  5. 暂停并请求人工复核

Fase 4: Entrega

Use el modo estricto antes de un informe final o una entrega a un especialista:

python3 skills/case-review/scripts/review_case.py work/<caso> --strict --format markdown > work/<caso>/report/case-review.md

El comando es de solo lectura con respecto al caso a menos que se use explícitamente una redirección de shell para guardar su salida. La revisión no es asesoramiento legal y no reemplaza los procedimientos organizativos de manejo de evidencia.

建议下一步(选一个编号)

  1. 将通过的 review 结果交给 docs-generator/ 生成正式报告
  2. 回到 PRIMARY skill 补齐新的分析证据
  3. 归档 Markdown 和 JSON review 结果
  4. 暂停并请求人工复核

Contrato de comportamiento lingüístico

  • Razonamiento interno, selección de herramientas y control de fase: Inglés.
  • Mensajes visibles para el usuario, etiquetas de sección, informes y menús de siguiente paso: Chino a menos que el usuario solicite otro idioma.
  • Las etiquetas bilingües predeterminadas colocan el chino primero y el inglés segundo, separados por "/".

Límite de arranque

Esta habilidad no tiene dependencia de terceros. Si Python 3 no está disponible, la única acción de recuperación permitida es la ruta de arranque del repositorio cuando una capacidad de Python está registrada para la plataforma actual. Si no hay tal capacidad registrada, deténgase e informe la falta de tiempo de ejecución. No adivine rutas de ejecutables, descargue paquetes ni realice una instalación manual desde dentro de esta habilidad.

Contexto de enrutamiento

Entrada ascendente: cualquier habilidad de ingeniería inversa, forense, CTF o seguridad autorizada que haya producido un paquete de caso.

Salida descendente: docs-generator/ para un informe formal, o la habilidad PRIMARY original cuando el grafo está incompleto.

Módulos relacionados: ops/evidence-finding-path.md, ops/timeline-workitem.md, digital-forensics/, reverse-engineering/ y docs-generator/.

Referencias

任务完成自检

  • 我是否审查了 scope.md、timeline.md、workitems.md 和 evidence/?
  • 所有 Finding 是否引用了现存 Evidence?
  • 所有 Path 是否包含合法 path_type 和 Evidence 引用?
  • 是否执行了 hash verification,或记录了未执行原因?
  • 是否以 strict 模式重新运行并保存了 review 结果?

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

api-security

Use for authorized security assessment of REST, GraphQL, WebSocket, or SOAP APIs, including discovery, authentication, authorization, rate-limit, and CI/CD testing.

apk-reverse

在 CLI 环境下做 Android APK 逆向时使用。适用于 APK 解包、Java 反编译、smali 修改、重打包、Frida 动态 Hook,以及按需切换到 so/native 分析。优先使用本机已安装的 jadx、apktool、frida、adb、ida-reverse、radare2。

attack-chain

Use for authorized multi-stage attack-path planning and orchestration when a task spans reconnaissance, initial access, privilege escalation, lateral movement, or impact assessment. Route single-stage tasks directly to their specialist skill.

binary-diff

|

binary-ninja-reverse

Use for authorized binary analysis in Binary Ninja, including HLIL/MLIL/LLIL inspection, strings/imports/exports, cross-references, types, patch review, Python API automation, and optional Binary Ninja MCP or localhost HTTP integration.

browser-automation

|

browser-extension-reverse

Use for authorized reverse engineering of browser extensions (Chrome/Firefox) including manifest analysis, background workers, and extension-based credential or traffic logic recovery.

cloud-k8s

Use for authorized cloud, container, and Kubernetes security assessment including metadata SSRF, IAM misconfig, container escape paths, and cluster RBAC review.

code-audit

Use for authorized source-code security review and SAST workflows including Semgrep, CodeQL patterns, dangerous API hunting, and fix verification.

ctf-sandbox

Thin PRIMARY for CTF / AWD / 靶场 multi-type orchestration. Hands off to the sidecar CTF-Sandbox-Orchestrator. Use when the user says CTF, AWD, 靶场, or 比赛题 and no more specific pwn/APK/IDA route already won.

database-security

Use for authorized database security assessment covering PostgreSQL/MySQL/MSSQL/Mongo/Redis exposure, authz, UDF/command paths, and misconfiguration review.

diagram-generator

generate, refine, validate, and render diagrams from natural language, notes, code snippets, schemas, tables, or existing diagram source. use for flowcharts, swimlanes, sequence diagrams, state diagrams, er diagrams, class diagrams, architecture/c4-style diagrams, dependency graphs, gantt charts, mind maps, user journeys, sankey-style flows, org charts, network graphs, and other visual models. supports mermaid by default, graphviz dot for complex graph layout, plantuml for uml-heavy engineering diagrams, and svg output when direct markup is more reliable.

digital-forensics

Use for authorized digital forensics including memory dumps, disk timelines, PCAP investigation, artifact triage, and IR evidence preservation.

docs-generator

|

dotnet-reverse

.NET / C# 二进制逆向。当目标是 .NET assembly(PE 头含 CLR、.exe/.dll 托管程序)、C# 编译产物(含 NativeAOT)、红队 Sharp* 工具(Rubeus / SharpHound / SharpHound 等)、.NET 混淆程序(ConfuserEx / SmartAssembly / Babel / Eazfuscator)、.NET loader / info-stealer / 套壳 malware 时使用。优先用 dnSpyEx + de4dot,需要 AI 直接操作时联动 dnSpy MCP。不用于纯 native 二进制(走 reverse-engineering / ida-reverse)。

edr-bypass-re

|

email-security

Use for authorized email security review including phishing analysis, header authentication (SPF/DKIM/DMARC), BEC patterns, and mailbox token abuse research.

firmware-pentest

|

ghidra-reverse

Use for free/open reverse engineering with Ghidra (headless or GUI), including decompile, cross-refs, and optional Ghidra MCP workflows when IDA is unavailable.

go-rust-reverse

Use for reverse engineering stripped Go and Rust binaries including runtime recognition, pclntab/moduel data recovery, panic strings, and idiomatic decompilation recovery.

Skills relacionados