配置工作区
编写 /refine-story、/qa-plan、/requirements-discovery 和 /meeting-minutes 所依赖的工作区级配置。这是一个对话引导的技能,而非自动化脚本:探索、呈现发现、确认,然后才写入文件。
步骤
-
探索。 在做出假设之前检查现有文件:根目录下的
AGENTS.md和CLAUDE.md、CONTEXT.md、docs/agents/refinement.md和docs/agents/issue-tracker.md(本技能的先前输出)、.scratch/,以及源代码的信号:package.json、pyproject.toml、src/、go.mod或任何团队编译或执行的内容。 如果docs/agents/issue-tracker.md已经存在(来自其他约定),则保留它:仅验证它指定了发布位置。如果CLAUDE.md仅仅是一个包含@AGENTS.md的桥接文件,则主要指令文件是AGENTS.md。 完成时:你知道工作区是否已配置、可能的模式、可能的语言(en-US或pt-BR)、术语表是否存在、跟踪器是否存在,以及要编辑的指令文件。 -
逐一询问,每次先给出推荐答案。
模式。 根据发现推荐:如果存在代码,则为
com-codigo(含代码);如果不存在,则为sem-codigo(不含代码)。用一句话解释:含代码时,智能体在提问前检查源代码;不含代码时,PO 是事实来源,架构问题变成给团队的问卷。语言。 根据现有文件推荐,默认使用
en-US:en-US或pt-BR。用一句话解释:定义检查、提问轮次、叙事、Gherkin 标准和结论所使用的语言。工作项。 用户故事是否来自外部跟踪器?如果是,基本 URL 和字段约定是什么(例如 Azure DevOps 工作项为
Azure: <ID>)。每个用户故事都源自那里,每个工件都带有此 ID 行。产品术语表。
CONTEXT.md是否已存在?如果不存在,则现在无需操作:第一次解决领域术语的检查将创建它。明确说明这一点。完成时:模式、语言、工作项约定和基本 URL 已确认。
-
确认并写入。 根据 refinement.md 呈现
docs/agents/refinement.md的草稿,根据 issue-tracker.md 呈现docs/agents/issue-tracker.md的草稿(仅当其尚不存在时),以及智能体指令文件中的## Refinement块。允许调整。然后写入文件。对于指令文件:如果CLAUDE.md存在并导入了AGENTS.md(@AGENTS.md),则编辑AGENTS.md;否则,如果CLAUDE.md存在则编辑它;否则,如果AGENTS.md存在则编辑它;如果都不存在,询问创建哪一个。如果## Refinement块已存在,则就地更新,不修改文件的其余部分。该块内容:
## Refinement Socratic 细化工作流:运行 `/which-flow` 选择工作流。模式和约定位于 `docs/agents/refinement.md` 中;跟踪器约定位于 `docs/agents/issue-tracker.md` 中。工件位于 `.scratch/<slug>/` 中,包含 `Status:` 和工作项 ID。完成时:
refinement.md、跟踪器文件(新的或保留的)以及指令块均已存在且内容已确认。 -
结束。 确认工作区已配置,列出读取
docs/agents/refinement.md的工作流,并指出文件可在以后手动编辑;仅在需要切换模式、语言或跟踪器约定时才需重新运行此技能。