@kunlv/atdc 1.0.0

package/central/ticket_center_server/.test_plans/task-238389-qyin-vip-limit-self-test-plan.md

@@ -0,0 +1,210 @@
+# task-238389-qyin-vip-limit 自测计划（可执行版）
+
+> 目标：验证 Q音绿钻发货出站 Redis 全局限流（挂载 `callTencentMusicAPI`）。  
+> 分支：`TASK-238389_QYinVipLimit`  
+> Change：`openspec/changes/archive/task-238389-qyin-vip-limit/`  
+> 变量：`<HOST>` 替换为测试环境（如 `http://127.0.0.1:8080` 或内网 ticketcenter 域名）。
+
+---
+
+## 第零步：测试前准备
+
+### 0.1 代码与单测（无环境依赖，先跑）
+
+```bash
+cd /Users/lvkun/Documents/Codes/ticket_center_server.TASK-238389_QYinVipLimit
+go build ./service/rtconf/ ./service/redis/ ./service/rpc/
+go test ./service/rtconf/ ./service/rpc/ \
+  -run 'ApolloQMusicVipDeliveryLimiter|EnforceQMusicVipDeliveryRateLimit|ParseDeliveryResponse' \
+  -count=1
+# 预期：PASS
+```
+
+### 0.2 Apollo 配置
+
+Key：`ApolloQMusicVipDeliveryLimiterConf`
+
+```json
+{
+  "switch": 0,
+  "qps_limit": 200
+}
+```
+
+联调限流时改为：
+
+```json
+{
+  "switch": 1,
+  "qps_limit": 2
+}
+```
+
+> `qps_limit=2` 便于人工打满；验完改回 `200` 或 `switch=0`。
+
+### 0.3 Redis 观察（可选）
+
+```bash
+# 限流 key（跨 Pod 全局）
+redis-cli -c GET qmusic:vip:delivery:qps
+# 或按集群实际命令查看 redis_rate 相关 key（AllowPerSecond 写入）
+```
+
+### 0.4 预置测试单（需真实可发货绿钻单）
+
+| 变量 | 说明 |
+|------|------|
+| `<USERID>` | 已支付且含 Q音绿钻权益的 userid |
+| `<ORDER_NO>` | 对应 order_no（订单 status=已支付） |
+| 验收 | `user_ticket_rights`：QY `right_type=4` 且发放成功 `status=1`（以环境表结构为准） |
+
+```sql
+-- 按库表分片规则查询（示例，库名/表后缀按 userid 分片改）
+SELECT id, userid, order_no, right_type, status, out_order_no, sync_status
+FROM user_ticket_rights_X
+WHERE userid = <USERID> AND order_no = '<ORDER_NO>';
+```
+
+### 0.5 环境变量
+
+```bash
+export HOST=http://127.0.0.1:8080
+export USERID=<USERID>
+export ORDER_NO=<ORDER_NO>
+```
+
+---
+
+## 链 1：单测与语义回归（无外部依赖）
+
+| # | 测试场景 | 触发方式 | 预期结果 | 验证方法 | 状态 |
+|---|---------|---------|---------|---------|:--:|
+| 1.1 | 配置默认关闭且 QPS&lt;300 | `go test ./service/rtconf/ -run ApolloQMusicVipDeliveryLimiter -count=1` | PASS | 终端 PASS | ☐ |
+| 1.2 | 限流：关/放行/拒绝/fail-open | `go test ./service/rpc/ -run EnforceQMusicVipDeliveryRateLimit -count=1` | 4 用例 PASS | 终端 PASS | ☐ |
+| 1.3 | 未知码仍为 Retry(3) | `go test ./service/rpc/ -run ParseDeliveryResponse -count=1` | 未知码 status=Retry，非 Shipped | 终端 PASS | ☐ |
+
+---
+
+## 链 2：Apollo 开关与热更新
+
+| # | 测试场景 | 触发方式 | 预期结果 | 验证方法 | 状态 |
+|---|---------|---------|---------|---------|:--:|
+| 2.1 | 默认关闭不限流 | Apollo 设 `{"switch":0,"qps_limit":200}` 后发 1 次 SendVip（见链 3） | 无 `rate limited` 日志 | `grep -E "rate limited\|fail-open" <日志>` 无命中 | ☐ |
+| 2.2 | 打开限流且 QPS=2 | Apollo 改为 `{"switch":1,"qps_limit":2}`（等 Watch 生效约数秒） | 后续请求受配额约束 | 链 3.2 | ☐ |
+| 2.3 | 紧急关闭 | Apollo 改回 `"switch":0` | 立即不再限流 | 再发 SendVip 无 rate limited | ☐ |
+
+---
+
+## 链 3：内部发货接口 `POST /v1/ticket_rights/send_vip`
+
+> 路由：`CheckServerSignature`（服务端签名，非客户端 kugo signature）。  
+> 网关侧常见路径：`/inner/v1/ticket_rights/send_vip` → 服务 `/v1/ticket_rights/send_vip`。  
+> 以下 curl 需带环境要求的 **Server Signature**（按现网内部调用方式补 header/query；无签名环境可用已有内调工具）。
+
+### 3.1 Switch=0：正常发放（或幂等成功）
+
+```bash
+# 按内部约定补签名后执行；body 示例：
+curl -s -X POST "${HOST}/v1/ticket_rights/send_vip" \
+  -H 'Content-Type: application/json' \
+  -d "{\"userid\":${USERID},\"order_no\":\"${ORDER_NO}\"}"
+# 预期：errcode=0 / 业务成功；或已发放幂等成功
+```
+
+| # | 测试场景 | 触发方式 | 预期结果 | 验证方法 | 状态 |
+|---|---------|---------|---------|---------|:--:|
+| 3.1 | 关闭限流可发货 | 上方 curl（Switch=0） | 成功或幂等成功 | 响应 + SQL 权益 status | ☐ |
+| 3.2 | QPS=2 打满后拒绝 | Switch=1,qps=2；1 秒内连续 curl ≥5 次 | 部分失败；日志含 `qmusic vip delivery rate limited` 或 `callTencentMusicAPI rate limited` | `grep "rate limited" <日志>` | ☐ |
+| 3.3 | 限流失败不落成功态 | 对未发放成功的单，在 3.2 失败后查库 | 不得仅因限流写成绿钻发货成功；亦不得写成永久不允许(status=4) | SQL 查 rights / 订单 sync | ☐ |
+| 3.4 | 稍后重试可成功 | 等待 >1s 或调高 qps 后再 curl 1 次 | 可重试成功（配额恢复） | 响应成功 + 权益 status=1 | ☐ |
+
+### 3.2 压测观察脚本（可选）
+
+```bash
+# 1 秒内连打 10 次（仍需补 Server Signature）
+for i in $(seq 1 10); do
+  curl -s -X POST "${HOST}/v1/ticket_rights/send_vip" \
+    -H 'Content-Type: application/json' \
+    -d "{\"userid\":${USERID},\"order_no\":\"${ORDER_NO}\"}" &
+done
+wait
+grep -E "rate limited|fail-open|callTencentMusicAPI" <应用日志路径>
+```
+
+---
+
+## 链 4：CLI 补单 `rights_grant_check`（限流主战场）
+
+| # | 测试场景 | 触发方式 | 预期结果 | 验证方法 | 状态 |
+|---|---------|---------|---------|---------|:--:|
+| 4.1 | 低 QPS 下补单出现限流 | Apollo `switch=1,qps_limit=2`；`./bin/cli rights_grant_check -t=100 -i=0 -w=8`（按环境调整） | 日志出现 `rate limited`；不把失败单标成功 | grep 日志；抽查 rights 表 | ☐ |
+| 4.2 | 关闭限流后积压消化 | Apollo `switch=0` 或 `qps_limit=200`；再跑同一 CLI | 待发放绿钻逐步成功 | 积压条数下降 / status 变成功 | ☐ |
+| 4.3 | 并发不超对方 300（观察） | `qps_limit=200`；多库 job 并行（如 `-i=0..7`） | 对 Q音出站峰值 ≤200（有余量） | 监控/对端或本侧 callTencentMusicAPI done 日志 QPS | ☐ |
+
+```bash
+# 单库示例
+./bin/cli rights_grant_check -t=100 -i=0 -w=8
+# 多库（运维脚本按实际）
+# for i in 0 1 2 3 4 5 6 7; do ./bin/cli rights_grant_check -t=100 -i=$i -w=8 & done; wait
+```
+
+---
+
+## 链 5：回收路径不受影响（回归）
+
+| # | 测试场景 | 触发方式 | 预期结果 | 验证方法 | 状态 |
+|---|---------|---------|---------|---------|:--:|
+| 5.1 | 退会员/回收不走发货限流 | 对已发绿钻单走既有 `POST /v1/ticket_rights/refund_vip`（按环境签名） | 回收逻辑仍按原链路；日志无发货 rate limited（除非另有回收限流） | 响应 + 日志 | ☐ |
+
+> 本期规格：**仅** `callTencentMusicAPI`（发货）限流，不含 `callTencentMusicRecoveryAPI`。
+
+---
+
+## 执行顺序建议
+
+1. 链 1（单测）→ 2.1（确认默认关）  
+2. 准备 `<USERID>/<ORDER_NO>` → 3.1  
+3. 调 Apollo QPS=2 → 3.2 / 3.3 / 3.4  
+4. 链 4 CLI 压限流与恢复  
+5. 链 5 回收回归  
+6. Apollo 恢复：`switch=0` 或 `qps_limit=200`
+
+---
+
+## 快速回归命令
+
+```bash
+go build ./service/rtconf/ ./service/redis/ ./service/rpc/
+go test ./service/rtconf/ ./service/rpc/ \
+  -run 'ApolloQMusicVipDeliveryLimiter|EnforceQMusicVipDeliveryRateLimit|ParseDeliveryResponse' \
+  -count=1
+
+# 日志关键词
+grep -E "qmusic vip delivery rate limited|callTencentMusicAPI rate limited|rate check failed, fail-open" <日志文件>
+```
+
+---
+
+## 接口与入口速查
+
+| 类型 | 路径/命令 | 说明 |
+|------|-----------|------|
+| HTTP | `POST /v1/ticket_rights/send_vip` | `CheckServerSignature`；内调常经 `/inner/...` |
+| CLI | `rights_grant_check` | 延迟发放扫表 → `rpc.SendSvip` → 绿钻出站 |
+| CLI | `resend_qmusic_svip` | CSV 补发（可选回归） |
+| 出站门禁 | `callTencentMusicAPI` → `enforceQMusicVipDeliveryRateLimit` | Redis key `qmusic:vip:delivery:qps` |
+| Apollo | `ApolloQMusicVipDeliveryLimiterConf` | `switch` + `qps_limit` |
+
+---
+
+## Phase 1 确认
+
+文档与集成测试均已生成：
+
+- 📄 `docs/test_plans/task-238389-qyin-vip-limit-self-test-plan.md`
+- 🧪 `service/biz/rights/rights_qmusic_vip_limit_integration_test.go`
+
+```bash
+go test -run TestKugoBuildSignature ./service/biz/rights/ -count=1
+go test -run "TestQyinVipLimitInt_L1S1" ./service/biz/rights/ -count=1 -v   # 需 QYIN_VIP_LIMIT_LIVE=1
+```

