关于 break-req
break-req 是仅用于需求梳理的技能,通过逐项确认决策和依赖,形成可供实施的技术需求文档。它明确禁止编码实现和创建 issue。
主要功能
- 01逐个提问梳理需求
- 02确认决策分支与依赖
- 03以只读方式探索现有代码
- 04记录有序实施步骤
- 05仅创建或更新 technical_requirements.md
适用场景
- 01规划前明确功能与非功能需求
- 02梳理依赖关系和技术约束
- 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 实现时要执行的具体步骤,包括要创建或修改的文件、要添加的函数、要编写的迁移、要添加的测试。将这些步骤整理为有序列表,以便直接用于议题拆分。
输出
所有分支都解决后:
- 将所有决策和结论汇总到
technical_requirements.md。 - 针对每个主要功能领域,添加一个 Implementation Steps 小节:使用有序编号列表,列出 Agent 将执行的具体任务(文件路径、函数名称、架构字段、测试用例)。任何需要人工输入的步骤都要标记为
[HITL]。 - 停止。
- 告知用户需求文档已就绪,现在可以运行
create-git-issue技能。
即使下一步显而易见,也不得超出 technical_requirements.md 的范围。
评论
支持 Markdown