Community이미지github.com

trailofbits/secure-workflow-guide

Trail of Bits의 5단계 보안 개발 워크플로우를 안내합니다. Slither 스캔 실행, 특수 기능(업그레이드 가능성/ERC 규정 준수/토큰 통합) 확인, 시각적 보안 다이어그램 생성, 퍼징/검증을 위한 보안 속성 문서화 지원, 수동 보안 영역 검토를 수행합니다.

secure-workflow-guide란 무엇인가요?

이 스킬은 Trail of Bits가 정의한 5단계 보안 개발 워크플로우를 코드베이스에 적용할 수 있도록 안내합니다. 주로 Solidity 스마트 계약을 대상으로 하며, Slither 정적 분석 도구를 사용하여 취약점을 스캔하고, 업그레이드 가능성, ERC 규정 준수, 토큰 통합과 같은 특수 기능의 보안을 확인합니다. 또한, 시각적 보안 다이어그램을 생성하여 계약 간의 상호 작용과 데이터 흐름을 이해하기 쉽게 표현하고, 퍼징 및 형식 검증을 위한 보안 속성을 문서화하는 방법을 설명합니다. 추가로, 수동으로 검토해야 할 보안 영역을 식별하고 가이드하여 개발자가 보다 안전한 스마트 계약을 작성할 수 있도록 돕습니다. 이 스킬은 VS Code, Cursor, 또는 Claude Code와 같은 AI 코딩 에이전트 환경에서 실행되며, 사용자의 프로젝트 디렉토리에서 Solidity 파일을 분석하고 Slither의 결과를 해석합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/trailofbits/skills/tree/main/skills/secure-workflow-guide

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

secure-workflow-guide은(는) 무엇을 하나요?

Trail of Bits의 5단계 보안 개발 워크플로우를 안내합니다. Slither 스캔을 실행하고, 특수 기능(업그레이드 가능성/ERC 규정 준수/토큰 통합)을 확인하며, 시각적 보안 다이어그램을 생성하고, 퍼징/검증을 위한 보안 속성 문서화를 지원하며, 수동 보안 영역을 검토합니다.

1단계: 초기 Slither 스캔 실행

다음 명령어로 프로젝트에서 Slither를 실행합니다:

slither .

이 명령어는 모든 Solidity 파일에서 일반적인 취약점과 모범 사례 위반을 검사합니다.

2단계: 특수 기능 확인

다음 특수 기능을 확인합니다:

  • 업그레이드 가능성: 프록시 패턴 사용 시 저장소 충돌 위험 확인
  • ERC 규정 준수: ERC20/ERC721/ERC1155 표준 준수 여부 확인
  • 토큰 통합: 외부 토큰과의 상호 작용 시 안전성 확인

Slither의 프린터 모듈을 사용하여 관련 정보를 추출할 수 있습니다:

slither . --print human-summary

3단계: 시각적 보안 다이어그램 생성

다음 명령어로 계약 간 상속 및 호출 관계를 시각화합니다:

slither . --print inheritance-graph

이 정보를 바탕으로 계약 아키텍처 다이어그램을 생성합니다.

4단계: 보안 속성 문서화

퍼징 및 형식 검증을 위해 다음 속성을 문서화합니다:

  • require()/assert() 조건
  • 상태 변수 불변 조건
  • 함수 간 호출 순서 제약 조건
  • 시간 종속 조건 (블록 타임스탬프 등)

문서화된 속성은 .spec.md 파일에 저장하는 것이 좋습니다.

5단계: 수동 보안 영역 검토

다음 영역을 수동으로 검토해야 합니다:

  • 접근 제어 및 권한 관리
  • 외부 호출 재진입 위험
  • 가스 제한 관련 취약점
  • 오라클 조작 가능성

각 영역에 대해 발견된 위험과 권장 수정 사항을 문서화합니다.


이 워크플로우는 Trail of Bits의 보안 엔지니어링 방법론을 기반으로 합니다. 자세한 내용은 공식 문서를 참조하세요.

Individual skills in this repo

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

trailofbits/address-sanitizer

AddressSanitizer detects memory errors during fuzzing. Use when fuzzing C/C++ code to find buffer overflows and use-after-free bugs.

trailofbits/aflpp

AFL++ is a fork of AFL with better fuzzing performance and advanced features. Use for multi-core fuzzing of C/C++ projects.

trailofbits/agentic-actions-auditor

Audits GitHub Actions workflows for security vulnerabilities in AI agent integrations including Claude Code Action, Gemini CLI, OpenAI Codex, and GitHub AI Inference. Detects attack vectors where attacker-controlled input reaches AI agents running in CI/CD pipelines, including env var intermediary patterns, direct expression injection, dangerous sandbox configurations, and wildcard user allowlists. Use when reviewing workflow files that invoke AI coding agents, auditing CI/CD pipeline security for prompt injection risks, or evaluating agentic action configurations.

