mirror of
https://github.com/claude-code-best/claude-code.git
synced 2026-06-18 14:25:51 +00:00
8945f08708
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>
141 lines
6.5 KiB
Markdown
141 lines
6.5 KiB
Markdown
# AUTOFIX-PR-001: 恢复 `/autofix-pr` 命令实现
|
||
|
||
| 字段 | 值 |
|
||
|---|---|
|
||
| **Issue Type** | Story |
|
||
| **Priority** | High |
|
||
| **Component** | Slash Commands / Remote Agent (CCR) |
|
||
| **Reporter** | unraid |
|
||
| **Assignee** | Claude Opus 4.7 |
|
||
| **Sprint** | 2026-04 W4 |
|
||
| **Story Points** | 8 |
|
||
| **Branch** | `feat/autofix-pr` |
|
||
| **Worktree** | `E:\Source_code\Claude-code-bast-autofix-pr` |
|
||
| **Base Commit** | `4f1649e2` (origin/main) |
|
||
| **Status** | In Progress |
|
||
| **Spec Document** | `docs/features/autofix-pr.md` |
|
||
|
||
---
|
||
|
||
## Summary
|
||
|
||
将 `src/commands/autofix-pr/index.js` 的 stub（`{isEnabled:()=>false, isHidden:true, name:'stub'}`）替换为完整 LocalJSXCommand 实现，让用户能在 fork 仓库内通过 `/autofix-pr <PR#>` 派发 CCR 远程 session 自动修复 PR 上的 CI 失败，含跨仓库语法 `<owner>/<repo>#<n>`。
|
||
|
||
## User Story
|
||
|
||
**As a** 在 fork 仓库工作的开发者
|
||
**I want** 通过 `/autofix-pr 386` 触发远端 Claude session 自动修复 PR 上的 CI 失败并 push 回 PR 分支
|
||
**So that** 我不用切到 web/手动跑 lint/typecheck 修复就能让 PR 变绿
|
||
|
||
## 背景
|
||
|
||
本仓库是 Anthropic 官方 `@anthropic-ai/claude-code` 的反编译/重构版本。`/autofix-pr` 在 fork 中被 stub 化，导致斜杠菜单不可见、不可调起。仓库内远程派发基础设施（teleportToRemote、RemoteAgentTask、reviewRemote.ts 模板）完整可用。
|
||
|
||
实施基于 `claude.exe` 反编译产物的黄金证据，照抄 `reviewRemote.ts` 模板按 §2.2 差异表改造。
|
||
|
||
## 验收标准 (Acceptance Criteria)
|
||
|
||
| ID | 标准 | 验收方法 |
|
||
|---|---|---|
|
||
| AC1 | 命令在斜杠菜单可见可调起 | dev 模式输入 `/au` 出现 `/autofix-pr` 补全 |
|
||
| AC2 | 跨仓 PR 语法生效 | `/autofix-pr anthropics/claude-code#999` 不报 repo-not-allowed |
|
||
| AC3 | 远端真正完成修复 | session 完成后目标 PR 出现新 commit |
|
||
| AC4 | 不破坏其他 stub | `/share` 等保持 hidden |
|
||
| AC5 | TypeScript 严格模式 0 错误 | `bun run typecheck` exit 0 |
|
||
| AC6 | bridge 可触发 | RC bridge 触发 `/autofix-pr 386` 能跑通 |
|
||
| AC7 | stop 子命令终止 | `/autofix-pr stop` 后任务被 abort，单例锁释放 |
|
||
| AC8 | 单例锁生效 | 已监控 PR 时第二次启动被拒，提示 `Run /autofix-pr stop first` |
|
||
| AC9 | 测试覆盖 | 4 份测试文件全过；新增模块行覆盖率 ≥ 80% |
|
||
| AC10 | bun:test 全绿 | `bun test` exit 0 |
|
||
|
||
## 子任务 (Subtasks)
|
||
|
||
| Step | 任务 | 文件 | 行数估计 |
|
||
|---|---|---|---|
|
||
| 1 | 加 `AUTOFIX_PR` feature flag | `scripts/defines.ts` | +1 |
|
||
| 2 | `teleportToRemote` 加 `source?: string` 字段并透传到 sessionContext | `src/utils/teleport.tsx` | +5 |
|
||
| 3 | 删 stub，新建命令对象 | `src/commands/autofix-pr/{index.js→.ts}` (删 index.d.ts) | ~50 |
|
||
| 4 | 参数解析 | `src/commands/autofix-pr/parseArgs.ts` | ~30 |
|
||
| 5 | 单例锁状态管理 | `src/commands/autofix-pr/monitorState.ts` | ~40 |
|
||
| 6 | 后台 teammate 创建 | `src/commands/autofix-pr/inProcessAgent.ts` | ~60 |
|
||
| 7 | 项目 skills 探测 | `src/commands/autofix-pr/skillDetect.ts` | ~30 |
|
||
| 8 | 主流程（照抄 reviewRemote.ts） | `src/commands/autofix-pr/launchAutofixPr.ts` | ~250 |
|
||
| 9 | 测试套件（4 文件） | `src/commands/autofix-pr/__tests__/*.test.ts` | ~150 |
|
||
| 10 | typecheck + test:all 全绿 | — | — |
|
||
| 11 | dev 模式手测四种调用 | — | — |
|
||
|
||
## 关键差异（vs `reviewRemote.ts`）
|
||
|
||
| 字段 | reviewRemote (ultrareview) | launchAutofixPr |
|
||
|---|---|---|
|
||
| `environmentId` | `env_011111111111111111111113` | 不传 |
|
||
| `useDefaultEnvironment` | 不传 | `true` |
|
||
| `useBundle` | 有（branch mode） | 不传 |
|
||
| `skipBundle` | 不传 | （隐含；不传 useBundle 即可） |
|
||
| `reuseOutcomeBranch` | 不传 | 传（PR head 分支） |
|
||
| `githubPr` | 不传 | 必传 `{owner, repo, number}` |
|
||
| `source` | 不传 | `'autofix_pr'`（新增字段） |
|
||
| `environmentVariables` | `BUGHUNTER_*` 一组 | 不传 |
|
||
| `remoteTaskType` | `'ultrareview'` | `'autofix-pr'` |
|
||
| `isLongRunning` | false | `true` |
|
||
|
||
## 仓库现状盘点
|
||
|
||
`teleport.tsx` line 947 起的 options interface **已含**: `useDefaultEnvironment` / `onBundleFail` / `skipBundle` / `reuseOutcomeBranch` / `githubPr`。**仅缺** `source` 一个字段。`REMOTE_TASK_TYPES` (line 99) 已含 `'autofix-pr'`，`AutofixPrRemoteTaskMetadata` (line 112) 已定义，`registerRemoteAgentTask` 已 export 并支持 `isLongRunning`。
|
||
|
||
## Telemetry 事件
|
||
|
||
```
|
||
tengu_autofix_pr_started { action, has_pr_number, has_repo_path }
|
||
tengu_autofix_pr_result { result: success_rc|failed|cancelled, error_code? }
|
||
```
|
||
|
||
`error_code` 取值：`rc_already_monitoring_other` / `session_create_failed` / `exception`
|
||
|
||
## Definition of Done
|
||
|
||
- [ ] 全部 11 步实施完成
|
||
- [ ] `bun run typecheck` exit 0（零类型错误）
|
||
- [ ] `bun test` exit 0（含新增 4 份测试）
|
||
- [ ] 新增模块行覆盖率 ≥ 80%
|
||
- [ ] silent-failure-hunter / state-modeler 检查通过
|
||
- [ ] code-reviewer + security-reviewer 无 CRITICAL/HIGH
|
||
- [ ] `/ask-codex` 交叉复核无遗漏问题
|
||
- [ ] dev 模式 4 种调用手测通过（PR# / stop / 跨仓 / 重复锁拒绝）
|
||
- [ ] commit message: `feat: implement /autofix-pr command (replace stub)`
|
||
|
||
## 风险
|
||
|
||
| 风险 | 影响 | 缓解 |
|
||
|---|---|---|
|
||
| `source` 字段 CCR backend 未识别 | session 仍可创建但 routing 信息缺失 | 字段为可选透传，无副作用；后端识别后自动生效 |
|
||
| `subscribePR` API client 不全 | webhook 订阅失败 | `.catch(()=>{})` 容忍 |
|
||
| 用户无 CCR 权限 | `checkRemoteAgentEligibility` false | 降级错误文案，不破坏会话 |
|
||
| PR 在 fork 仓且 CCR 没访问权 | `git_repository source error` | 前置检查识别并提示用户 |
|
||
| 上游恢复官方实现冲突 | merge 冲突 | fork 本地优先，吸收 source/env 字段变更 |
|
||
|
||
## 依赖
|
||
|
||
- `teleportToRemote` (`src/utils/teleport.tsx:947`)
|
||
- `registerRemoteAgentTask` (`src/tasks/RemoteAgentTask/RemoteAgentTask.tsx:526`)
|
||
- `checkRemoteAgentEligibility` / `getRemoteTaskSessionUrl` / `formatPreconditionError`
|
||
- `detectCurrentRepositoryWithHost` (`src/utils/detectRepository.ts`)
|
||
- `feature` from `bun:bundle`
|
||
|
||
## 回退
|
||
|
||
```bash
|
||
# 完全撤回
|
||
git checkout main
|
||
git worktree remove E:/Source_code/Claude-code-bast-autofix-pr
|
||
git branch -D feat/autofix-pr
|
||
```
|
||
|
||
`AUTOFIX_PR` flag 在 production 默认开启（加入 `DEFAULT_BUILD_FEATURES`），灰度通过保留官方 `feature('AUTOFIX_PR')` 守卫即可单点关停。
|
||
|
||
## 变更日志
|
||
|
||
| 日期 | 作者 | 说明 |
|
||
|---|---|---|
|
||
| 2026-04-29 | Claude Opus 4.7 | 创建 ticket（基于 `docs/features/autofix-pr.md` 770 行规格） |
|