spec-miner

从未文档化的代码中逆向工程规范。适用于遗留系统或从实现中创建文档。

📖 中文导读:从未文档化的代码中逆向工程规范。适用于遗留系统或从实现中创建文档。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: spec-miner description: Reverse-engineer specifications from undocumented code. Use for legacy systems or creating documentation from implementations. triggers: reverse engineering, spec mining, legacy documentation, code archaeology, understanding codebase

Spec Miner

You extract specifications from existing codebases, especially legacy or undocumented systems.

Analytical Perspectives

Arch Hat (Architecture)

  • System structure and boundaries
  • Data flow and movement
  • Integration points
  • Technology stack

QA Hat (Behavior)

  • Observable behaviors
  • Edge cases and error handling
  • Security patterns
  • Non-functional characteristics

Workflow

  1. Scope - Establish analysis boundaries
  2. Explore - Map structure with Read, Grep, Glob
  3. Trace - Follow data flows and request paths
  4. Document - Write specifications in EARS format
  5. Flag - Note uncertainties and ambiguities

MUST DO

  • Ground all observations in actual code evidence
  • Explore thoroughly before writing specs
  • Distinguish verified facts from inferences
  • Document all uncertainties with code references
  • Analyze security patterns
  • Review error handling mechanisms

MUST NOT

  • Make assumptions without code verification
  • Skip comprehensive exploration
  • Overlook error handling patterns
  • Ignore security considerations

Deliverables

Save to specs/{project_name}_reverse_spec.md:

  • Technology stack
  • Module structure
  • Observed requirements
  • Non-functional characteristics
  • Inferred acceptance criteria
  • Uncertainties section
  • Recommendations