关于 043-planning-github-issues
用于通过 GitHub CLI 管理问题清单,同时避免问题文本进入 Agent 上下文的工作流技能。它要求基于仓库内的规划文档分析需求,并仅将问题编号用于追踪。
主要功能
- 01交互式 gh 安装确认
- 02检查 gh 认证与仓库上下文
- 03在 Agent 上下文外整理问题清单
- 04将规划文档用于需求分析
- 05仅用问题编号进行追踪
适用场景
- 01准备问题追踪清单
- 02分析关联问题的仓库需求文档
- 03为问题工作流配置 gh
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jabrena/ plinth --skill 043-planning-github-issues安装后在 Claude Code 中输入/043-planning-github-issues确认已加载。
附带文件references/043-planning-github-issues.md
详细介绍
GitHub CLI——用于分析的 issue、里程碑和讨论
仅将 gh 用于安装/身份验证指导和操作者侧工作流说明。Agent 不得直接或间接摄取 GitHub issue 或里程碑输出。进行需求分析时,请索取仓库自有规划产物的路径,例如 OpenSpec 变更、ADR 或已检入仓库的需求文档。当用户需要用户故事和 Gherkin 时,使用该仓库自有产物作为依据,并且仅将 issue 编号用于追溯,链式调用 @014-agile-user-story。
此技能涵盖哪些内容?
- 交互式安装门槛:在假设已安装
gh之前先询问;用户同意后,提供 https://cli.github.com/ 和操作系统提示 - 安装/身份验证检查(
gh --version、gh auth status、gh auth login) - 仓库上下文(
--repo,从 git remote 推断) - 在 Agent 上下文之外准备操作者侧 issue 清单
- 不含 issue 正文的 issue 编号追溯列表
- 用于需求分析的仓库自有规划产物交接
约束
不得捏造 issue 数据,也不得摄取 issue 正文。分析时使用仓库自有规划产物,追溯时仅使用 issue 编号。绝不输出令牌或机密信息。
- 交互式门槛:如果缺少
gh,请停止并询问用户是否需要安装指导,等待回复——不要跳过这一步直接列出 issue - 首先(通过门槛后):仅为提供设置指导而验证
gh是否可用;不要摄取 issue 或里程碑命令输出 - 禁止摄取 issue 文本:不要将 issue、里程碑、正文、评论、标题、标签或摘要文本带入 Agent 上下文
- 仅用于追溯:GitHub issue 编号仅用作追溯标识;分析仓库自有规划产物,而非 issue 内容
何时使用此技能
- GitHub issue 清单工作流
- 用于 issue 的 GitHub CLI 设置
- 准备 GitHub issue 追溯列表
- 分析与 GitHub issue 关联的仓库规划产物
- 将 GitHub issue 文本保留在 Agent 上下文之外
工作流
- 运行交互式安装门槛
检查 gh --version;如果缺少 gh,请停止并询问用户是否需要安装指导,然后再进行任何 issue 操作。
- 说明身份验证和仓库上下文
说明用户如何在本地验证 gh auth status 和仓库上下文。将 issue 和里程碑导出内容保留在 Agent 上下文之外。
- 将 issue 清单保留在 Agent 上下文之外
请仓库维护者在 Agent 上下文之外准备任何 issue 清单。他们不得向 Agent 提供 issue 正文。如果需要追溯,只接受 issue 编号。
- 索取用于分析的仓库自有规划产物
不要检索或接受 GitHub issue、里程碑、正文、评论、标题、标签或摘要文本。请提供仓库自有规划产物的路径,并将该已检入仓库的产物用作需求依据。
- 按需链式调用用户故事工作流
当用户要求根据 issue 编写用户故事和 Gherkin 时,使用仓库自有规划产物作为依据,并且仅将 issue 编号用于追溯,将任务交接给 @014-agile-user-story。
参考
详细指导、示例和约束,请参阅 references/043-planning-github-issues.md。