mcpField
C
create-rfc

create-rfc

github.com/emiliosheinz生产力2040 次安装2 周前更新
代码仓库

关于 create-rfc

该技能每次生成一份 RFC,用于围绕尚未决定的事项协调利益相关者。它要求先收集必要背景、诚实比较选项,并在写入前确认文档位置。

主要功能

  1. 01收集并验证 RFC 必填字段
  2. 02依据预先确定的标准比较选项
  3. 03重大变更纳入维持现状选项
  4. 04按 RFC 类型提供指导并进行质量检查
  5. 05写入前确认文档位置

适用场景

  1. 01协调利益相关者讨论未决技术变更
  2. 02比较流程、产品、供应商或政策选项
  3. 03编写明确列出假设与权衡的 RFC

安装

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

$npx skills add https://github.com/emiliosheinz/agent-skills --skill create-rfc

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

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
numbering.md
process.md
quality.md
types.md
templates/
rfc.md

详细介绍

创建 RFC

每次调用生成一个 RFC。RFC 用于提出尚未做出的决策,并推动利益相关方达成共识;如果决策已经做出,请使用 /create-adr 记录。按顺序遵循五步流程:第 2 步会验证必填字段,所有必填字段齐备后即可开始起草。

硬性规则

  • 绝不编造事实。 如果缺少必填字段,就提出询问。绝不在背景、假设或选项中填入听起来合理的套话。
  • 绝不把既定结论伪装成待议事项。 如果只有一个真实可选项,这份文档就是 ADR,而不是 RFC——请改用 /create-adr。
  • 先写决策标准,再列选项。 在列出选项后才写标准,会显得像是在为偏好的选择找理由。
  • 对任何重大变更,都要明确列出“维持现状”这一选项——哪些变更属于重大变更,由通用规则 2 定义。
  • 绝不跳过权衡分析。 每个选项都必须如实列出优点和缺点。
  • 使用用户的语言撰写——即用户在本次会话中使用的语言,文档中的每个部分都要如此。

执行流程

按顺序执行流程。采取行动前,完整阅读对应的参考文件——它是该步骤的操作指南。

步骤阅读目的
1 — 收集背景references/process.md询问主题、影响、紧迫性和已有想法的选项
2 — 验证必填字段references/process.md确保标题、背景、RACI、标准、选项和建议均已提供
3 — 按 RFC 类型调整references/types.md技术 / 流程 / 产品 / 供应商 / 政策——各自需要重点关注的方面
4 — 生成templates/rfc.md + references/numbering.md填写模板、分配编号、运行质量检查清单
5 — 确定存放位置并规划后续步骤references/process.md确认文件位置,输出摘要和后续事项

定稿前运行质量检查清单(references/quality.md)——检查选项是否客观、标准是否有权重、背景是否量化、假设是否明确。

模板

纯 Markdown 脚手架。仅在撰写时加载:

  • templates/rfc.md — 包含必填和推荐部分。删除任何内容为空的推荐部分;即使值为 *to be confirmed*,也要保留每个必填部分。

通用规则

  1. 诚实。 根据标准如实比较选项;优缺点必须真实;明确列出假设及其可信度和失效触发条件。
  2. “维持现状”始终是重大变更的一个选项——它能促使人们如实评估变更是否值得付出成本。重大变更是指第 1 步记录的影响级别为 HIGH 或 MEDIUM(涉及多个团队 / 系统 / 用户,或一个完整团队或系统)。影响较低的变更——范围有限且易于撤销——可以省略维持现状这一选项,但要用一行说明原因,不能让读者自行猜测。这是本技能中对重大变更的唯一界定;其他所有提及均以此为准。
  3. 起草期间,“结果”是占位内容——决策做出后再填写;如果该决策值得留存,则链接到由此产生的 ADR。
  4. RFC 用于决策,而非实施。 决策一旦做出,就交由 /create-adr 记录,并交由 /forge 构建。
  5. 所有内容都要注明日期,并在开始时记录影响级别。
  6. 写入前先确认。 在第 5 步建议文件路径;只有用户确认存放位置后才能写入。

相关技能

在流程的任何阶段都可以使用以下技能:

  • /create-adr — 决策已经做出。使用 ADR 记录决策的内容、原因和后果,作为不可更改的历史记录。RFC → 决策 → ADR 是重大决策的自然流程。
  • /forge — 由规范驱动的实施。RFC 决策完成后,使用 /forge specify | design | plan | execute 将选定方案拆解为可交付的工作。

署名

基于 create-rfc, 由 Tech Leads Club 提供,并采用 CC-BY-4.0 许可。已对原内容进行修改。

评论

支持 Markdown