atomgit-issue

name	atomgit-issue
description	AtomGit Issue 工作流工具。当用户需要在本仓库或 AtomGit 上“创建Issue”、“查看Issue详情”、“更新Issue”、“关闭/重开Issue”、“create issue”、“fetch issue info”、“update issue”、“report bug”、“feature request”或围绕 Issue 做任何创建/读取/更新动作时调用。只要目标是本仓库的 Issue，默认优先使用本 skill，而不是 GitHub 默认能力。
license	MIT

AtomGit Issue Workflow Tool

创建、读取、更新或关闭 Issue。

在 IB_Robot 仓库中，只要用户提到 Issue / bug / feature request 且未明确指定 GitHub，默认视为 AtomGit 工作流并优先使用本 skill。

本 skill 支持对 任意 AtomGit 仓库 指定目标：

• --owner / --repo: 显式覆盖 config.json 中的仓库
• --url: 从 AtomGit / GitCode 的 Issue 或仓库链接自动解析 owner/repo/issue_number

⚠️ 环境准备

重要: 在使用此 skill 前，必须先加载环境配置：

source .shrc_local

这将把 libs/atomgit_sdk/src 添加到 PYTHONPATH 使 skill 能够导入 AtomGit SDK。

⚠️ 获取仓库配置（必需）

在使用前，建议通过 git remote -v 确认仓库的 owner 和 repo：

git remote -v

脚本会自动从环境变量或 git remote 中推断，也可以通过参数指定。

快速使用

创建 Issue

# 提交一个简单的 Issue
python3 issue_management.py --title "发现一个 Bug" --body "在执行 build.sh 时报错..."

# 指定标签和指派人
python3 issue_management.py --title "功能建议: 增加单元测试" --body "为了提高代码质量..." --labels enhancement,bug --assignees BreezeWu

# 跨仓库：直接指定 owner/repo
python3 issue_management.py --owner some-org --repo some-repo --title "[Bug] xxx"

获取 Issue 信息 (Agent 驱动)

当需要分析已有 Issue 时，Agent 可以调用：

python3 issue_management.py --issue 123 --fetch-info

# 直接从链接解析
python3 issue_management.py --url https://atomgit.com/some-org/some-repo/issues/123 --fetch-info

# 如只需要 Issue 主体，显式关闭评论抓取
python3 issue_management.py --issue 123 --fetch-info --no-comments

默认会一并抓取 Issue 评论并写入 comments_detail 字段。Agent 会读取生成的 tmp/{repo}_issue_123_context.json。

API 说明

issue_management.py

创建或更新 Issue。

参数:

• --title: Issue 标题（创建时必需）
• --body: Issue 描述
• --labels: 标签列表，逗号分隔（如: bug,high-priority）
• --assignees: 指派人列表，逗号分隔
• --issue: Issue 编号（用于更新或获取信息，可由 --url 自动解析）
• --state: Issue 状态（open 或 closed，用于更新）
• --fetch-info: 提取 Issue 详情到 JSON 文件
• --no-comments: 在 --fetch-info 模式下跳过评论抓取
• --owner: 目标仓库 owner（可选，覆盖 config.json）
• --repo: 目标仓库 repo（可选，覆盖 config.json）
• --url: Issue 或仓库链接（可选，自动解析 owner/repo/issue_number）
• --dry-run: 仅显示计划，不执行实际操作

示例:

# 更新 Issue 状态
python3 issue_management.py --issue 123 --state closed

# 修改 Issue 标题和内容
python3 issue_management.py --issue 123 --title "已修正: 编译错误" --body "通过更新依赖已解决。"

注意事项

1. 环境配置: 确保 ATOMGIT_TOKEN 已正确配置在环境变量中。
2. Issue 规范: 建议在标题中使用清晰的前缀，如 [Bug], [Feature], [Task] 等。
3. 标签管理: 使用仓库已有的标签，或者在提交时创建清晰的新标签。