AI Rulebook — VS Code 扩展
一份规则源文件,自动生成 CLAUDE.md / AGENTS.md / Copilot 指令文件,让 AI 按你的规矩写代码。
本扩展是 ai-rulebook 命令行的图形入口 —— 把命令行的 init / sync / doctor 变成命令面板里点一下。
用法
- 用 VS Code 打开你的项目文件夹。
Cmd/Ctrl + Shift + P 打开命令面板,输入 AI Rulebook:
| 命令 |
作用 |
| AI Rulebook: 初始化(生成规则文件) |
在项目根生成 AGENTS.private.md 模板与全部规则文件 |
| AI Rulebook: 同步规则 |
改完 AGENTS.private.md 后刷新所有产物 |
| AI Rulebook: 体检(检查规则是否已同步) |
检查产物是否落后于私有规则、有没有漏生成 |
| AI Rulebook: 打开 AGENTS.private.md |
直接跳到私有规则文件开写 |
命令输出都在「输出」面板(Cmd/Ctrl + Shift + U → 选 AI Rulebook)。
它到底做什么
AGENTS.base.md (公共规则,随包分发)
AGENTS.private.md (你项目自己的规则)
│
│ ai-rulebook sync
▼
CLAUDE.md · AGENTS.md · .github/copilot-instructions.md
.github/instructions/*.instructions.md · .claude/skills/*
写一次规则,Claude Code / GitHub Copilot / Cursor 等各读各的文件,内容始终一致。
规则内容与命令行版本完全一致,完整说明见 npm 包 README。
从源码构建 VSIX
cd vscode-extension
npm install # 拉 ai-rulebook 依赖 + @vscode/vsce
npx vsce package # 产出 ai-rulebook-vscode-<版本>.vsix
发布
publisher 已填 baikaifa,扩展 ID 为 baikaifa.ai-rulebook-vscode(name 用
ai-rulebook-vscode 是因为 ai-rulebook 这个名字已被其他发布者占用,展示名
displayName 仍是 AI Rulebook)。
两条发布路径,任选其一:
- 网页上传(不需要 PAT) —— 打开
https://marketplace.visualstudio.com/manage/publishers/baikaifa →
New extension → Visual Studio Code → 选 ai-rulebook-vscode-<版本>.vsix → Upload。
⚠️ 用系统文件选择器选文件,不要拖拽:拖拽常常只是把文件名显示出来、
内部 FileList 仍是空的,Upload 会静默无反应。
- 命令行(需要 PAT,勾选 Marketplace → Manage):
cd vscode-extension
npx vsce login baikaifa # 粘贴 Azure DevOps 的 PAT
npx vsce publish
License
MIT
| |