issue-create

用途：在任意以 GitHub 为远端的 Git 仓库中创建 GitHub Issue，支持单条交互创建（Standalone）与从 USDM 需求文档批量创建（USDM）两种模式。\n\n主要能力：Standalone 模式通过对话收集标题、正文与标签后立即创建；USDM 模式解析含 REQ/SPEC 层级的 Markdown 需求文档，自上而下批量创建带 usdm:req 标签的 Issue，并把顶层需求挂到指定父 Issue 下、子需求挂到其父需求 Issue 下，SPEC 不单独建 Issue，而是以表格写入所属需求正文。\n\n使用方式：前提是当前目录为 Git 仓库且 GitHub CLI（gh）已认证，否则提示用户运行 gh auth login。单条创建使用 gh issue create --title "<title>" --label "<labels>" --body "<body>"；USDM 模式用 gh issue create --title "REQ-001: Title" --label "usdm:req" --body "..." 后执行 gh sub-issue add <parent-issue-number> <new-issue-number>；标签不存在时用 gh label create "usdm:req" --color 0075ca --description "USDM Requirement" 创建，最后用 gh sub-issue list 校验层级。\n\n适用场景：需要规范化登记需求、将需求文档转为可追踪 Issue 树、并保持来源可回溯的团队协作流程。\n\n限制：不创建当前仓库之外的 Issue，不修改已有 Issue（USDM 层级创建除外）；批量创建前须展示需求数量与 REQ ID 列表，用户中止则不继续；失败时展示 gh 返回的错误信息。完整映射指南见 references/usdm-issue-mapping.md。