| name | repo-scanner |
| description | Use when initializing or rebuilding the wiki index. Scans the entire Kaiwu_2026 repository, extracts code structure via Python AST parsing, summarizes docs and experiment logs, and generates wiki/ index files. |
| version | 1.0.0 |
| author | Qoobee |
| platforms | ["linux","macos","windows"] |
| metadata | {"hermes":{"tags":["kaiwu","wiki","indexing","ast"],"related_skills":["wiki-sync","rl-advisor"]}} |
Repo Scanner
全量扫描 Kaiwu_2026 仓库，生成结构化 wiki 索引。
When to Use
- 首次部署 Hermes 后，建立初始索引
- wiki/ 目录损坏或过期时重建
- 仓库发生大规模重构后重新扫描
Don't use for: 日常小改动（用 wiki-sync）、代码审查（用 代码审查 skill）
执行流程
Step 1: 扫描仓库结构
遍历以下目录，排除 .git/、__pycache__/、node_modules/、.hermes/：
初赛/工程/
区域赛/工程/
全国决赛/工程/
docs/
参考资料/
对每个目录记录：文件名、类型、大小、最后修改时间。
Step 2: Python AST 解析
对所有 .py 文件执行 AST 解析，提取：
- 函数定义：名称、参数列表、返回类型注解、docstring
- 类定义：名称、父类、方法列表
- 配置常量：模块级赋值（
UPPER_CASE 变量）
- import 关系：
import 和 from ... import 语句
使用 Python 内置 ast 模块：
import ast
with open(file_path, 'r', encoding='utf-8') as f:
tree = ast.parse(f.read())
Step 3: 提取 docs/ 知识
读取 docs/ 目录下的所有 .md 文件，提取：
Step 4: 汇总实验记录
扫描 初赛/实验记录/ 和各赛段下的实验相关文件，提取：
Step 5: 生成 wiki/ 文件
按以下模板生成 5 个文件：
wiki/index.md
# Kaiwu_2026 仓库索引
## 快速导航
- [代码架构](architecture.md)
- [实验记录](experiments.md)
- [赛段知识](competition.md)
- [API 速查](api-reference.md)
## 仓库概览
- 赛段数量：3（初赛、区域赛、全国决赛）
- 主要语言：Python
- 算法：PPO
- 成员：Qoobee（队长）、Snow（队员）
## 最近更新
<!-- 由 git log 自动生成 -->
wiki/architecture.md
# 代码架构
## 通用模块结构
每个赛段的 agent 遵循统一结构：
- agent.py — 入口
- algorithm/ — PPO 算法实现
- conf/ — 配置参数
- feature/ — 特征工程
- model/ — 网络模型
- workflow/ — 训练流程
## 各赛段架构
<!-- 由 AST 扫描结果自动填充 -->
wiki/experiments.md
# 实验记录索引
## 初赛实验
<!-- 由扫描结果自动填充 -->
## 区域赛实验
<!-- 由扫描结果自动填充 -->
wiki/competition.md
# 赛段知识汇总
## 初赛：地图探索 + 宝箱收集
## 区域赛：王者 1v1
## 全国决赛：王者 3v3
<!-- 由 docs/ 和参考资料/ 提取填充 -->
wiki/api-reference.md
# API 速查
## 函数索引
<!-- 由 AST 扫描结果自动生成表格 -->
| 模块 | 函数 | 参数 | 说明 |
|------|------|------|------|
Step 6: 更新 Hermes Memory
将以下信息写入 Hermes persistent memory：
- 仓库结构摘要
- 关键配置参数位置
- 各赛段的 agent 变体列表
- 最近的实验结论
验证清单
