菜单
Run an engineering RFC from draft to decision with a fixed template, review workflow, timebox, and decision log. Use when proposing non-trivial cross-team technical changes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | rfc-template |
| description | Run an engineering RFC from draft to decision with a fixed template, review workflow, timebox, and decision log. Use when proposing non-trivial cross-team technical changes. |
RFCs convert architecture debate into a written, reviewable, citable record. This skill gives you an IETF-style template, a timeboxed review workflow, and a decision log that closes the loop with ADRs.
| Concern | Recommended |
|---|---|
| Format | Markdown in repo (/rfcs/NNNN-slug.md) |
| Numbering | Zero-padded, monotonic, never reused |
| Review tool | Pull Request with CODEOWNERS for /rfcs/ |
| Status states | Draft, Review, Last Call, Accepted, Rejected, Superseded |
| Timebox | 5 working days Review + 2 days Last Call (default) |
| Decision link | ADR (MADR 4.0) created on Accepted |
| Inspiration | IETF RFC 7322, Rust RFCs, Python PEP, Oxide RFD |
Skip RFC for: bug fixes, library upgrades inside one service, prototypes behind a feature flag.
stateDiagram-v2
[*] --> Draft
Draft --> Review: PR opened
Review --> LastCall: substantive comments resolved
LastCall --> Accepted: approvers sign off
LastCall --> Rejected
Review --> Withdrawn
Accepted --> Superseded: replaced by RFC-NNNN
Rejected --> [*]
Superseded --> [*]
/rfcs/NNNN-slug.md)---
rfc: NNNN
title: <Short title>
status: Draft
sponsor: @handle
shepherd: @handle
created: YYYY-MM-DD
updated: YYYY-MM-DD
supersedes: []
superseded-by: null
---
# Summary
One paragraph. What and why.
# Motivation
Problem, evidence, who is affected. Link metrics.
# Guide-level explanation
How a developer/operator/user experiences the change.
# Reference-level explanation
Interfaces, data contracts, sequence diagrams, failure modes.
Include Mermaid C4 L2 + sequence diagrams.
# Drawbacks
Honest list. Operational cost, complexity, blast radius.
# Rationale and alternatives
At least two alternatives with a trade-off table.
# Prior art
Internal precedents, external references (RFCs, papers, vendor docs).
# Unresolved questions
Explicit list. Each must be closed before Last Call ends.
# Future possibilities
Out of scope but enabled.
# Decision log
| Date | Decision | By |
|------|----------|----|
| Day | Action | Owner |
|---|---|---|
| 0 | PR opened, status Review | Sponsor |
| 1-3 | Async comments, revisions | All |
| 4 | Review meeting (30 min, optional) | Sponsor |
| 5 | Status -> Last Call, comment freeze announced | Shepherd |
| 6-7 | Approvals collected | CODEOWNERS |
| 7 | Merge as Accepted or Rejected, open ADR | Sponsor |
On Accepted, create an ADR that links back: ADRs are short, immutable decisions; RFCs are the deliberation. Never edit an Accepted RFC - supersede it.
| Pitfall | Symptom | Fix |
|---|---|---|
| No timebox | RFC open for 3 months | Enforce 5+2 day timebox |
| Missing alternatives | Only one option presented | Require >=2 in Rationale |
| Editing post-acceptance | History rewritten | Status Superseded + new RFC |
| No shepherd | Process drifts | Assign Shepherd at Draft |
| RFC as design doc | 40 pages, no decision | Scope to one decision per RFC |
/rfcs/NNNN-slug.md merged on main./docs/adr/./rfcs/README.md) listing all RFCs by status.Build production integrations with Anthropic Claude (Claude 4.5 Sonnet, Claude Opus 4, Claude Haiku 4) via the Messages API — system prompts, multi-turn conversations, tool use (function calling), prompt caching, extended thinking, vision, batched requests, and streaming. Use when wiring Claude into backends, agentic workflows, or evaluating it against other foundation models. Requires ANTHROPIC_API_KEY.
Deploy Cloudflare Workers, Pages, and Workers-with-static-assets safely using Wrangler 4.x with versioned uploads, gradual deployments, preview/production environments, secret bindings, observability, and one-command rollback. Use when shipping edge workloads, API routes, or full-stack apps to Cloudflare. Requires CLOUDFLARE_API_TOKEN with scoped permissions or an authenticated Wrangler session.
Deploy static sites, framework apps (Next.js, Astro, Remix, SvelteKit, Nuxt), Edge Functions, and serverless Functions to Netlify with deploy previews, branch deploys, atomic production promotion, scoped env vars, and instant rollback. Use when releasing on Netlify via CLI, API, or Git-triggered builds. Requires NETLIFY_AUTH_TOKEN (PAT) and NETLIFY_SITE_ID.
Transcribe audio with OpenAI speech-to-text models (gpt-4o-transcribe, gpt-4o-mini-transcribe, whisper-1) using prompt-guided terminology, segment-level timestamps, optional diarization via post-processing, and reliable artifact delivery. Use when converting interviews, calls, podcasts, or meeting recordings into reviewable text. Requires OPENAI_API_KEY.
Deploy Web Services, Private Services, Background Workers, Cron Jobs, Static Sites, PostgreSQL, and Key-Value (Redis-compatible) on Render via Blueprints (`render.yaml`) or the Render API with preview environments, zero-downtime rolling deploys, health checks, env-group secret scoping, and one-click rollback. Use when releasing services, applying schema migrations, or syncing infra-as-code on Render. Requires RENDER_API_KEY (owner- or workspace-scoped).
Operate Sentry end-to-end — error monitoring, performance tracing, session replay, profiling, release health, source-map upload, ownership routing, alert tuning, issue triage, and CI integration via sentry-cli — across web, mobile, and backend stacks. Use when instrumenting an app, wiring releases into deploy pipelines, or running incident-grade triage. Requires SENTRY_AUTH_TOKEN (org-scoped, `project:releases project:write`), project DSN, and (for source maps) `org` + `project` slugs.