github-issues-mgmt

name	github-issues-mgmt
description	> Use when this capability is needed.

GitHub Issues 管理

从文字描述、CSV、Excel 中提取需求，自动创建 GitHub Issues。也可列出/查询现有 Issues。

Default Configuration

• Default repository: beyonai/ByClaw
• 授权方式: OAuth Device Flow（自动，无需手动配置任何环境变量或 token）

Workflow

IMPORTANT: Always start by executing Step 0. Do NOT ask the user for a token. Do NOT suggest creating a token. Do NOT mention environment variables.

Step 0: Check Authorization (MANDATORY FIRST STEP)

node skills/github-issues-mgmt/scripts/gh-issues-list.mjs --limit 1

If "ok": true → proceed based on user intent.

If "auth_required": true → output already contains message with 授权链接和 code：

1. Show the message field content to the user verbatim
2. STOP and wait for user to say "授权完了" / "done"
3. Then execute: node skills/github-code-analysis/scripts/gh-auth-login.mjs --poll
4. If ok → 重新执行用户请求；if retry → 让用户再确认；if expired → 重新执行 Step 0

禁止：不得提及 GITHUB_TOKEN、PAT、Personal Access Token、环境变量。授权完全由脚本自动处理。

---

Mode 1: 从文字/CSV/Excel 创建 Issues

When to Use

用户提供了一段文字描述、CSV 内容、或 Excel 文件路径，要求创建 Issues。

Steps

1. 解析用户输入：

   • 纯文字 → 提取每个独立的需求/任务/bug 作为一个 issue
   • CSV 内容 → 按行解析，每行一个 issue（识别 title/body/labels 列）
   • Excel 文件路径 → 提示用户先转为 CSV 或直接粘贴内容

2. 确认 issue 列表：向用户展示将要创建的 issues 摘要，确认后再创建：

即将创建 N 个 Issues：
1. [bug] 标题1 — 描述摘要
2. [feature] 标题2 — 描述摘要
...
确认创建？

3. 批量创建：

echo '{
  "issues": [
    {"title": "标题1", "body": "详细描述", "labels": ["bug"]},
    {"title": "标题2", "body": "详细描述", "labels": ["feature"]}
  ]
}' | node skills/github-issues-mgmt/scripts/gh-issues-create.mjs

4. 报告结果：展示创建成功的 issue 链接列表。

解析规则

从文字中提取 issues 时：

• 每个独立的需求/任务/问题 → 一个 issue
• 自动推断 labels：包含"bug"/"缺陷"/"修复" → bug；包含"功能"/"新增"/"feature" → enhancement；包含"优化"/"改进" → improvement
• title 简洁（<80字），body 包含完整描述
• 如果文字中有优先级信息，加到 body 中

从 CSV 中提取 issues 时：

• 自动识别列名：title/标题、body/描述/内容、labels/标签、assignees/负责人
• 如果没有明确列名，第一列为 title，第二列为 body

---

Mode 2: 列出/查询 Issues

When to Use

用户说"列出 issues"、"有哪些 bug"、"查看待办"等。

Steps

# 列出所有 open issues
node skills/github-issues-mgmt/scripts/gh-issues-list.mjs --state open --limit 20

# 按标签过滤
node skills/github-issues-mgmt/scripts/gh-issues-list.mjs --labels bug --limit 10

# 列出已关闭的
node skills/github-issues-mgmt/scripts/gh-issues-list.mjs --state closed --limit 10

展示结果时用表格格式：

#	标题	标签	负责人	更新时间
1	...	bug	user1	2026-05-28

---

Scripts Reference

脚本	用途
gh-issues-create.mjs	批量创建 issues（stdin JSON）
gh-issues-list.mjs	列出/查询 issues

Important Notes

• 创建 issues 前必须先向用户确认，不要静默创建
• 默认仓库 beyonai/ByClaw，不需要问用户
• 中文回复

---

Source: beyonai/ByClaw — distributed by TomeVault.