用途:把框架专属的最佳实践和文档压缩后注入当前项目的 CLAUDE.md 或 AGENTS.md,使 AI 编程智能体无需工具调用或技能即可被动获取框架知识。
支持框架与来源:Next.js(package.json 中存在 next 依赖)使用 Vercel 的 agents-md codemod(版本感知);FastAPI(requirements.txt 或 pyproject.toml 中存在 fastapi)使用 zhanymkanov/fastapi-best-practices。
使用方式:先自动检测框架与版本,再确定目标文件(优先 CLAUDE.md,其次 AGENTS.md,都没有则默认 CLAUDE.md),然后执行注入。Next.js 在项目根目录运行:npx @next/codemod@canary agents-md --output <TARGET_FILE>,需 Node.js 与网络访问;该命令会按 package.json 版本下载匹配文档,注入压缩的管道分隔索引,并把完整文档下载到 .next-docs/ 同时加入 .gitignore。FastAPI 需 uv,运行 uv run <absolute-path-to-this-skill-dir>/scripts/inject_fastapi_docs.py,脚本会检测目标文件、更新或追加 “FastAPI Best Practices” 段落,覆盖领域驱动结构、异步模式、Pydantic 校验、依赖注入、SQLAlchemy 集成、错误处理、测试与 Ruff 代码质量。注意不要用 $(dirname "$0") 定位脚本。
验证与限制:完成后须读回目标文件确认内容已注入,不能仅凭退出码报告成功;Next.js codemod 为非破坏性,注入/更新索引段而不覆盖既有内容,可将约 40KB 文档压缩到约 8KB。仅支持 Next.js 与 FastAPI 两种框架,未检测到则停止并提示,不修改任何文件。缺失信息:该技能的具体收费、价格、平台支持范围与更详细的效果数据暂未提供。