Files
claude-code/docs/jira/STUB-RECOVERY-PLAN.md
unraid 8945f08708 feat: integrate fork work onto upstream main (squashed)
Squash-merge of feat/autofix-pr-test (69 commits) onto upstream/main
with -X ours strategy (upstream as authoritative for content conflicts).

Key features brought in from fork:
- LocalMemoryRecall + VaultHttpFetch tools (end-to-end wired)
- /local-memory, /local-vault, /memory-stores, /skill-store interactive panels
- /agents-platform, /schedule, /vault command scaffolding
- /login: switch / replace / remove of workspace API key
- statusline refactor (built-in status row, /statusline as info command)
- autofix-pr command + workflow

Conflict resolutions (upstream-wins):
- 10 .js command stubs kept from upstream (alongside fork's .ts implementations)
- src/components/BuiltinStatusLine.tsx accepted upstream's deletion
  (fork's wire-up references in StatusLine.tsx will be cleaned up next)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 14:58:26 +08:00

4.8 KiB
Raw Blame History

内部命令解锁与 Stub 恢复总规划

状态:规划阶段 → 即将进入实施 基于:反向查阅 C:/Users/12180/.local/bin/claude.exe v2.1.123 字符串 + fork 代码残留扫描 验收订阅用户视角claude-ai availability所有可恢复命令在 /help 出现且可调用

一、命令分级(基于反向查阅 + 代码残留)

A. 已是完整实现,只需移到主 COMMANDS 数组 — 零代码工作量

命令 行数 性质 订阅用户价值
/bridge-kick 200 bridge 故障注入调试器RC 测试) 中(开发/调试 RC 时)
/init-verifiers 262 创建项目 verifier skillsquality-gate 自动化) quality-gate 高频功能)
/commit 92 git commit 命令 (每天用)
/commit-push-pr 158 commit + push + 创建 PR (高频开发流)

B. 底层完整 + 1 行 stub launcher仿 autofix-pr 模式恢复

命令 底层证据 工作量
/teleport src/utils/teleport.tsx 已 export 5+ utility官方 19 个 tengu_teleport_* 事件可对标 ~150 行 launcher
/share sessions API 已有(订阅 endpoint需 launcher ~150 行

C. 纯本地命令(无需 Anthropic 后端,可自主实现替代)

命令 字面意思 → 自主替代设计 工作量
/env dump 本地 env vars + config白名单字段 ~60 行
/ctx_viz 当前会话 context 可视化messages 数 + token 分布 + role类似系统 CtxInspect 工具 ~100 行
/debug-tool-call 列出最近 N 个 tool call 的 input/output ~80 行
/perf-issue 本地 metrics 导出token 用量、响应延迟、cache hit、tool count写到 ~/.claude/perf-reports/ ~120 行
/break-cache 强制下次请求清空 prompt cache在系统 prompt 后插入 ephemeral cache_control 标记) ~50 行

D. GitHub API 类(订阅用户可用,需 GitHub token

命令 设计 工作量
/issue 创建当前仓库的 GitHub issuegh CLI 或 GraphQL ~150 行

E. 不做(无替代价值或已有等价命令)

命令 不做原因
/onboarding 一次性引导,订阅用户不需要
/bughunter 已被 /ultrareview 完全替代
/good-claude Anthropic 内部反馈收集,无替代价值
/backfill-sessions 需要 Anthropic admin endpointfork 无后端
/ant-trace Anthropic 内部 trace 系统
/agents-platform Anthropic agents platform 集成
/mock-limits QA 内部测试用
/reset-limits / /reset-limits-non-interactive 需要 Anthropic admin endpoint 重置用户配额

二、实施顺序(全自主执行)

Phase 1零代码移动5 分钟) 立即收益最大

操作:从 INTERNAL_ONLY_COMMANDS 移到主 COMMANDS 数组:

  • commit
  • commitPushPr
  • bridgeKick
  • initVerifiers

仅改 src/commands.ts 一处。

Phase 2仿 autofix-pr 模式恢复(约 2 小时)

  • Step 2.1/teleport launcher最易底层全在
  • Step 2.2/share launcher

Phase 3纯本地命令约 2 小时)

  • Step 3.1/env
  • Step 3.2/ctx_viz
  • Step 3.3/debug-tool-call
  • Step 3.4/perf-issue
  • Step 3.5/break-cache

Phase 4GitHub 类(约 30 分钟)

  • Step 4.1/issue

Phase 5验证

  • bun run typecheck0 错误
  • bun test:现有测试不破坏 + 新命令测试通过
  • bun run build:生成 dist
  • bun --feature ...verify-*.ts:每个新命令的注册验证脚本

三、风险与回退

风险 缓解
移到主数组后,命令依赖 Anthropic 内部 API 才能工作(如 /bridge-kick 命令对象设 isHidden: false 但保留环境检查逻辑(如 RC 未启动时报错友好)
/commit 命令与用户 git workflow 冲突 先看 commit.ts 现状(已 92 行实现),不动逻辑,只改注册
/teleport/autofix-pr 类似的 source 字段问题 复用 /autofix-pr 学到的 lock pattern + skipBundle 决策
反向查阅误判(某命令官方公开但实际依赖内部 API 命令实现失败时给清晰错误文案,不破坏会话

四、验收标准(订阅用户视角)

  • /help 中显示新增/解锁的命令
  • /au Tab 出现 /autofix-pr 补全(已修,待验证)
  • /te Tab 出现 /teleport 补全
  • /com Tab 出现 /commit/commit-push-pr
  • /init-verifiers 跑出 verifier skill 创建提示
  • /env 显示当前 env / config
  • bun run typecheck 0 错误
  • bun test 全过

变更日志

日期 改动
2026-04-29 初版规划(基于反向查阅 v2.1.123 + 代码残留扫描)