package/commands/claude/atd.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/GO.md，然后根据以下输入开始执行：
+
+$ARGUMENTS

package/commands/claude/atdc/1-spec.md

@@ -0,0 +1,5 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/1-spec.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 1-spec 阶段：需求澄清 + 规格生成。
+
+用户需求：$ARGUMENTS

package/commands/claude/atdc/1-update.md

@@ -0,0 +1,5 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/1-update.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 1-update 阶段：对当前活跃 change 的需求文档进行变更。
+
+用户变更说明：$ARGUMENTS

package/commands/claude/atdc/2-qa.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/2-qa.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 2-qa 阶段：对当前活跃 change 规格进行逐维度质疑检验。

package/commands/claude/atdc/3-impl-skip-spec.md

@@ -0,0 +1,5 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/3-impl.md，然后直接开始执行。
+
+跳过 GO.md 路由和 propose 阶段，直接进入 3-impl 阶段（--skip-spec 模式）：需求已清楚，跳过规格文档直接实现。
+
+用户需求：$ARGUMENTS

package/commands/claude/atdc/3-impl.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/3-impl.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 3-impl 阶段：按规格文档实现（缺 proposal/tasks/specs 则拦截）。从 .progress.json 恢复断点或从头开始。

package/commands/claude/atdc/4-verify.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/4-verify.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 4-verify 阶段：C3 验收，逐条核查 SHALL/MUST。

