analyze-pr · diff

git:20260621.f61c536 to git:20261119.92f0209

17 added, 154 removed. Audit C to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

- # Analyze PR
-
- 分析 GitHub Pull Request,评估必要性、描述完整性、验证证据、主要风险与是否可直接合入。
-
- **Repository**: https://github.com/ZhuLinsen/daily_stock_analysis/pulls
-
- ## Usage
-
- ```text
- /analyze-pr <pr_number>
- ```
-
- ## Instructions
-
- 分析时使用简洁中文,优先遵循仓库根目录 `AGENTS.md` 和 `.github/PULL_REQUEST_TEMPLATE.md`。
-
- ### Step 1: 同步最新代码基线
-
- 分析 PR 前必须先刷新远端状态,并尽量把本地安全推进到最新基线:
-
- ```bash
- git status --short
- git fetch --all --prune
- # 仅当工作区干净且当前分支可 fast-forward 时执行:
- git pull --ff-only
- ```
-
- - 只有在工作区干净、当前分支有可 fast-forward 的上游时,才执行并接受 `git pull --ff-only` 的结果。
- - 如存在本地改动、冲突状态、未跟踪风险文件、无上游分支或无法 fast-forward,不要执行 `stash`、`reset`、强制切分支或覆盖本地状态;改用已 fetch 的 `origin/main`、PR head 或 GitHub diff 做分析。
- - 在输出文档的 `Validation Evidence` 中记录同步结果:本地 HEAD、使用的远端基线,以及未更新本地工作树的原因(如有)。
-
- ### Step 2: 拉取 PR 基本信息
-
- ```bash
- gh pr view <pr_number> --repo ZhuLinsen/daily_stock_analysis
- gh pr view <pr_number> --repo ZhuLinsen/daily_stock_analysis --comments
- gh pr checks <pr_number> --repo ZhuLinsen/daily_stock_analysis
- gh pr diff <pr_number> --repo ZhuLinsen/daily_stock_analysis
- ```
-
- 如有失败的 CI,优先查看失败日志,而不是立刻在本地重跑全部检查:
-
- ```bash
- gh run view <run_id> --log-failed
- ```
-
- ### Step 3: 检查标题与描述完整性
-
- 先检查 PR title 是否符合 `AGENTS.md` 的非阻断建议:
-
- - 格式应为 `<类型>: <修改内容>`,例如 `fix: 修复大盘分析历史记录丢失`
- - 类型优先为 `fix`/`feat`/`refactor`/`docs`/`chore`/`test`/`ci`
- - 不应包含 `[codex]`、`codex`、`autocode`、`copilot` 或其他工具/agent 来源前缀
- - 标题应描述实际变更;若标题与 diff 不符,在描述完整性中指出,但不应单独作为 review process blocker。
-
- 对照 `.github/PULL_REQUEST_TEMPLATE.md`,确认是否覆盖:
-
- - `PR Type`
- - `Background And Problem`
- - `Scope Of Change`
- - `Issue Link`
- - `Verification Commands And Results`
- - `Visual Evidence`(仅当 PR 修改报告格式、报告渲染效果或 Web UI 界面时要求截图或替代可视证据)
- - `Compatibility And Risk`
- - `Rollback Plan`
-
- 若 PR 涉及第三方模型 / API 兼容语义、请求参数固定值、OpenAI-compatible 路由、YAML alias、fallback 行为或运行时配置保存 / 清理 / 迁移逻辑,还要额外检查描述里是否明确写出:
-
- - 官方来源链接或公告
- - 当前锁定依赖 / 运行时兼容范围(例如 LiteLLM 版本窗口)
- - 已验证的调用链路覆盖面
- - 旧配置是否会被静默改写、清空、迁移或保持不变
- - 最小回滚路径(通常是 revert 本 PR)
-
- 若 PR 修改报告格式、报告渲染效果或 Web UI 界面,还要检查 `Visual Evidence` 是否附受影响报告 / 页面截图;涉及前后差异时优先检查前后对比。若无法截图,描述中应说明原因与替代可视证据。
-
- ### Step 4: 优先使用 CI / Diff 证据
-
- - 先根据 `gh pr checks`、PR diff、现有测试与工作流日志判断问题
- - 仅当 CI 未覆盖改动面、CI 结果不足以定性问题、或需要验证关键回归风险时,再补充本地最小验证
- - 不要默认切换当前分支或执行 `gh pr checkout`
-
- 如果必须补本地验证,按改动面选择最接近的检查,例如:
-
- - 后端:`./scripts/ci_gate.sh` 或 `python -m py_compile <changed_python_files>`
- - 前端:`cd apps/dsa-web && npm ci && npm run lint && npm run build`
- - 桌面端:先构建 Web,再构建 Electron
-
- ### Step 5: 评估正确性与风险
-
- 重点检查:
-
- - 是否解决了明确问题,且没有夹带无关改动
- - 是否破坏 API / Schema / Web / Desktop 兼容性
- - 是否破坏 fallback、降级路径、通知链路或发布流程
- - 是否存在明显逻辑错误、异常吞没、安全问题、配置语义变化未同步文档
-
- ### Step 6: 生成评审文档
-
- 保存到 `.claude/reviews/prs/pr-<number>.md`
-
- ## Output Document Format
-
- ```markdown
- # PR #<number> Analysis
-
- **Date**: YYYY-MM-DD
- **Status**: Pending Review
-
- ## Findings
-
- - [严重级别] file:line - 问题描述
-
- ## Summary
-
- - 必要性:
- - 是否有对应 issue:
- - PR 类型:
- - PR title:
- - description 完整性:
- - 验证情况:
- - 主要风险:
- - 是否可直接合入:
-
- ## Validation Evidence
-
- - 代码同步基线:
- - CI 结论:
- - 本地补充验证(如有):
-
- ## Compatibility And Risk
-
- - API / Web / Desktop:
- - 配置 / Docker / GitHub Actions:
- - fallback / 通知 / 报告结构:
- - 第三方依赖 / 官方约束来源:
- - 运行时兼容窗口 / 已覆盖链路:
- - 旧配置迁移或静默改写风险:
+ ---
+ name: analyze-pr
+ description: 评估 PR 的实际改动、用户价值、兼容性、可视证据与合入条件。也用于解释单个 PR 或比较一组候选。
+ ---
- ## Draft Review Comment
+ # 分析 PR
- <建议评论内容>
- ```
+ 以仓库根目录 `AGENTS.md` 为准。围绕维护者的问题交付结果。解释一个修复时,用具体例子;批量筛选时,给每个 PR 的价值、当前阻碍和下一步。
- ## Allowed Auto-Actions (No Confirmation Needed)
+ ## 核对当前改动
- - 拉取 PR 元数据、diff、评论和 CI 状态
- - 执行 `git fetch --all --prune`,并在工作区干净且可 fast-forward 时执行 `git pull --ff-only`
- - 阅读相关代码、模板、工作流与文档
- - 在必要时执行最小化本地验证
- - 生成评审文档
+ 1. 按 AGENTS.md 第 8 节同步基线,记录 base、Head SHA。用 `gh pr view <n> --comments`、`gh pr diff <n>`、`gh pr checks <n>` 检查当前版本、改动、历史意见和 CI。评审意见要与对应的提交核对。
+ 2. 按可独立交付的行为拆解 diff,沿实际入口查调用者和消费方。报告哪些文件不在可读 diff 中,哪些结论只来自作者或旧审查。对 fix 核对反例、根因、修复路径和能覆盖原问题的测试。
+ 3. 查 PR 正文、讨论附件和当前 Head 的 Actions 产物。若 `web-gate` 运行,可在该运行的 `web-ui-evidence-<head SHA>` 中找具体页面。检查时打开实际画面,将截图与发生变化的页面、报告或通知状态对应起来。
- ## Actions Requiring Confirmation
+ ## 给维护者的判断
- 执行以下动作前,先询问用户:
+ - **改了什么、为何有价值。** 每项用「谁在什么操作下遇到什么 → 改后会怎样」说明。写清默认是否启用、受益范围与代价,区分实测问题、预防性改进和仍需证实的假设。可独立合入的改动分别判断保留、拆分或延后。
+ - **用户影响。** 明确回答 Web 页面和交互、Desktop 共用界面或原生能力、报告内容与版式、通知展示是否受影响。顺着调用链说明相关 CLI 参数/输出、API 字段、配置默认值、迁移或部署影响。将无影响的入口合并说明依据;不确定处标出验证缺口。
+ - 例如,搜索缓存优化可以用同一批查询的排序与耗时说明价值;后端工具状态字段被问股页面消费时,则要核对失败步骤在页面上如何显示。
+ - **截图。** 有展示变化时给具体页面/状态、证据链接和核验结果。区分「已查看当前版本」「有链接但未查看/过期」「缺证据」。无法截图时核对原因和可复现的替代证据;纯内部变更说明截图不适用的具体原因。单独的 CI 绿灯或测试文件名无法说明画面符合预期。
+ - **合入条件。** 引用当前 Head 的 CI、合并状态、验证缺口及回滚方式。把正确性或兼容性反例定位到代码或测试,说明用户后果。给出“可合入 / 处理指定问题后可合入 / 建议拆分或暂缓”及原因。存在冲突或关键证据待核时,分别说明代码价值与平台状态。
- 1. 发布评论
- 2. Approve PR
- 3. Request changes
- 4. Merge PR
- 5. 关闭 PR
+ 完整审查记录在 `.claude/reviews/prs/pr-<number>.md`,附基线、证据、未验证项。对用户的回复直接给上述判断。发表评论、批准、合入或关闭以用户当次授权为准。