trailofbits/algorand-vulnerability-scanner

Scans Algorand smart contracts for 11 common vulnerabilities including rekeying attacks, unchecked transaction fees, missing field validations, and access control issues. Use when auditing Algorand projects (TEAL/PyTeal).

trailofbits/ask-questions-if-underspecified

Clarify requirements before implementing. Use when serious doubts arise.

trailofbits/atheris

Atheris is a coverage-guided Python fuzzer based on libFuzzer. Use for fuzzing pure Python code and Python C extensions.

trailofbits/audit-augmentation

Augments Trailmark code graphs with external audit findings from SARIF static analysis results and weAudit annotation files. Maps findings to graph nodes by file and line overlap, creates severity-based subgraphs, and enables cross-referencing findings with pre-analysis data (blast radius, taint, etc.). Use when projecting SARIF results onto a code graph, overlaying weAudit annotations, cross-referencing Semgrep or CodeQL findings with call graph data, or visualizing audit findings in the context of code structure.

trailofbits/audit-context-building

Enables ultra-granular, line-by-line code analysis to build deep architectural context before vulnerability or bug finding.

trailofbits/audit-prep-assistant

Prepares codebases for security review using Trail of Bits' checklist. Helps set review goals, runs static analysis tools, increases test coverage, removes dead code, ensures accessibility, and generates documentation (flowcharts, user stories, inline comments).

trailofbits/burpsuite-project-parser

Searches and explores Burp Suite project files (.burp) from the command line. Use when searching response headers or bodies with regex patterns, extracting security audit findings, dumping proxy history or site map data, or analyzing HTTP traffic captured in a Burp project.

trailofbits/cairo-vulnerability-scanner

Scans Cairo/StarkNet smart contracts for 6 critical vulnerabilities including felt252 arithmetic overflow, L1-L2 messaging issues, address conversion problems, and signature replay. Use when auditing StarkNet projects.

trailofbits/cargo-fuzz

cargo-fuzz is the de facto fuzzing tool for Rust projects using Cargo. Use for fuzzing Rust code with libFuzzer backend.

trailofbits/chrome-mcp-troubleshooting

Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.

trailofbits/claude-in-chrome-troubleshooting

Diagnose and fix Claude in Chrome MCP extension connectivity issues. Use when mcp__claude-in-chrome__* tools fail, return "Browser extension is not connected", or behave erratically.

trailofbits/code-improver

Runs an autonomous review-and-fix improvement loop over any code target — a skill, plugin, module, or directory — using a reviewer the user names: any installed skill or agent. Keeps a cross-round findings ledger, escalates when fixes stop converging, and guards scope mechanically. Use when asked to 'improve this code until review passes', 'run an improvement loop with <reviewer>', or to iterate review-and-fix with a specific reviewer. For skills prefer the skill-improver entry; for a branch prefer pr-improver.

trailofbits/code-maturity-assessor

Systematic code maturity assessment using Trail of Bits' 9-category framework. Analyzes codebase for arithmetic safety, auditing practices, access controls, complexity, decentralization, documentation, MEV risks, low-level code, and testing. Produces professional scorecard with evidence-based ratings and actionable recommendations.

trailofbits/codeql

Scans a codebase for security vulnerabilities using CodeQL's interprocedural data flow and taint tracking analysis. Triggers on "run codeql", "codeql scan", "codeql analysis", "build codeql database", or "find vulnerabilities with codeql". Supports "run all" (security-and-quality + security-experimental suites) and "important only" (high-precision security findings) scan modes. Also handles creating data extension models and processing CodeQL SARIF output.

trailofbits/constant-time-analysis

Detects timing side-channel vulnerabilities in cryptographic code. Use when implementing or reviewing crypto code, encountering division on secrets, secret-dependent branches, or constant-time programming questions in C, C++, Go, Rust, Swift, Java, Kotlin, C#, PHP, JavaScript, TypeScript, Python, or Ruby.

trailofbits/constant-time-testing

Constant-time testing detects timing side channels in cryptographic code. Use when auditing crypto implementations for timing vulnerabilities.

trailofbits/cosmos-vulnerability-scanner

Scans Cosmos SDK blockchain modules and CosmWasm contracts for consensus-critical vulnerabilities — chain halts, fund loss, state divergence. 25 core + 16 IBC + 10 EVM + 3 CosmWasm patterns. Use when auditing custom x/ modules, reviewing IBC integrations, or assessing pre-launch chain security. Updated for SDK v0.53.x.

관련 스킬