package/commands/claude/atdc/5-done.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/5-done.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 5-done 阶段：归档 change + 写 caveman 记忆条目。

package/commands/claude/atdc/add-command.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-add-command.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/add-to-hc.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-add-to-hc.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 add-to-hc 阶段：按模板生成 HTTP Client 条目并插入 external_routes.http。

package/commands/claude/atdc/analysis-cls-log.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-analysis-cls-log.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/article.md

@@ -0,0 +1,6 @@
+---
+description: 阶段6：生成图文技术文章（3 skill 强制 + 配图生成 + 规范润色），跳过自动路由
+---
+请用 Read 工具读取 ${ATDC_DIR}/prompts/6-article.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 6-article 阶段：强制加载 article-writing / chinese-content-writing-guideline / humanizer-zh 三个 skill，生成配图并输出图文结合的技术分享文章。

package/commands/claude/atdc/bugfix.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/3-impl-bugfix.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/code-simplifier.md

@@ -0,0 +1,8 @@
+---
+description: 代码简化（基于 code-simplifier skill），跳过自动路由
+---
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-code-simplifier.md，然后根据以下输入开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进行代码简化。

package/commands/claude/atdc/commit.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-commit.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/compound.md

@@ -0,0 +1,5 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-compound.md，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进行知识沉淀。无参数时进入交互模式。

