docs-rfc 用于在项目中创建编号 RFC 文档,提出并讨论变更。它会先探查代码库以核实当前状态、真实代码引用、依赖与技术约束,避免编造内容,随后按模板填充并生成文件。
主要能力:按标题生成编号(扫描 docs/rfc/ 中 RFC-XXXX-* 取最大值加一,四位补零)、生成 kebab-case 文件名与 slug、读取 git 用户名为作者、生成状态为 Draft 的文档、运行占位符检查。三种变体:minimal 用于小改动;standard(默认)用于多数功能提案;detailed 用于重大或架构变更。模板与变体位于 <skill-dir>/assets/templates/。
使用方式:docs-rfc "Add GraphQL API Support";docs-rfc minimal "Update Logging Format";docs-rfc detailed "Migration to Microservices Architecture"。流程分三阶段:先探查上下文(可用 Task 工具的 Explore 代理,否则用 grep/glob/read),再解析参数、编号、生成 slug、确定作者、加载模板并填充内容、写入 docs/rfc/RFC-XXXX-kebab-case-title.md(缺失则创建目录),最后运行 grep -nE '{{|}}|TODO|TBD' docs/rfc/RFC-XXXX-kebab-case-title.md 检查残留占位符,最多三轮并报告未解决项。第三阶段输出 RFC 编号、标题、文件路径与后续建议。RFC 状态生命周期为 Draft -> In Review -> Accepted / Rejected(可随时 Withdrawn,接受后实现完成则可 Implemented)。
限制与注意:每一步都需基于实际代码库事实,不得虚构 API、模式或依赖;每个关于当前状态的声明都要验证;模板中每个 {{PLACEHOLDER}} 都必须填充真实内容,不能保留原样;关于定价、平台支持或其他未在资料中说明的信息暂未提供。