SuperAPI AI 工具集

ai-context-generator

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:该技能为编码智能体生成 .ai-context 项目知识库,让 AI 更快理解项目。适用场景包括:为 AI 辅助开发初始化新项目;用户要求 create ai-context、setup project knowledge、generate .ai-context;已有 .ai-context 过期需重建;项目大规模重构后。若项目已有较新的 .ai-context、用户要无关文档或任务上下文已清晰,则不应激活。

主要能力:生成 .ai-context/ 目录,含 SKILL.md(入口与激活规则)、DYNAMICS.md(当前问题与约束),references/ 下 PROJECT-ESSENCE.md(是什么与为什么)、ARCHITECTURE.md(组件关系)、DECISIONS.md(设计决策),以及 meta/MAINTENANCE.md、可选 templates/ 和 scripts/。按稳定性分层:PROJECT-ESSENCE 约每季度或大版本更新约 500 tokens;ARCHITECTURE 约每月或每迭代约 1000 tokens;DECISIONS 每次决策变更约 800 tokens;DYNAMICS 按需约 600 tokens。

使用方式:流程为先收集项目信息(读取 AGENTS.md、README.md、package.json,扫描目录结构,读取 docs/ 或 litho.docs/,识别关键源文件与技术栈),再按各文件要求提取知识,然后基于 templates/ 模板逐一生成文件,最后做质量校验(激活触发清晰、2 分钟可读、展示全局、决策有理由、仅含当前问题、文件有日期、总 token 预算低于 4000)。

限制与注意:生成的知识只是起点而非最终事实,智能体应在首次会话中对照实际代码验证,用户应复核准确性,并建议每月审计。写作上应面向不了解项目的人,多用图表,讲清 why 而非 how,每个文件不超过 150 行,附 Last updated 日期;不要粘贴代码、不要逐个记录文件函数、不要写频繁变化的细节、不要跨文件重复内容。AGENTS.md 说明如何工作,.ai-context 说明项目是什么,两者会话开始时都应读取且不应重叠。资料未提供具体收费、平台支持与安装命令等信息。