用途:为代码库建立 AI 驱动的索引,提升代码导航能力。适用于开始处理新仓库,或被要求“索引此代码库”“设置 agentifind”“分析代码库”时。
主要能力:运行 npx agentifind init --skip-conventions 后生成 .agent/ 文件夹,包含 index.json(函数、类、引用的符号图)、test-map.json(源文件到测试文件的映射)、entrypoints.json(API 处理器、CLI 命令、主函数)、boundaries.md(依赖影响分析)。随后由 AI 阅读 10-15 个代表性文件,分析错误处理、日志、测试、命名、文件组织与配置,生成 .agent/conventions.md。
使用方式:在仓库根目录执行 npx agentifind init --skip-conventions,等待完成;再分析代码库并写入 .agent/conventions.md;确认 .agent/ 下五个文件齐全;提示用户重启编码代理以启用 MCP 工具。启用后可用的工具包括 find_callers、trace_path、get_tests_for、get_conventions、get_boundaries。MCP 服务器(agentifind serve)会在 .mcp.json 中自动配置。
适用场景:新仓库初始化、代码结构发生重大变化或新增大量代码后重新索引。
限制:每个仓库运行一次;新增大量代码或改变项目结构后需重新运行;conventions.md 需由 AI 分析生成,非命令自动产出;其余细节暂未提供。