Community生产力与协作github.com

RafaelFerSilva/refinement-agent-skills

配置工作区以支持细化工作流:操作模式(含代码或不含代码)、本地 Markdown 跟踪器、发布约定以及 AGENTS.md 或 CLAUDE.md 中的智能体指令块。每个工作区运行一次。

refinement-agent-skills 是什么?

此技能用于在工作区中建立 Socratic 细化工作流(如 /refine-story、/qa-plan 等)所需的配置文件。它通过对话引导,而非自动脚本:首先检查现有文件(如 AGENTS.md、CLAUDE.md、package.json、pyproject.toml 等)以了解项目结构和状态。然后,它引导用户确认操作模式(含代码或不含代码)、语言(en-US 或 pt-BR)、工作项跟踪器约定(例如 Azure DevOps 工作项 ID)以及产品术语表的存在情况。最后,它生成或更新三个关键文件:docs/agents/refinement.md(工作流配置)、docs/agents/issue-tracker.md(发布约定),以及在合适的指令文件(AGENTS.md 或 CLAUDE.md)中插入或更新一个 ## Refinement 块。该技能适用于 Claude Code、Cursor 和 Cursor Agent 平台。一次配置后,无需重复运行,除非需要切换模式、语言或跟踪器约定。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/RafaelFerSilva/refinement-agent-skills/tree/HEAD/skills/configure-refinement

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

配置工作区

编写 /refine-story、/qa-plan、/requirements-discovery 和 /meeting-minutes 所依赖的工作区级配置。这是一个对话引导的技能,而非自动化脚本:探索、呈现发现、确认,然后才写入文件。

步骤

  1. 探索。 在做出假设之前检查现有文件:根目录下的 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)、术语表是否存在、跟踪器是否存在,以及要编辑的指令文件。

  2. 逐一询问,每次先给出推荐答案。

    模式。 根据发现推荐:如果存在代码,则为 com-codigo(含代码);如果不存在,则为 sem-codigo(不含代码)。用一句话解释:含代码时,智能体在提问前检查源代码;不含代码时,PO 是事实来源,架构问题变成给团队的问卷。

    语言。 根据现有文件推荐,默认使用 en-US:en-US 或 pt-BR。用一句话解释:定义检查、提问轮次、叙事、Gherkin 标准和结论所使用的语言。

    工作项。 用户故事是否来自外部跟踪器?如果是,基本 URL 和字段约定是什么(例如 Azure DevOps 工作项为 Azure: <ID>)。每个用户故事都源自那里,每个工件都带有此 ID 行。

    产品术语表。 CONTEXT.md 是否已存在?如果不存在,则现在无需操作:第一次解决领域术语的检查将创建它。明确说明这一点。

    完成时:模式、语言、工作项约定和基本 URL 已确认。

  3. 确认并写入。 根据 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、跟踪器文件(新的或保留的)以及指令块均已存在且内容已确认。

  4. 结束。 确认工作区已配置,列出读取 docs/agents/refinement.md 的工作流,并指出文件可在以后手动编辑;仅在需要切换模式、语言或跟踪器约定时才需重新运行此技能。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能