SuperAPI AI 工具集

load-context

写作与研究

查看项目

更新于 10-15 22:17

技能介绍

用途:在已有 Rails 代码库中写代码、规格或 PRD 之前,先加载最小必要上下文。核心是“十五秒读取”原则:读 db/schema.rb、config/routes.rb 以及每层一个邻近样例,可省去一次完整重试。

主要能力:设定硬性门槛,未发布 Context Summary 前不得提出代码、规格、PRD 或任务清单;不得静默消解歧义,需求冲突或规格与代码不一致时先输出 Confusion Block;不得加载整个仓库,只做定向读取;必须引用所读文件(尽量到 path:line);用户中途改变范围时重新检查上下文。

使用方式:若 rails-ai-bridge 在运行,可调用 get_project_context 获取统一项目上下文,成功则跳过手动步骤 2、3。手动流程为:一句话界定涉及的 Rails 层(controller、model、service、job、engine、view/Turbo、migration、API、GraphQL);读取 db/schema.rb、config/routes.rb、Gemfile.lock;为每层找一个已解决类似问题的邻近文件,并引用实际执行的 grep 命令,如 grep -r "class.*Controller" app/controllers、grep -r "class.*Service" app/services、grep -r "class.*Model" app/models、grep -r "class.*Job" app/jobs;检测规格与代码漂移;按模板发布 Context Summary;遇冲突输出 Confusion Block;随后交接给 plan-tests、apply-stack-conventions 等后续技能。

适用场景:现有 Rails 应用中的功能改动、迁移、API 或 GraphQL 相关工作前的上下文准备。

限制:无 schema.rb 时改用 db/structure.sql 解析 CREATE TABLE;多 engine 需限定目录并记录边界;缺少规格时标注“no spec coverage”并以代码为准;不得使用被改文件自身作为邻近样例;避免过度 grep,每层最多一个邻近样例。具体安装与调用细节暂未提供。