SuperAPI AI 工具集

ac-init

编程与开发

查看项目

更新于 10-16 09:21

技能介绍

用途

ac-init 用于扫描项目结构,并生成 CLAUDE.md 上下文文档。必要时由 Claude 主线程统筹 subagents 并行摸排模块,最终生成分层的 CLAUDE.md 文档索引。

主要能力

  • 扫描项目结构,识别项目名称、技术栈(语言、框架、构建工具)、入口文件与模块信息。
  • 生成根级 CLAUDE.md,内容包括概述、技术栈、项目结构(Mermaid 图)、模块索引、入口文件与快速命令。
  • 在指定 --modules 参数时,生成模块级 CLAUDE.md,包含模块职责、关键文件与依赖关系。
  • 支持输出摘要,列出生成的文档、识别出的模块与推荐下一步。

使用方式

命令格式:/ac-init [项目简述] [--modules]

参数说明:

  • 项目简述:可选,项目的简要描述。
  • --modules:可选,添加此参数时生成模块级 CLAUDE.md 文件。

角色分工:

  • Claude(主线程):获取时间戳、决定是否启用 subagents、汇总扫描结果、写入根级与模块级 CLAUDE.md。
  • subagents:只读扫描项目结构、模块职责、关键文件、依赖关系,不写文件。

执行约束:

  • 工作目录:使用当前工作目录作为项目扫描根目录;如果用户通过 /add-dir 添加了多个工作区,先用 Glob/Grep 确定目标工作区;如果无法确定,用 AskUserQuestion 询问用户选择目标工作区。
  • subagents 使用条件:适用于项目目录较大、模块较多、需要并行梳理结构或依赖关系的场景;优先使用 Explore 用于只读扫描项目结构、入口文件、模块边界和依赖关系;不适用于小型项目、目录结构简单、主线程几次读取即可完成的场景。
  • 仅生成或更新文档文件:根级 CLAUDE.md 与模块级 CLAUDE.md,不修改任何源代码、配置或依赖。
  • subagents 只做扫描与分析,不写文件。
  • 已委托给 subagents 的扫描内容,主线程不要重复执行。
  • 跳过生成物和缓存目录:node_modules、dist、build、.git、pycache。

执行工作流包括:获取时间戳与根级扫描、生成根级 CLAUDE.md、生成模块级 CLAUDE.md(仅当指定 --modules)、输出摘要。

适用场景

  • 需要为项目快速生成上下文文档索引的场景。
  • 项目目录较大、模块较多,需要并行梳理结构或依赖关系的场景。

限制

  • 小型项目、目录结构简单、主线程几次读取即可完成的场景不适用 subagents。
  • 仅生成或更新文档文件,不修改源代码、配置或依赖。
  • 其他限制信息暂未提供。