package/commands/claude/atdc/context.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-context-scan.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 context 阶段：首次入场扫描，生成项目全景文档 CONTEXT.md。

package/commands/claude/atdc/diagnose.md

@@ -0,0 +1,8 @@
+---
+description: 结构化调试循环（复现→最小化→假设→插桩→修复→回归）。用法 /atdc:diagnose <bug描述>
+---
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-diagnose.md，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进入结构化调试循环。

package/commands/claude/atdc/git-guardrails.md

@@ -0,0 +1,18 @@
+---
+description: Git 安全防护（安装/检查 pre-push hook，拦截危险命令）。用法 /atdc:git-guardrails [install|check]
+---
+执行以下步骤：
+
+1. 检查 hook 是否已安装：
+```bash
+ls -la .git/hooks/pre-push 2>/dev/null && echo "✅ 已安装" || echo "❌ 未安装"
+```
+
+2. 如果用户说 `install` 或未安装：
+```bash
+ln -sf ~/atdc/hooks/guardrails.sh .git/hooks/pre-push && echo "✅ git-guardrails 已安装"
+```
+
+3. 输出当前防护状态（参考 reference/git-guardrails.md 说明规则）
+
+$ARGUMENTS

package/commands/claude/atdc/grill-with-docs.md

@@ -0,0 +1,8 @@
+---
+description: 深度拷问 + 文档沉淀（挑战领域模型、更新CONTEXT.md、生成ADR）。用法 /atdc:grill-with-docs [<change-name>]
+---
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-grill-with-docs.md，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进入深度拷问 + 文档沉淀。

package/commands/claude/atdc/handoff.md

@@ -0,0 +1,8 @@
+---
+description: 会话交接文档生成（决策上下文、关键文件、未解决问题）。用法 /atdc:handoff [<change-name>]
+---
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-handoff.md，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接生成交接文档。

package/commands/claude/atdc/health.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-health.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进行项目健康巡检。

package/commands/claude/atdc/learn.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-learn.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/review.md

