SuperAPI AI 工具集

codecontext-setup

编程与开发

查看项目

更新于 10-15 21:06

技能介绍

用途:帮助仓库正确采纳 codecontext,让代理有明确契约可依,而非仅安装依赖。适用于安装或采纳 codecontext、更新 AGENTS.md 中 @context 指引、审计现有配置、修复工具与文档不一致、改善代理对决策/风险/假设/历史的发现。

主要能力:审计包管理器与工作区、是否已依赖 @recallnet/codecontext-cli、@recallnet/codecontext-eslint-plugin、语言原生检查器、ESLint 共享配置位置、根与子树 AGENTS.md 及既有 @context/ADR 提及;识别两类常见缺陷:装了工具但无代理工作流,或指引过时、矛盾、指向不存在的策略。

安装面:按需最小安装——代理需运行 --scope、--diff、--report 时装 CLI;用 ESLint 且需注释校验时装 ESLint 插件;主校验面为 Python、Go、Rust 等时用语言原生检查器;仅当自定义代码直接导入 parser API 时才装 @recallnet/codecontext-parser。不要添加用不到的包。

AGENTS.md 契约:说明 @context 用途、何时必需、精简分类法(decision、risk、requirement、history)、编辑前后工作流、refs 的边界与反模式。命令示例:npx @recallnet/codecontext-cli --scope <file>;npx @recallnet/codecontext-cli --diff HEAD <file>;npx @recallnet/codecontext-cli --report。

限制与原则:不要发明必需的 sidecar 文档 schema,不要要求 .ctx.md 或 frontmatter;refs 可指向 Markdown、HTML、文本、图表等任意可解析文件,且非每条注释必需。不要强制为 codecontext 引入 ESLint;按实际技术栈选择校验面。交付时说明安装或改动内容、修复的过时指引、遗留缺口及未安装校验面的原因。