每个AI编码代理都有一个工程标准
在猜测之前提问的特工，只会改变你的提问，
告诉你他们到底做了什么 不 核实。
Claude Code·OpenAI Codex·Cursor·GitHub Copilot·Gemini CLI
npx maisongr-skills
为什么会这样？
AI编码代理很少会因为缺乏知识而失败。他们之所以失败，是因为完成任务比把它做好更难。所以他们:
- 猜猜你不是问是什么意思；
- 构建任务不需要的抽象和选项；
- “改进”无人提及的文件；
- 报告“所有测试通过”而不运行它们；
- 推送、删除一个列或者在没有人要求的时候破坏一个公共API。
当你的团队使用三种不同的代理时，你会得到三种不同的标准，或者没有。
Maison GR为每个代理提供了相同的七个原则和十个任务方法，来自一个源文件，安装一个命令。
60秒
- 在任何项目中，运行
npx maisongr-skills。 - 向你的代理人要求一些稍微模棱两可的东西： “向用户端点添加缓存。”
- 它不是猜测，而是询问要缓存什么以及缓存多长时间，或者陈述它所做的假设。
- 当它完成时，它报告它做了什么和不能检查什么。例如:
Changed: src/api/users.ts: added a 60 s cache to GET /users
Verified: npm test (42 passed), npm run lint (clean)
Not verified: cache invalidation under concurrent writes (no integration environment)
Decisions: chose in-memory over Redis; revisit if you run more than one instance
任何时候都可以撤销它 npx maisongr-skills remove。
收据：“测试通过”你可以检查
代理可以写“已验证： npm test （42通过）“没有跑任何东西。”安装了Claude Code插件后，Maison GR检查。
- 代理在会话中运行的每个shell命令都将被记录下来，并附带其退出代码。
- 当代理尝试完成时，下面列出的每个命令 验证 与那个记录核对。
- 如果一个命令从未运行过，或者它的最后一次运行失败，而报告说它通过了，那么将发送代理返回运行它并报告实际结果，或者将它移动到 不验证。
Maison GR receipts: your report lists commands under "Verified" that this session's record does not support:
- `npm test`: no command like this ran in this session.
Run them now and report the real result, or move them to "Not verified" with the reason.
同样的记录捕捉到了 悄悄采取的防御行动 (见原则7； 保护不可逆动作）. 如果会话是强制推送的，跳过Git钩子 --no-verify我把一切都安排好了 git add -A，改写历史（修改，重置，重置） --hard)，或者更改了Git配置，并且报告永远不会提到它，代理将被发送回拥有并证明操作的正确性-或者撤消操作。
Maison GR receipts: this session took a guarded action without owning it in the report:
- this session force-pushed (`git push --force origin fix/foo`) but your report never mentions it.
Each is allowed only if the user asked for it here. Say so and justify it in your report, or undo it.
它只检查反引号中的命令名（以及上面的Git操作），不会连续阻塞两次，并将其记录保存在您的机器上，保存在Claude Code的插件数据文件夹中。收据需要 Claude Code插件;其他代理无需检查即可获得相同的报告格式。
它是如何工作的
flowchart LR
N["npx maisongr-skills"] ==> A
A["AGENTS.md<br/>7 principles, always on"] --> C[Claude Code]
A --> X[Codex]
A --> U[Cursor]
A --> P[Copilot]
A --> G[Gemini CLI]
S["10 skills<br/>loaded on demand"] -.-> C & X & U & P & G
- 原则 简短的、永远在线的指令在吗
AGENTS.md，大多数代理已经读取了该文件。大约6 KB。 - 技能 代理是否只在任务匹配时加载详细方法 代理技能 格式。
- 子代理 （Claude Code和Gemini CLI）在它们自己的上下文中运行审查、设计和测试。
安装程序在每个代理本机查找的地方编写每个部分。它将原则添加到您现有的标记块上 AGENTS.md，在以后的运行中只更新该块，并只删除它添加的块。
的原则
| ＃ | 原则 | 防止 |
|---|---|---|
| 1 | 实施前先了解 | 正确地构建错误的东西 |
| 2 | 简单第一 | 拥有成本高于价值的代码 |
| 3 | 外科手术改变 | 未修改代码中不可审查的差异和回归 |
| 4 | 目标驱动执行 | 写完代码就结束的工作，而不是实现目标的工作 |
| 5 | 竣工前验证 | 对未经测试的工作有信心的报告 |
| 六 | 默认是安全的 | 有效代码中的漏洞 |
| 七 | 保护不可逆动作 | 其他编辑无法撤销的伤害 |
每个任务都遵循相同的循环：
flowchart LR
I[Inspect] --> Q[Clarify] --> P[Plan] --> M[Implement] --> V[Verify] --> R[Report]
Q -- ambiguous --> Ask((Ask you))
V -- fails --> M
的技能
| 技能 | 用它来 |
|---|---|
maisongr-engineering | 携带从请求到验证结果的任何重要更改 |
maisongr-architecture | 设计决策，新模块或依赖项，决策记录 |
maisongr-code-review | 审查diff或pull请求，根据严重性对结果进行排序 |
maisongr-debugging | 重现失败，找到根本原因，证明解决办法 |
maisongr-testing | 在适当的水平上进行有意义的测试，证明可能会失败 |
maisongr-security-review | 威胁建模、访问控制、注入、秘密、依赖 |
maisongr-documentation | 准确的，经过验证的readme，指南，参考文献和操作手册 |
maisongr-database | 安全迁移、完整性约束、正确和快速查询 |
maisongr-api | API契约、验证、一致错误、兼容进化 |
maisongr-frontend | 可访问（WCAG 2.2 AA），响应迅速，完成界面 |
当有匹配的请求时，代理会选择相应的技能。 “用户说CSV导入会删除行” 负载 maisongr-debugging：重现，找到根本原因，修复，添加回归测试。直接呼叫： /maisongr:maisongr-security-review 在《克劳德法典》中， $maisongr-security-review 在法典。
安装
任何特工，一个命令 （Node.js 18.3或更高版本），从项目的根目录：
npx maisongr-skills # all five agents
npx maisongr-skills --agent codex,cursor # only some: claude, codex, cursor, copilot, gemini
npx maisongr-skills --global # your user account, every project
npx maisongr-skills --dry-run # show what would change
npx maisongr-skills remove # undo
提交结果，这样你的整个团队和每个经纪人都能以同样的标准工作。
Claude Code插件，克劳德代码内部：
/plugin marketplace add maison-gr/maisongr-ai-engineering-skills
/plugin install maisongr@maison-gr
Gemini CLI扩展：
gemini extensions install https://github.com/maison-gr/maisongr-ai-engineering-skills
插件和扩展安装技能和子代理；对于Claude Code中的always-on原则，也可以运行 npx maisongr-skills --agent claude 或添加 @AGENTS.md 到你的 CLAUDE.md。这个 安装指南 涵盖项目和用户范围，手动复制，更新和删除每个平台。
让它成为你的
- 添加项目的细节。 把你的命令、约定和界限放在Maison GR块下面
AGENTS.md，从…开始templates/project-instructions.md． 具体指示优先于一般原则。 - 计划更大的改变。 请代理代为填写
templates/implementation-plan.md等待你的批准。 - 选择你的技能。 每个技能文件夹都是独立的；只保留团队需要的。
探员还是搞错了吗？
如果安装了Maison GR的代理仍然猜测、过度构建、触摸它不应该拥有的文件，或者要求进行它从未进行过的检查， 把成绩单发给我们． 每个报告都成为下一个版本的测试用例。
要贡献一个修复、一项技能或一个新平台，请阅读 贡献． 仓库是如何构建的： 体系结构。
学分
Maison GR从 andrej-karpathy-skills 以及LLM编码代理的四项原则。它增加了验证、安全性和不可逆操作的原则、十项任务技能、子代理、一个用于五个平台的生成源和一个安装程序。 RESEARCH.md 列出每一个项目和文件，告知设计。
进一步的阅读
原则 · 例子 · 安装 · 兼容性 · 常见问题解答 · 体系结构 · 更新日志
许可证
麻省理工学院 ©Maison GR