Finagent

Analyze Issue

分析 GitHub Issue，判断其真实性、优先级、仓库责任边界与建议动作。

Repository: https://github.com/helloJamest/FinAgent/issues

Usage

/analyze-issue <issue_number>

Instructions

分析时使用简洁中文，优先遵循仓库根目录 AGENTS.md。

Step 1: 拉取 Issue 信息

gh issue view <issue_number> --repo helloJamest/FinAgent
gh issue view <issue_number> --repo helloJamest/FinAgent --comments

如为 bug，优先核对 issue 模板中是否提供了以下信息：

• 是否已同步到最新版本
• commit hash / 版本基线
• 运行环境与复现步骤
• 日志或报错信息

Step 2: 回答 4 个核心问题

1. 版本是否明确
2. 问题是否真实且可验证
3. 是否属于仓库责任边界
4. 是否值得立即处理

Step 3: 结合仓库现状做证据检查

• 阅读相关代码、配置、测试、脚本、工作流与文档
• 如果问题涉及 API、数据源 fallback、报告生成、通知发送、认证、桌面端、发布流程，明确写出影响面
• 判断是实际 bug、环境配置问题、使用方式问题、还是外部依赖问题
• 如怀疑已被修复，检查当前代码而不是只看 issue 描述

Step 4: 形成结论

至少给出以下字段：

• 版本基线：最新 / 非最新 / 未提供
• 是否合理：是/否 + 理由
• 是否是 issue：是/否 + 理由
• 是否好解决：是/否 + 难点
• 结论：成立 / 部分成立 / 不成立
• 分类：bug / feature / docs / question / external
• 优先级：P0 / P1 / P2 / P3
• 难度：easy / medium / hard
• 建议动作：立即修复 / 排期修复 / 文档澄清 / 关闭

Step 5: 生成分析文档

保存到 .claude/reviews/issues/issue-<number>.md

Output Document Format

# Issue #<number> Analysis

**Date**: YYYY-MM-DD
**Status**: Pending Review

## Summary

- 版本基线：
- 是否合理：
- 是否是 issue：
- 是否好解决：
- 结论：
- 分类：
- 优先级：
- 难度：
- 建议动作：

## Evidence

- 关键 issue 信息：
- 关键代码/脚本/工作流证据：

## Impact Scope

- 受影响模块：
- 受影响运行路径（本地 / Docker / GitHub Actions / API / Web / Desktop）：

## Root Cause / Main Reasoning

<根因或主要判断依据>

## Proposed Handling

<建议修复、澄清或关闭方式>

## Risks And Rollback

- 风险点：
- 若修复，回滚方式：

## Draft Reply

<建议回复内容>

Allowed Auto-Actions (No Confirmation Needed)

• 拉取 issue 详情与评论
• 阅读相关代码、配置、脚本、工作流和文档
• 生成分析文档

Actions Requiring Confirmation

执行以下动作前，先询问用户：

1. 添加或修改标签
2. 在 issue 下评论
3. 关闭 issue
4. 开始修复 issue

Source: helloJamest/FinAgent — distributed by TomeVault.