Code

Codebase Debugging Skill

This skill grants the agent the ability to inspect the target software's source code and perform white-box debugging via temporary code injection.

🛠 Tools

• code_list_files: Discover the structure of the environment codebase.
• code_read_file: Read source code to understand logic or identify bugs.
• code_search: Search for keywords or patterns across the entire codebase.
• code_write_file: Inject print() statements or temporary fixes to diagnose complex issues.
• code_restore_file: Revert any modifications made during debugging.

📖 Best Practices

1. Prefer read-only actions first: Start with code_list_files, code_read_file, or code_search to find relevant handlers before modifying files.
2. Safe Debugging: Before using code_write_file, ensure you have a plan to use code_restore_file.
3. White-box Inspection: When an environment error is ambiguous, search for the error message in the codebase to find where it's raised.
4. Injection: Use print() to trace variable states in the sandbox. Logs can be read via log_analyze.

⚠️ Safety

• Never modify files permanently. Always restore files before concluding the session.
• Only use these tools within the /sandbox/software directory (handled automatically).