# mcd-git · 用 git 命令点麦当劳
`mcd-git add` 放进购物车，`mcd-git rebase` 自动凑套餐、挑最省的券，`mcd-git push` 才真正下单，终端里直接出支付二维码；需要 Git 子命令语义时也可使用 `git mcd`。基于麦当劳中国 MCP Server（`mcp.mcd.cn`）。
> 动图和下面所有截图都是 `--demo` 合成数据：门店、价格、订单号、券都是编的，支付链接指向 `example.com`。
## 一套引擎，两个入口
- **开发者**：在终端里优先敲 `mcd-git`，人工操作和命令补全都以它为推荐入口。`git-mcd` 在 PATH 里时，也可以使用 Git 的 `git mcd …` 子命令语义；它不会碰你代码仓库的 `.git`。
- **普通用户**：把 [SKILL.md](SKILL.md) 装进 WorkBuddy / Claude Code / Kiro，用大白话点餐，Agent 在后台跑 `git mcd --json`。
一段 Agent 对话（demo 数据）：
```text
你： 中午想吃巨无霸，不要酸黄瓜，再来中薯条和中可乐。12:20 去店外取餐柜拿，不要餐具，看看怎么最省。
Agent：（git mcd add 巨无霸 中薯条 中可乐 --no-pickle --json → git mcd rebase --json → git mcd diff --json）
三样正好凑成巨无霸套餐，再用一张「示例·巨无霸套餐立减 5 元」：¥45.50 → ¥33.50。
（git mcd commit -m 午饭 --json → git mcd push --at 12:20 --locker --no-tableware --json）
门店 演示·代码港店 · 外带·店外取餐柜 · 预约 12:20 · 不要餐具
巨无霸套餐 [巨无霸 · 中薯条 · 中可乐] 去酸黄瓜，应付 ¥33.50。要下单吗？付款需要你自己完成。
你： 确认。
Agent：（git mcd push --at 12:20 --locker --no-tableware --confirm bfc651c --json）
下好了，请在 12:05 前打开这个链接付款：https://example.com/mcd-git-demo/pay?orderId=1024…
付完跟我说一声，我帮你查取餐码。
```
**和普通 Skill 的区别：确认由代码强制执行。** 普通 Skill 只是一段提示词，Agent 手里有 MCP 连接器就能随时直接调 `create-order`。mcd-git 的 Skill 不需要给 Agent 配 MCP 连接器，Token 只给 mcd-git 用，Agent 手里只有 `git mcd` 这一套命令：下单必须先出确认摘要，再用 `--confirm ` 执行；哈希、参数、重新算出的应付金额，任何一项和预览时对不上，代码都会拒绝。代码保证的是这三件事：一定先出预览，确认时不能换参数，价格会复核。至于 Agent 有没有先把摘要拿给你看、等你点头，代码分辨不出来，这一步靠 SKILL.md 的规则约束 Agent。
## 1024 特别版：生成你的吃麦贡献图
把吃麦记录（最多过去一年）画成一张卡片，有三种样式，用 `--style` 选：
- **麦门天际线**（`skyline`，默认）：等距 3D，最多 53 周 × 7 天，每天吃了几次就叠几层汉堡（底面包、肉饼、芝士、生菜、顶面包），超过 4 层只画 4 层、顶上标一个「+」；10-24 那格插一面「0x400」小旗。打开时汉堡按周从左到右落下叠好，只播一次、3 秒内停在完整状态，系统开了「减弱动态效果」就直接显示完成状态。默认深色夜景，浅色模式下换成奶油底。宽版，适合贴在 GitHub 个人主页。
- **年度吃麦小票**（`receipt`）：竖版热敏小票，最常点 TOP 5 当商品行，中间一块点阵热力图（红圈是 10-24），下面是时段分布、TOTAL 和一根装饰条形码。适合发朋友圈、小红书。
- **平面格子**（`grid`）：GitHub 风格的 7 行 × 53 周格子，颜色深浅表示那天吃了几单，10-24 那格单独描边。最朴素，放进文档里也不扎眼。
平面格子（--style grid）
真实卡片从你最早一单开始画（最少 12 周，最多 53 周），随使用越来越满：麦当劳接口只给最近 10 单，更早的要靠本机账本慢慢攒；10-24 不在画出来的这几周里时，天际线不插小旗、小票不画红圈（天际线底部那格「10-24 / Happy 0x400 Day」是 1024 特别版的固定标语，一直都在）。上面三张是 demo 一年的合成数据，所以是满的；平面格子固定画 53 周。
终端里先出预览（终端画不出 3D，天际线和格子都用格子预览；小票直接打印文字版），同时在本机写一个 SVG：自包含（不引用外部字体、图片和脚本，重复的图形用 `` + `