Back to Details

documentation-rfc

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Documentation RFC

文档RFC

Overview

概述

Use this skill to produce decision-ready RFCs that let stakeholders review options with clear tradeoffs and risks.
使用此技能生成可供决策的RFC文档，让相关方能够结合清晰的权衡与风险评估评审可选方案。

Scope Boundaries

范围边界

  • Use this skill when the task matches the trigger condition described in 
    description
    .
  • Do not use this skill when the primary task falls outside this skill's domain.
  • 当任务符合
    description
    中所述的触发条件时，使用此技能。
  • 当主要任务超出此技能的领域范围时，请勿使用。

Shared References

共享参考

  • Decision quality checks: 
    • references/rfc-decision-quality-checks.md
  • 决策质量检查： 
    • references/rfc-decision-quality-checks.md

Templates And Assets

模板与资源

  • RFC template: 
    • assets/rfc-template.md
  • Tradeoff matrix template: 
    • assets/rfc-tradeoff-matrix-template.csv
  • RFC模板： 
    • assets/rfc-template.md
  • 权衡矩阵模板： 
    • assets/rfc-tradeoff-matrix-template.csv

Inputs To Gather

需要收集的输入信息

  • Problem statement and business/technical motivation.
  • Constraints and non-goals.
  • Candidate options and evaluation criteria.
  • Risks, rollout implications, and decision timeline.
  • 问题说明及业务/技术动机。
  • 约束条件与非目标。
  • 候选方案与评估标准。
  • 风险、部署影响及决策时间线。

Deliverables

交付物

  • RFC with context, options, recommendation, and rationale.
  • Tradeoff table and risk assessment.
  • Open questions and decision dependencies.
  • Review checklist and approval path.
  • 包含背景信息、可选方案、建议及理由的RFC文档。
  • 权衡分析表与风险评估报告。
  • 待解决问题与决策依赖项。
  • 评审检查清单与审批路径。

Quick RFC Skeleton

快速RFC框架

  1. Problem and goals/non-goals.
  2. Constraints and assumptions.
  3. Options considered (including rejected options).
  4. Recommendation and rationale.
  5. Risks, rollout, and rollback considerations.
  6. Open questions and required approvals.
  1. 问题与目标/非目标。
  2. 约束条件与假设前提。
  3. 考虑过的可选方案（包括被否决的方案）。
  4. 建议及理由。
  5. 风险、部署与回滚考量。
  6. 待解决问题与所需审批项。

Quality Standard

质量标准

  • Problem framing is concrete and scope-bounded.
  • Options are comparable with explicit criteria.
  • Recommendation includes why alternatives were rejected.
  • Risks and unknowns are clearly separated.
  • 问题框架具体且边界清晰。
  • 可选方案可基于明确标准进行对比。
  • 建议中需说明否决其他方案的原因。
  • 风险与未知事项需明确区分。

Workflow

工作流

  1. Define problem scope and success criteria.
  2. Collect options and evaluation evidence.
  3. Compare options with explicit tradeoff criteria in 
    assets/rfc-tradeoff-matrix-template.csv
    .
  4. Draft recommendation and risk treatment plan using 
    assets/rfc-template.md
    .
  5. Publish for review with clear decision deadlines.
  1. 定义问题范围与成功标准。
  2. 收集可选方案与评估依据。
  3. 使用
    assets/rfc-tradeoff-matrix-template.csv
    中的明确权衡标准对比可选方案。
  4. 使用
    assets/rfc-template.md
    起草建议与风险应对计划。
  5. 发布文档以供评审，并明确决策截止日期。

Failure Conditions

失败条件

  • Stop when recommendation lacks option comparison evidence.
  • Stop when major risks/unknowns are hidden or untracked.
  • Escalate when required approvers are missing for high-impact decisions.
  • 当建议缺乏可选方案对比依据时，停止推进。
  • 当重大风险/未知事项被隐瞒或未被跟踪时，停止推进。
  • 当高影响决策缺少必要的审批人时，升级处理。