SuperAPI AI 工具集

decodie-overview

编程与开发

查看项目

更新于 10-16 09:49

技能介绍

用途:Decodie 的 Overview 模式用于对文件、目录或项目生成高层概览,回答“这是什么、如何组织”,而非逐行解释。每个目标只产出一条摘要条目,作为上手(onboarding)起点。

主要能力:识别四个概览维度——purpose(必需,2-4 句说明代码用途,先讲意图)、structure(必需,说明组织方式)、entry_points(可选,导出函数、CLI 命令、HTTP 路由、框架钩子等可调用面)、dependencies(可选,重要内外部依赖)。写入纯散文,长度随范围调整。

使用方式:提取目标路径,未提供则用项目根;校验存在且为文件或目录;将路径规范化为相对路径(目录或项目根带尾斜杠)用于重生成查找。首次运行时在项目根创建 .decodie/,含 index.json({"version":"1.0","project":"<目录名>","entries":[]})、config.json、sessions/ 与 rules/ 目录。加载 ~/.decodie/rules/.md(全局)与 .decodie/rules/.md(项目),项目规则冲突时优先。可通过 bash scripts/summarize-index.sh "$(pwd)" 加载索引摘要,不可用时直接读 .decodie/index.json。会话 ID 按 overview-YYYY-MM-DD-NNN 当日递增。

重生成:若 index.json 中已存在 decision_type 为 overview 且 sources 匹配的条目,则复用其 id 就地更新,旧会话文件保留但不再引用;否则新建条目。

限制:对源代码只读,仅读取源文件并写入 .decodie/;始终覆盖而非追加,每目标一条,不拆分为每文件条目(那是 analyze 模式的职责);与语言无关;.decodie/ 可整体删除而不影响项目;purpose 不明确时应如实说明不确定。数据格式详见 references/schema.md。