Communitygithub.com

MikeCheng1208/BattleTree

基于索引的文件发现工具,通过 ABOUTME 头部信息按用途查找文件。替代 grep 或 Explore agent 进行按目的或功能搜索文件,比扫描代码更快更准确。当用户询问“哪些文件处理 X”、“Y 在哪里实现”或需要查找与某个功能或任务相关的文件时调用本技能。

BattleTree 是什么?

BattleTree 是一个高效的基于索引的文件发现技能,专为 AI 编码代理设计。它通过读取 `.claude/aboutme-index.json` 索引文件,利用文件头部 ABOUTME 描述来定位文件,从而避免了传统 grep 扫描或代码探索的低效。该技能的核心优势在于其按目的而非按内容搜索文件的能力,使得查找特定功能或任务相关的文件变得既快速又准确。它支持 `jq` 过滤命令,能够轻松搜索关键字(如 `auth` 或 `jwt`)。此外,BattleTree 提供了三个 `/aboutme-*` 命令:`/aboutme-check` 用于查找缺少 ABOUTME 头部的文件,`/aboutme-rebuild` 用于重建整个索引,`/aboutme-stale` 用于检查过时的头部信息。索引在会话启动时自动重建,并在文件编辑时增量更新,确保索引始终是最新的。主要针对使用 Claude Code、Cursor 等工具的开发者,尤其适用于大型代码库中的快速文件导航。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/aboutme-index

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

ABOUTME 索引

读取 .claude/aboutme-index.json 以按用途查找文件,而非使用 grep 搜索。

使用方法

  1. 读取索引:
cat .claude/aboutme-index.json
  1. 使用 jq 按关键字过滤:
cat .claude/aboutme-index.json | jq 'to_entries[] | select(.value | test("auth|jwt"; "i"))'
  1. 读取相关文件。

命令

命令描述
/aboutme-check查找缺少 ABOUTME 头部的文件
/aboutme-rebuild重建整个索引
/aboutme-stale检查过时的头部信息
cat .claude/aboutme-index.json直接读取索引

索引格式

{
  "app/src/auth.py": "JWT authentication module for AWS Cognito access tokens...",
  "app/src/config.py": "Centralized configuration using Pydantic settings..."
}

索引在会话启动时自动重建,并在文件编辑时增量更新。

Individual skills in this repo

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

MikeCheng1208/BattleTree

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

MikeCheng1208/BattleTree

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

MikeCheng1208/BattleTree

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

MikeCheng1208/BattleTree

Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo.

MikeCheng1208/BattleTree

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

MikeCheng1208/BattleTree

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

MikeCheng1208/BattleTree

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

MikeCheng1208/BattleTree

Minimalist, typography-focused portfolio design system inspired by neo-brutalist and Swiss design principles. Emphasizes bold typography, generous whitespace, monochromatic color schemes, and elegant simplicity for developer/designer portfolios.

MikeCheng1208/BattleTree

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

MikeCheng1208/BattleTree

Optimize project portfolio selection under constraints using mathematical optimization

MikeCheng1208/BattleTree

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

MikeCheng1208/BattleTree

Build a GitHub portfolio that gets you hired — curate 3-5 polished projects, craft compelling READMEs, deploy live demos, tell a coherent story across your repos, and align everything to AI-native development roles. Use when preparing your GitHub for job searches, deciding what to pin, or auditing your public presence.

相关技能