SuperAPI AI 工具集

cs-explore

编程与开发

查看项目

更新于 10-15 20:21

技能介绍

用途:cs-explore 用于对代码仓库做定向探索,并把探索过程沉淀为可检索、可复用的证据化文档,解决“同一问题第一次查两小时、第二次应五分钟找到”的复用问题。它只负责记录“看到了什么”,不做方案拍板、处方或修 bug。

主要能力:支持三种探索类型,由 frontmatter 的 type 字段区分——question(围绕具体问题查代码并给结论)、module-overview(梳理模块结构、边界、入口、依赖)、spike(对多个方向做轻量技术探查,不做最终决策)。文档要求结论前置(速答节先于证据),关键证据 3-8 条且每条标注 文件:行号,证据不足时 confidence 降为 medium 或 low;多模块或 module-overview/spike 类型需在速答节放 Mermaid 图。

使用方式:开始前先读 .codestable/attention.md,缺失则提示补齐或运行 cs-onboard。流程分五阶段:收敛探索问题(最多两个问题)、查重叠与意图分流(必做,判断更新或 supersede)、用 Glob/Grep/Read 真实读代码积累证据、起草并确认、归档到 .codestable/compound/YYYY-MM-DD-explore-{slug}.md(frontmatter 带 doc_type: explore)。更新时写回原文件并加 updated 日期;代码变化导致旧结论失效时旧文档标 status: outdated 并新建 supersede。可用搜索工具查重叠,例如:python .codestable/tools/search-yaml.py --dir .codestable/compound --filter doc_type=explore --filter type=module-overview --filter status=active。

适用场景:新人入仓快速理解模块边界与调用链;用户提具体问题但暂不要求产出方案;feature-design、issue-analyze、issue-fix 前补一轮证据化探索;技术方向讨论阶段做轻量 spike。

限制:不读代码直接给结论、证据不写 file:line、结论写在证据之后、证据节远长于速答节、跨模块流程无 Mermaid 图、提前拍板、无证据链直接给处方、继续引用过期 explore、读写非 doc_type=explore 的文档,均属反模式。共享路径与命名约定见 .codestable/reference/shared-conventions.md,搜索语法见 .codestable/reference/tools.md。