SuperAPI AI 工具集

c3-query

通用与其它

查看项目

更新于 10-15 23:48

技能介绍

用途:c3-query 用于在已采用 C3 架构文档的项目中回答架构问题,例如“X 在哪里”“X 如何工作”“X 的代码在哪”“X 适用哪些约束”。它把文档与代码结合,提供完整上下文。

主要能力:先通过 npx -y @lagz0ne/c3x list --json 加载完整拓扑,识别容器、组件、refs 与 ADR;再按 Context → Container → Component 导航层级,从文档的 ## Code References 提取文件路径与符号,并用 Glob、Grep、Read 探索代码进行验证。支持文档查询、代码查询、深度探索和约束链查询。

使用方式:前置条件是项目已采用 C3。先运行 npx -y @lagz0ne/c3x list --json;若失败或为空则停止,并提示使用 c3-onboard 技能先创建文档。随后按需读取 references/skill-harness.md、references/layer-navigation.md、references/constraint-chain.md。查询模糊时用 AskUserQuestion 澄清意图。响应格式包含 Layer、Code References、Key Insights 与 Related。

适用场景:定位组件、理解模式与约定、追踪代码引用、梳理约束链。

限制:依赖 C3 文档存在;文档过时需用 c3-audit 或 c3-change 修复;主题不在文档中时直接搜索代码;跨容器查询需列出所有受影响容器。与 c3-navigator 智能体的关系是:该技能定义查询工作流,智能体实现该工作流,通过 Task 工具生成时用智能体,内联执行时直接用技能。