@@ -0,0 +1,10 @@
+---
+description: 代码级 review（CRG + CodeGraph 双引擎：blast radius + 风险评分 + 测试缺口 + 受影响流程 + 架构洞察），跳过自动路由
+---
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-review.md，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进行代码级 review。无参数时执行全量 review。
+
+子模式：delta=仅变更 | pr=PR review | gaps=仅测试缺口 | flows=仅受影响流程 | arch=架构健康检查 | crg=CRG 深度分析

package/commands/claude/atdc/search.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-search.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/strategy.md

@@ -0,0 +1,3 @@
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-strategy.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接创建或更新 STRATEGY.md。

package/commands/claude/atdc/table2xlsx.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-table2xlsx.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/test-plan.md

@@ -0,0 +1,5 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-test-plan.md，然后直接开始执行。
+
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/travel-planner.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-travel-planner.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/xlsx2sql-insert.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-xlsx2sql-insert.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/xlsx2sql-update.md

@@ -0,0 +1,4 @@
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-xlsx2sql-update.md，然后直接开始执行。
+跳过 GO.md 路由。
+
+$ARGUMENTS

package/commands/claude/atdc/zoom-out.md

@@ -0,0 +1,8 @@
+---
+description: 代码全景分析（系统定位、数据流、影响面、架构一致性）。用法 /atdc:zoom-out <文件/函数/模块>
+---
+请用 Read 工具读取 ${ATDC_DIR}/prompts/X-zoom-out.md，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进行代码全景分析。

package/commands/codex/atdc/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd
+description: 触发atdc工作流（propose/execute/health/scan）。Read GO.md路由。触发词：/flow、atdc、走流程。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/GO.md`，然后根据用户输入的需求开始执行。
+
+无额外参数时，GO.md 的 Step 1 会自动检测当前项目有无活跃 change，路由到对应阶段（propose / execute / verify / archive / health）。

package/commands/codex/atdc-1-spec/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:1-spec
+description: 阶段1：需求→规格文档（proposal+tasks+specs）。触发词：1-spec、生成规格、propose。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/1-spec.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 1-spec 阶段：需求澄清 + 规格生成。

package/commands/codex/atdc-1-update/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:1-update
+description: 阶段1-Update：变更已有change需求文档。触发词：1-update、变更需求、update。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/1-update.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 1-update 阶段：对当前活跃 change 的需求文档进行变更。

package/commands/codex/atdc-2-qa/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:2-qa
+description: 阶段2：质疑规格（隐性假设/边界/依赖/ADR）。触发词：2-qa、质疑一下、grill。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/2-qa.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 2-qa 阶段：对当前活跃 change 规格进行逐维度质疑检验。

package/commands/codex/atdc-3-impl/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:3-impl
+description: 阶段3：按规格实现（缺文档则拦截，支持断点恢复）。触发词：3-impl、执行、execute。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/3-impl.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 3-impl 阶段：按规格文档实现（缺文件则拦截）。从 .progress.json 恢复断点或从头开始。

package/commands/codex/atdc-3-impl-skip-spec/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:3-impl-skip-spec
+description: 阶段3-skip-spec：跳过规格直接实现。触发词：skip-spec、跳过规格、plan-dev。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/3-impl.md`，然后直接开始执行。
+
+跳过 GO.md 路由和 propose 阶段，直接进入 3-impl 阶段（--skip-spec 模式）：需求已清楚，跳过规格文档直接实现。

package/commands/codex/atdc-4-verify/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:4-verify
+description: 阶段4：C3验收（逐条核查SHALL/MUST）。触发词：4-verify、验收、verify。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/4-verify.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 4-verify 阶段：C3 验收，逐条核查 SHALL/MUST。

package/commands/codex/atdc-5-done/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:5-done
+description: 阶段5：归档change+写记忆条目。触发词：5-done、归档、archive。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/5-done.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 5-done 阶段：归档 change + 写 caveman 记忆条目。

package/commands/codex/atdc-add-command/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: atd:add-command
+description: 新增atdc命令（一键4端同步）。触发词：add-command、新增命令。
+---
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-add-command.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进行 新增 atdc 命令。

