用途:该技能面向“先查文档、再读代码”的探索方式,在调用 Glob、Grep 或 Explore 代理之前,先用语义文档定位功能与代码位置,以减少大量文件列表和搜索输出带来的令牌消耗。它适用于任何在项目根目录下存在 docs/semantic/ 文档的项目。
主要能力:
- 特性查询:传入特性代码(如 AUTH),返回完整技术规格及全部 Logic ID 和代码位置。
- 关键词搜索:传入关键词串(如 "timer approval workflow"),返回 QMD 搜索结果与匹配的 Logic ID。
- 会话上下文预热:运行 prime 脚本,返回业务索引摘要。
- 特性列表与状态检查:--list 列出全部可用特性代码和描述;--status 检查当前项目文档与 QMD 可用状态。
- 结构化查询:在已生成结构化索引后,支持 service:/svc:、route:/path:、hook:、plugin:、entity:/ent: 等前缀查询,分别返回服务、路由、钩子、插件、实体信息。
- 依赖与影响分析:deps: 与 impact: 返回依赖关系、使用方与影响范围。资料称这些结构化查询需先运行 /structural-index,否则前缀会走普通搜索。
使用方式:脚本会自动检测项目名(取自目录名)、QMD 集合名({project-name}-docs)和文档路径(docs/semantic/)。新项目需先生成语义文档(运行 semantic-architect-agent),可选创建 QMD 集合(qmd collection add {project-name}-docs docs/),再用 /discover --status 验证。以 $SKILL_DIR/scripts/discover.sh 加参数的方式调用,例如传入特性代码、关键词或结构化前缀;prime 脚本用于会话上下文。输出格式包含项目名、匹配特性列表、技术规格文件、Logic ID 到 file:line:function 的映射以及建议的 Read 操作。
适用场景:需要定位某功能实现位置、查找某处代码、在启动 Explore 代理前快速摸底、修改某业务流程前了解相关文件、在会话开始时载入业务索引等。Logic ID 格式为 FEATURE-L#,可映射到文件、行号与函数。
限制:依赖项目中已存在语义文档;无文档时会跳过并给出设置说明,标准 Glob/Grep 仍可作为回退。结构化查询需先生成结构化索引。资料未说明支持的运行环境、安装步骤细节、收费情况和性能指标,具体效果暂未提供。