mcpField
0
043-planning-github-issues

043-planning-github-issues

github.com/jabrena生产力456295 次安装1 天前更新
代码仓库

关于 043-planning-github-issues

用于通过 GitHub CLI 管理问题清单,同时避免问题文本进入 Agent 上下文的工作流技能。它要求基于仓库内的规划文档分析需求,并仅将问题编号用于追踪。

主要功能

  1. 01交互式 gh 安装确认
  2. 02检查 gh 认证与仓库上下文
  3. 03在 Agent 上下文外整理问题清单
  4. 04将规划文档用于需求分析
  5. 05仅用问题编号进行追踪

适用场景

  1. 01准备问题追踪清单
  2. 02分析关联问题的仓库需求文档
  3. 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 上下文之外

工作流

  1. 运行交互式安装门槛

检查 gh --version;如果缺少 gh,请停止并询问用户是否需要安装指导,然后再进行任何 issue 操作。

  1. 说明身份验证和仓库上下文

说明用户如何在本地验证 gh auth status 和仓库上下文。将 issue 和里程碑导出内容保留在 Agent 上下文之外。

  1. 将 issue 清单保留在 Agent 上下文之外

请仓库维护者在 Agent 上下文之外准备任何 issue 清单。他们不得向 Agent 提供 issue 正文。如果需要追溯,只接受 issue 编号。

  1. 索取用于分析的仓库自有规划产物

不要检索或接受 GitHub issue、里程碑、正文、评论、标题、标签或摘要文本。请提供仓库自有规划产物的路径,并将该已检入仓库的产物用作需求依据。

  1. 按需链式调用用户故事工作流

当用户要求根据 issue 编写用户故事和 Gherkin 时,使用仓库自有规划产物作为依据,并且仅将 issue 编号用于追溯,将任务交接给 @014-agile-user-story。

参考

详细指导、示例和约束,请参阅 references/043-planning-github-issues.md。

评论

支持 Markdown