Copilot Installation

GitHub Copilot 安装指南

通过安装脚本在 Copilot 项目中安装 ai-coding-ok。

---

前置条件

• GitHub Copilot 订阅（个人/商业/企业）
• 已安装 Git

---

第 1 步：下载 ai-coding-ok

git clone https://github.com/Mark7766/ai-coding-ok ~/ai-coding-ok

只需执行一次，所有项目共用这一份。

---

第 2 步：安装到项目

进入你的项目目录：

cd ~/你的项目
bash ~/ai-coding-ok/install.sh --copilot

这会将所有模板文件复制到你的项目中，包括：

• AGENTS.md — 架构速查
• .github/copilot-instructions.md — Copilot 自动加载的行为规则
• .github/agent/memory/ — 三层记忆文件
• .github/agent/ — Agent 规范和编码标准

与 Claude Code / Codex 不同，Copilot 没有全局 skill 系统——需要每个项目单独安装。

---

第 3 步：让 AI 填充占位符

模板复制好了，但 {{占位符}} 还是空的。

方式一：直接对 Copilot 说（推荐）

安装 ai-coding-ok，我想做一个xxx

方式二：粘贴定制 prompt

将 scripts/customize-prompt.md 的内容复制到 Copilot Chat，AI 会读取所有模板文件并替换所有 {{占位符}}。

---

第 4 步：验证

bash ~/ai-coding-ok/scripts/verify.sh

预期输出：

✓ 所有必需文件已就绪。
✓ 无未填充的占位符 — 安装已完全定制化。

---

Copilot 如何加载 ai-coding-ok

GitHub Copilot 自动读取 .github/copilot-instructions.md 中的全局行为规则。该文件包含 PDCA 强制指令：

1. 任务前：读取 AGENTS.md + 三个记忆文件
2. 任务后：更新 task-history.md（始终），按需更新其他记忆文件

每次 Copilot 会话都会自动执行。

---

Copilot 与 Claude Code 的差异

方面	Copilot	Claude Code
安装方式	每个项目单独复制模板	全局安装 skill 一次
触发机制	.github/copilot-instructions.md 自动加载	SKILL.md + CLAUDE.md shim
Hooks	无	四重 hooks 硬约束
指令文件	.github/copilot-instructions.md	CLAUDE.md → AGENTS.md

---

常见问题

"我已经有 AGENTS.md 了"

安装程序检测冲突。可以选择覆盖、只复制缺失文件、或取消。不会静默覆盖。

"在 VS Code 还是 JetBrains？"

模板与编辑器无关——.github/copilot-instructions.md 在 Copilot 支持的所有编辑器中都会自动加载。

---

下一步

• 验证安装
• 理解 PDCA 工作流
• 了解三层记忆系统