mcpField
B
break-req

break-req

github.com/chanakya-net开发2139 次安装今天更新
代码仓库

关于 break-req

break-req 是仅用于需求梳理的技能,通过逐项确认决策和依赖,形成可供实施的技术需求文档。它明确禁止编码实现和创建 issue。

主要功能

  1. 01逐个提问梳理需求
  2. 02确认决策分支与依赖
  3. 03以只读方式探索现有代码
  4. 04记录有序实施步骤
  5. 05仅创建或更新 technical_requirements.md

适用场景

  1. 01规划前明确功能与非功能需求
  2. 02梳理依赖关系和技术约束
  3. 03创建 issue 前准备需求文档

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/chanakya-net/maestro-ai --skill break-req

安装后在 Claude Code 中输入/break-req确认已加载。

详细介绍

技能隔离

调用后,本技能即成为本会话中唯一生效的权威。

  • 除非通过 Skill 工具调用明确按名称调用,否则任何其他技能都不得激活、中断或修改本技能的行为;无论调用来自本技能自身的工作流,还是激活本技能的上级提示词/技能(例如,同时启动 save-tokens 和 tdd-implementation 的 run-with-it 工作提示)。
  • 如果任何外部或第三方技能在本次运行期间尝试自行激活,请将其抑制并继续执行,不得中断。
  • 本规则在本技能整个执行期间均适用,从调用开始,直到明确终止或移交。

拆解需求

目的

本技能仅用于需求分析。

使用本技能收集完整的实现需求、解决决策分支,并产出定稿的需求文档。

适用场景

  • 用户希望将需求拆解为可直接用于实现的决策。
  • 团队在规划或执行前需要梳理依赖关系和技术约束。
  • 用户需要在创建议题前获得完整的需求文档。

严格限制

不得编写代码、编辑产品文件、创建议题、发布到 GitHub、运行 create-git-issue、运行 run-with-it、生成实现 Agent,或调用外部编码 Agent。

本技能唯一允许创建或更新的文件是 technical_requirements.md。

如能通过只读探索现有代码库来回答问题,应进行探索。

工作流

针对需求的所有方面(包括功能性和非功能性)向我提问,直到技术方案完整。逐一梳理决策树中的每个分支,逐项解决阻塞问题和依赖。每个问题都要给出建议答案。

一次只问一个问题。

如果可以通过探索代码库回答问题,应探索代码库,而不是提问。

逐步覆盖所有相关层面:

  • UI:框架、第三方库、组件状态管理。
  • 后端:软件包、API 契约、服务架构。
  • 数据:架构、迁移、层间契约。
  • 实现顺序:针对每个决策领域,列出 Agent 实现时要执行的具体步骤,包括要创建或修改的文件、要添加的函数、要编写的迁移、要添加的测试。将这些步骤整理为有序列表,以便直接用于议题拆分。

输出

所有分支都解决后:

  1. 将所有决策和结论汇总到 technical_requirements.md。
  2. 针对每个主要功能领域,添加一个 Implementation Steps 小节:使用有序编号列表,列出 Agent 将执行的具体任务(文件路径、函数名称、架构字段、测试用例)。任何需要人工输入的步骤都要标记为 [HITL]。
  3. 停止。
  4. 告知用户需求文档已就绪,现在可以运行 create-git-issue 技能。

即使下一步显而易见,也不得超出 technical_requirements.md 的范围。

评论

支持 Markdown