agentrc

一条命令，让 AI 助手秒懂你的代码仓库

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1097

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类编程开发

开发团队microsoft

所属国家

官网地址

GitHubhttps://github.com/microsoft/agentrc

定价模式free

价格说明开源免费，定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型

GitHub 星标★ 1097

30天Star增速

HF 下载量

上线时间2026-01-29 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-12

浏览次数0

项目介绍

agentrc 是一个用 TypeScript 编写的命令行工具，目标是让代码仓库对 AI 编程助手更友好。它通过生成和维护 AGENTS.md 等配置文件，把项目的技术栈、目录结构、构建命令、编码规范、测试方式等上下文信息整理成 AI 可读的格式。开发者只需在仓库根目录运行初始化命令，agentrc 就会扫描项目并自动生成说明文件，之后可随时同步更新，避免 AI 助手因缺少上下文而写出不符合项目习惯的代码。它解决的是 AI 编码工具在陌生仓库中“盲写”的问题，让 Claude Code、Cursor、Copilot 等代理能快速理解项目约定。核心能力包括自动探测项目类型、生成结构化代理说明、支持多代理配置以及通过 CLI 持续维护文档，适合希望把 AI 编程流程标准化的团队和个人。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

Node.js 22 或更高版本
一个可访问的本地代码仓库
能联网执行 npx 命令

安装与启动步骤

1确认 Node 版本

AgentRC 要求 Node.js 22+，先检查本机版本，版本过低需先升级 Node。
```
node -v
```
2进入仓库目录

切换到需要生成 AI 说明文件的项目根目录，命令会在当前仓库下工作。
```
cd /your/repo
```
3运行初始化

直接执行 npx 命令，AgentRC 会扫描当前仓库，无需任何配置文件。
```
npx github:microsoft/agentrc
```
4评估就绪度

对仓库做 AI 就绪度打分，查看缺失的上下文，包括 lint 到 MCP 配置。
```
npx github:microsoft/agentrc readiness
```
5生成说明文件

基于实际代码生成指令文件、评估集和开发配置，输出针对项目技术栈定制。
```
npx github:microsoft/agentrc instructions
```

如何确认成功

命令执行完成后检查仓库根目录是否出现 AgentRC 生成的指令/配置文件，且终端无报错。

常见问题

Q：需要提前写配置文件吗？

A：不需要。README 明确指出 No config needed，任何含 Node.js 22+ 的仓库都能直接运行。

Q：生成的上下文会过时吗？

A：会随代码演进而失效，README 建议用 maintain 相关能力评估并接入 CI 监控漂移。

Q：这个项目稳定吗？

A：README 标注为 Experimental，仍在活跃开发中，可能出现破坏性变更。

注意事项

项目处于实验阶段，可能有破坏性变更，建议关注仓库 issue。
除 CLI 外还支持 VS Code 扩展和 CI/CD 流程集成。
命令通过 npx 从 GitHub 直接拉取，需保证网络可访问 GitHub。

核心亮点

自动扫描项目并生成 AGENTS.md，省去手写上下文文档的重复劳动
支持多种 AI 编码代理的配置约定，换工具时不用重写说明
用 TypeScript 实现，可通过 npx 直接运行，接入成本低

不足之处

项目较新，长期维护和社区生态有待观察
对非主流语言或复杂 monorepo 的识别效果可能有限

适用场景

新成员或 AI 助手首次进入仓库时快速了解项目结构
团队统一多个 AI 编码工具的上下文配置
在 CI 或提交前自动更新代理说明文件

替代项目

aider、continue、repomix

上一篇：SwiftUI-Agent-Skill

下一篇：SwiftUI-Agent-Skill