package/commands/codex/atdc-add-to-hc/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:add-to-hc
+description: 添加API接口到.hc HTTP Client测试文件。触发词：add-to-hc、加接口。
+---
+
+用 Read 工具读取 ${ATDC_DIR}/prompts/X-add-to-hc.md，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 add-to-hc 阶段：按模板生成 HTTP Client 条目并插入 external_routes.http。

package/commands/codex/atdc-analysis-cls-log/SKILL.md

@@ -0,0 +1,5 @@
+---
+name: atd:analysis-cls-log
+description: CLS日志分析。触发词：analysis-cls-log、分析CLS日志、/atdc:analysis-cls-log。
+---
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-analysis-cls-log.md`，然后直接开始执行。

package/commands/codex/atdc-article/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:article
+description: 生成图文技术文章（3 skill+配图+润色）。触发词：article、生成文章、写文章。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/6-article.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 6-article 阶段：强制加载三个 skill，生成配图并输出图文结合的技术分享文章到 Obsidian 知识库。

package/commands/codex/atdc-bugfix/SKILL.md

@@ -0,0 +1,5 @@
+---
+name: atd:bugfix
+description: Bugfix 5-Phase 流程。触发词：bugfix、修Bug、/atdc:bugfix。
+---
+用 Read 工具读取 `${ATDC_DIR}/prompts/3-impl-bugfix.md`，然后直接开始执行。

package/commands/codex/atdc-code-simplifier/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: atd:code-simplifier
+description: Simplify/clean up code after coding sessions. 触发词：code-simplifier、simplify、简化代码。
+---
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-code-simplifier.md`，然后根据参数开始执行。
+
+跳过 GO.md 路由，直接进行代码简化。

package/commands/codex/atdc-commit/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: atd:commit
+description: Git Commit Message规范化生成。触发词：commit、提交信息、写commit。
+---
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-commit.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进行 Git Commit Message 规范化生成。

package/commands/codex/atdc-compound/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:compound
+description: 知识沉淀（docs/solutions/+CONCEPTS.md）。触发词：compound、沉淀知识。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-compound.md`，然后根据参数开始执行。
+
+跳过 GO.md 路由，直接进行知识沉淀。无参数时进入交互模式。

package/commands/codex/atdc-context/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: atd:context
+description: 首次入场扫描→生成CONTEXT.md全景文档。触发词：context、扫描项目、scan。
+---
+
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-context-scan.md`，然后直接开始执行。
+
+跳过 GO.md 路由，直接进入 context 阶段：首次入场扫描，生成项目全景文档 CONTEXT.md。

package/commands/codex/atdc-diagnose/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: atd:diagnose
+description: 结构化调试（复现→最小化→假设→插桩→修复→回归）。触发词：diagnose、诊断、debug。
+---
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-diagnose.md`，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进入结构化调试循环。

package/commands/codex/atdc-git-guardrails/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: atd:git-guardrails
+description: Git安全防护（拦截push main/force push/WIP）。触发词：git-guardrails、git防护。
+---
+执行以下步骤：
+
+1. 检查 hook 是否已安装：
+```bash
+ls -la .git/hooks/pre-push 2>/dev/null && echo "✅ 已安装" || echo "❌ 未安装"
+```
+
+2. 如果用户说 `install` 或未安装：
+```bash
+ln -sf ~/atdc/hooks/guardrails.sh .git/hooks/pre-push && echo "✅ git-guardrails 已安装"
+```
+
+3. 输出当前防护状态（参考 reference/git-guardrails.md 说明规则）
+
+$ARGUMENTS

package/commands/codex/atdc-grill-with-docs/SKILL.md

@@ -0,0 +1,9 @@
+---
+name: atd:grill-with-docs
+description: 深度拷问plan+更新CONTEXT+生成ADR。触发词：grill-with-docs、深度拷问。
+---
+用 Read 工具读取 `${ATDC_DIR}/prompts/X-grill-with-docs.md`，然后根据以下参数开始执行：
+
+$ARGUMENTS
+
+跳过 GO.md 路由，直接进入深度拷问 + 文档沉淀。