用途：github-issue-agent 用于把 Agent 执行过程中遇到的持久性仓库缺陷、执行摩擦（T1-T3）、映射债务和架构改进，标准化地记录为 GitHub Issue。它明确不用于会话内的临时清单（应改用 task-agent）。
主要能力：提供查询、搜索、创建、评论和校验 GitHub Issue 的接口，包含六个操作：create-friction-issue（记录执行摩擦或工具失败）、create-map-debt-issue（把 map-debt.md 条目转为正式 Issue）、create-bug-issue（记录已验证缺陷）、search-related-issues（搜索已有根因项以防重复）、comment-on-existing-issue（向已有 Issue 追加证据而非新建重复项）、validate-issue-taxonomy（按 issue-taxonomy.json 校验标签）。
安全与校验：默认所有修改操作以 dry-run 模式运行（execute=False），只有显式传入 execute=True 且通过全部安全门才真正变更。三道强制关卡为：密钥脱敏门（redaction_gate.py，扫描标题与正文中的令牌、API 密钥、私钥或凭据）、分类法校验门（gh_issue_taxonomy_validate.py，强制 type:、tier:、source:、risk: 以及 area:* 或 plugin:* 位置标签）、证据质量正文校验门（body_validator.py，要求 ## Summary、## Observed Behavior、## Expected Behavior、## Evidence、## Impact 等结构化 Markdown 段落）。
使用方式：各操作对应 scripts 目录下的辅助脚本，如 gh_issue_create.py、gh_issue_search.py、gh_issue_comment.py、gh_issue_taxonomy_validate.py。创建类操作需提供 title、body、labels、execute；搜索需提供 title、area_label、file_paths，返回 has_existing_root_cause、target_issue_number 及建议动作；评论需提供 issue_number、comment_body、execute。分类法规则定义在 issue-taxonomy.json。
适用场景：适合需要把 Agent 运行中发现的摩擦、缺陷、债务和架构问题沉淀为可追踪 Issue 的仓库工作流。
限制：资料未提供具体安装命令、依赖版本、平台支持范围、收费信息及实际效果数据；真实创建依赖 gh 工具，且必须通过全部安全门。