用途:understand-domain 用于从代码库中提取业务领域知识,包括业务领域、业务流程和流程步骤,并生成可交互的横向流程图。
主要能力:
- 支持两种知识来源:优先从已有知识图谱($UA_DIR/knowledge-graph.json,或旧版 .understand-anything/knowledge-graph.json)派生领域知识,节省扫描成本;若无图谱则执行轻量扫描,包括文件树、入口点检测和文件抽样。
- 使用 --full 参数可强制重新扫描,即使已有知识图谱。
- 自动解析项目根目录,并在检测到 git worktree 时将输出重定向到主仓库根目录;可通过环境变量 UNDERSTAND_NO_WORKTREE_REDIRECT=1 关闭该行为。
- 对已有图谱执行新鲜度检查:比对图谱记录的提交哈希与当前 HEAD,并检查已提交和工作区变更,必要时提示运行 /understand 刷新图谱。
- 通过 domain-analyzer 子代理进行领域分析,输出经标准图谱校验流程验证的 domain-graph.json,校验失败时记录警告并保存有效部分。
- 完成后自动触发 /understand-dashboard,仪表盘检测到 domain-graph.json 后默认展示领域视图。
使用方式: 在项目目录中运行该技能。技能会先确定 PROJECT_ROOT 和数据目录 $UA_DIR(优先沿用已存在的 .understand-anything/,否则使用 .ua/),再根据是否存在知识图谱选择派生或扫描路径。轻量扫描阶段运行技能自带的预处理脚本:python ./extract-domain-context.py "$PROJECT_ROOT",生成 $UA_DIR/intermediate/domain-context.json,内容包含文件树、检测到的入口点(HTTP 路由、CLI 命令、事件处理器、定时任务、导出的处理器)、文件签名(导出与导入)、入口点代码片段及项目元数据(package.json、README 等)。随后读取 domain-analyzer 代理提示词并派发子代理,输出 $UA_DIR/intermediate/domain-analysis.json,最终校验并保存为 $UA_DIR/domain-graph.json,同时清理中间文件。
适用场景: 需要快速理解陌生代码库业务结构、梳理领域与业务流程、或以可视化方式查看领域流程图的开发与架构分析场景。
限制:
- 轻量扫描为抽样式分析,可能遗漏部分业务逻辑。
- 若已有图谱落后于代码变更,领域提取可能遗漏最新变化,需先刷新知识图谱。
- 依赖正确的插件安装和路径解析;若找不到插件根目录会报错退出。
- 文档未提供收费、价格或效果测评信息。