asmspeak
디컴파일 코드를 처음 읽는 사람이 덜 막히도록 설명 주석과 요약을 붙여주는
CLI 기반 어셈블리 해설 도구를 정리하고 있습니다.
설명형 어셈블리 해설 도구
- Ghidra Headless와 LLM을 묶어 디컴파일 코드에 설명 주석과 함수 요약을 붙여주는 CLI 도구를 구상하고 있습니다.
- 처음 리버싱을 접하는 사람이 코드 해석에 덜 막히고, 익숙한 사람은 핵심 요약만 빠르게 보게 하는 흐름을 목표로 잡았습니다.
- 지금은 제품을 넓히기보다 입력, 설명 방식, 출력 포맷을 먼저 좁히는 단계입니다.
GhidraCLI주석 전략리버싱
지금 정리한 것
- Ghidra Headless에서 함수 디컴파일 결과를 가져와 CLI에서 바로 처리하는 기본 흐름
- junior, senior 모드로 설명 깊이를 나누는 방식
- 주석 C 파일과 함수 요약 Markdown을 출력하는 포맷
다음에 할 것
- 실제 바이너리 샘플을 기준으로 annotate, summarize 흐름을 더 좁혀볼 예정입니다.
- LLM 오답이나 과한 설명을 줄이는 주석 기준을 더 보강하려고 합니다.
- stage 분류, map 명령, 로컬 모델 연동 같은 확장 포인트를 작은 단위로 검토할 생각입니다.
업데이트 이력
2025-12-26
- 한국어 PRD 요약, 사용자 가이드, 개발자 가이드를 정리하고 CLI, LLM, report 모듈 초안을 함께 다듬었습니다.
2025-12-11
- CLI 워크플로우와 stage 개념을 정리하고, junior, senior 설명 모드와 주석 전략을 구체화했습니다.
2025-12-10
- PRD, 구현 계획, walkthrough를 먼저 잡고 Ghidra, CLI, report 중심의 초기 뼈대를 세웠습니다.