codebase-explorer

分类: 开发与编程 | 上传者: memgrafter | 下载: 0 | 版本: v1.0（最新）

Explore a codebase to gather context for coding tasks. Preserves context window and offloads work to cheaper models.

更新日志: Source: GitHub https://github.com/memgrafter/skills-flatagents

目录结构

当前层级: codebase_explorer/

📁 agents/
- 📄 extractor.yml 1.2 KB
- 📄 judge.yml 1.1 KB
- 📄 judge_confirm.yml 1.3 KB
- 📄 judge_confirm_extractor.yml 780 B
- 📄 judge_extractor.yml 867 B
- 📄 summarizer.yml 1.7 KB
📁 src/
- 📁 codebase_explorer/
  - 📄 __init__.py 140 B
  - 📄 hooks.py 19.6 KB
  - 📄 main.py 4.3 KB
📄 machine.yml 7.3 KB
📄 profiles.yml 649 B
📄 README.md 3.6 KB
📄 run.sh 528 B
📄 SKILL.md 1.6 KB

SKILL.md

---
name: codebase-explorer
description: Explore a codebase to gather context for coding tasks. Preserves context window and offloads work to cheaper models.
---

Use this skill to gather codebase context before coding tasks. A staff architect agent explores using tree, ripgrep, and file reading, extracting imports, signatures, and code segments.

## When to use

- Before writing code that needs to understand existing patterns
- Before generating tests for existing code
- Before refactoring or modifying existing functionality
- When you need to understand how a feature is implemented

## Why use it

1. **Preserves context** - exploration happens outside main conversation
2. **Saves quota** - cheaper models do the exploration
3. **Structured output** - get imports, signatures, segments ready to use
4. **Budget-aware** - won't blow up token counts

## Usage

```bash
$HOME/.flatagents/skills/codebase_explorer/run.sh "<task>" [-d <directory>] [--token-budget N] [--max-iterations N]
```

## Examples

```bash
# Explore for test writing
./run.sh "Write tests for the UserService class"

# Explore specific directory
./run.sh "Understand the authentication flow" -d src/auth

# With custom budget
./run.sh "Find all API endpoints" --token-budget 20000 --max-iterations 5
```

## Output

Returns structured context:
- `summary`: narrative overview of the codebase
- `frozen_imports`: relevant import statements
- `frozen_signatures`: function/class signatures
- `frozen_segments`: code blocks with file paths
- `tree_outputs`: directory structure
- `file_contents`: full files that were read

登录后下载/点赞/收藏 ❤ 3 | ★ 0

codebase-explorer

目录结构

SKILL.md

举报内容

提示