agentrc:基于 Copilot SDK 的 AI 开发辅助 CLI 项目

Get your repo ready for AI.

分支31Tags94
文件最后提交记录最后更新时间
6 个月前
5 天前
7 个月前
18 天前
21 天前
6 个月前
19 天前
19 天前
19 天前
5 天前
5 天前
6 个月前
21 天前
21 天前
21 天前
8 个月前
21 天前
19 天前
7 个月前
7 个月前
21 天前
6 个月前
7 个月前
18 天前
7 个月前
7 个月前
6 个月前
7 个月前
6 个月前
7 个月前
7 个月前
5 天前
18 天前
7 个月前
5 个月前
21 天前

AgentRC

面向 AI 编码智能体的上下文工程。

CI License

Warning

实验性功能 — 正在积极开发中,可能存在破坏性变更。提交 issue 以反馈。


当 AI 编码智能体了解如何构建、测试和 lint 你的代码,并熟悉你的架构、约定以及团队所依赖的外部服务时,表现最佳。大多数代码仓库并不提供这些信息。

AgentRC 会读取你的代码库,生成用以弥合差距的文件——随后评估它们是否真正有效,从而避免上下文在代码不断演进时变得过时。

npx github:microsoft/agentrc

可作为 CLI 或 VS Code 扩展 使用,也能接入 CI/CD 流水线 以监控漂移。无需配置,任意具备 Node.js 22+ 的仓库均可运行。

AgentRC — 度量、生成、维护循环

它能做什么

度量

围绕 9 大支柱和 5 级成熟度模型,对您仓库的 AI 就绪度进行评分。识别缺失的上下文——从基础 linting 到 MCP 服务器配置。

npx github:microsoft/agentrc readiness

生成

通过 Copilot SDK 生成定制的指令文件、评测与开发配置。不依赖模板——AgentRC 会读取实际代码,并生成契合当前技术栈的上下文。

npx github:microsoft/agentrc instructions

维护

代码库持续演进,上下文会逐渐过时。评估你的指令是否仍能提升 agent 的响应质量,并在 CI 中运行该检查,防止偏差漏网。

npx github:microsoft/agentrc eval

AgentRC 借助 GitHub Agentic Workflows 自我维护

本仓库通过 GitHub Agentic Workflows 进行例行维护和演示:

工作流 目的 输出
AgentRC 就绪报告 在本仓库上运行 AgentRC,并说明影响最大的待改进项 一个短期 Issue
AgentRC 就绪升级 改进一条有证据支持的指令,并验证结果 一个草稿 PR
Issue 分诊 对新的 Issue 进行分类,并询问缺失信息 受控标签和一条评论
CI 故障诊断 根据日志和仓库变更诊断失败的 CI 一个 Issue 或一条评论

源工作流为 Markdown。gh aw compile 会生成可审查的 .lock.yml 工作流,供 GitHub Actions 执行。当这些生成的文件发生漂移时,CI 会失败。

架构和维护命令详见 Agentic Workflows。如需了解单人维护者叙事、精确的阶段流程以及回退方案,请使用 黄金演示操作手册。

适配各种规模

工作流 命令
交互式入口 agentrc
一次性初始化 agentrc init
CI 质量门禁 agentrc readiness --fail-level 3 --json
跨组织批量执行 agentrc batch
为任意仓库自动创建 PR agentrc pr owner/repo

兼容 GitHub 和 Azure DevOps。支持 monorepo、多根 VS Code 工作区和自定义 策略。

生成的内容

文件 用途
.github/copilot-instructions.md 向 AI Agent 说明你的仓库约定
.vscode/mcp.json 将 AI 连接到你的技术栈工具与数据
.vscode/settings.json 为 AI 辅助开发优化 VS Code
agentrc.eval.json 用于衡量指令质量的测试用例

如需多 Agent 支持(Copilot + Claude + 其他),请使用 --output AGENTS.md 生成 AGENTS.md。参见 VS Code 中的自定义指令。

可与 APM 配合使用

APM(Agent Package Manager)跨仓库分发 Agent 指令、技能和提示词——就像 npm 之于 AI Agent 配置。

AgentRC 负责生成内容,APM 负责分发:

  • 在你的项目中 — 运行 agentrc init 生成指令,然后运行 apm install org/standards 从团队拉取共享 Agent 包
  • 面向你的团队 — 创建专用 APM 包,放入最佳指令和技能,然后团队成员使用 apm install 安装
  • 规模化场景 — apm audit 扫描安全问题;apm-policy.yml 在所有仓库中强制执行组织标准

.instructions.md 格式由两个工具共享——将指令移入 APM 包时无需转换。

文档

入门指南 前置要求和首次运行
核心概念 成熟度模型、就绪支柱、生成机制
命令 完整 CLI 参考
配置 区域、工作区、Monorepo
策略 自定义就绪度评分
规模化 跨组织批处理
CI 集成 GitHub Actions 和 Azure Pipelines
VS Code 扩展 侧边栏视图、命令、设置
Agent 插件 安装为内置技能的 Copilot Agent 插件
Agent 工作流 自测实践、维护和实时演示指南
黄金演示 单人维护者故事与舞台就绪操作手册
示例 配置、评估和策略

在 VS Code 中定制 AI · 自定义指令 · CONTRIBUTING.md

故障排除

"Copilot CLI 未找到" — 请在 VS Code 中安装 GitHub Copilot Chat 扩展。该 CLI 随扩展一同提供。

"Copilot CLI 未登录" — 在终端中运行 copilot,然后输入 /login。

"需要 GitHub 身份验证" — 执行 brew install gh && gh auth login,或设置 GITHUB_TOKEN(或 GH_TOKEN)。

"需要 Azure DevOps 身份验证" — 设置 AZURE_DEVOPS_PAT 或 AZDO_PAT。

许可证

MIT

商标

本项目可能包含项目、产品或服务相关的商标或徽标。Microsoft 商标或徽标的授权使用,须受 Microsoft's Trademark & Brand Guidelines 约束并遵循该指南。在本项目的修改版本中使用 Microsoft 商标或徽标,不得造成混淆或暗示 Microsoft 背书。任何第三方商标或徽标的使用,均须遵守相应第三方的政策。

项目介绍

为 AI 准备好你的代码仓库。【此简介由AI生成】

定制我的领域