القائمة
Guide for generating and using AI-readable code maps
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当用户需要理解、开发、扩展或验证 AgentLoom 框架能力时使用。覆盖创建/扩展 Application、设计单 Agent 或多 Agent、编写 Agent/Worker YAML、实现 Tool、创建私有 Skill 或 Hook、更新 README、验证 YAML/结构/运行结果。也适用于用户问“这个功能用 AgentLoom 怎么实现”。
Cross-session experience recall via file-based memory. Agents accumulate insights (pitfalls, decisions, facts) that persist across runs, plus ephemeral context and trace files for the current task.
Test Skill fixture with relative resources and scripts.
Second test Skill fixture with relative resources and scripts.
pure Skill fixture (relative path)
second pure Skill fixture (relative path)
| name | repo_map_guide |
| description | Guide for generating and using AI-readable code maps |
| version | 1.0 |
Repo Map 是一个代码地图生成系统，参考 Aider 的 RepoMap 实现， 将任意代码项目扫描后生成 AI 可读的 Markdown 文件目录结构。
<output_dir>/
repo_map/
index.md # 项目总览 + PageRank top-20 关键模块
dependencies.md # 跨文件依赖关系
<dir>/
index.md # 该目录所有文件的定义+引用摘要
analysis.md # LLM 生成的架构分析（step3）
data/
tags.json # 所有文件的代码 tags（原始数据）
ranked.json # PageRank 排序结果
scan_meta.json # 扫描元信息
analysis_progress.json # step3 执行进度（断点续传）
每个目录的 index.md 包含：
# src/core/
- 文件数: 12
- 总定义数: 78
## 文件列表（按重要性排序）
### engine.c ★★★★★
*src/core/engine.c*
- `engine_init` (line 28)
- `engine_run` (line 45)
- `process_event` (line 78)
*被引用于*: `main.c`, `handler.c` ... +3 more
⭐ 星级由 PageRank 分数决定：
{
"src/core": {
"status": "completed", // pending | in_progress | completed | failed
"md_file": "/abs/path/repo_map/src/core/index.md",
"output": "/abs/path/repo_map/src/core/analysis.md",
"rank": 1,
"file_count": 12
}
}
step3 通过 analysis_progress.json 支持断点续传：
status == "completed" 的目录status = "in_progress"（立即写回）status = "completed"（立即写回）in_progress 状态自动重置为 pending# 基本用法
.venv/bin/python applications/repo_map/repo_map_app.py /path/to/project
# 完整参数
.venv/bin/python applications/repo_map/repo_map_app.py /path/to/project \
--output_dir /tmp/mymap \
--exclude_dirs vendor \
--exclude_dirs third_party \
--exclude_dirs build
通过 tree-sitter 支持 30+ 语言，包括： C, C++, Python, JavaScript, TypeScript, Java, Go, Rust, Ruby, Swift, Kotlin, Dart, Elixir, Elm, Haskell, OCaml, Scala, Zig 等