SuperAPI AI 工具集

octocode-rfc-generator

写作与研究

查看项目

更新于 10-15 17:26

技能介绍

用途:在编码前为有后果的变更做决策,撰写或改进 RFC、设计文档、架构提案、迁移方案与选项对比。流程为 UNDERSTAND → RESEARCH → PREREQUISITES → COMPARE → WRITE → CLOSE QUESTIONS → KPI → VALIDATE → DELIVER;对已有 RFC 改用 REASSESS,依据实时代码审计而非旧勾选项。

主要能力与规则:琐碎改动跳过 RFC 模式;当不确定性会改变形态、负责人、范围或决策标准时,只问一个聚焦问题。除用户明确要求单一实现方案外,至少比较两个备选(含不作为)。建议须有可验证事实,引用确切锚点与实际运行过的命令/检查。RFC.md 拥有目标、范围与决策,其他文件链接其锚点而非复述。每个开放问题须以证据解决或明确延期。实现按依赖排序而非估算,需求绑定验收与验证。评审、评级或清理 .octocode/rfc/ 前,必须在 RFC 内写入带日期的 ## Audit Reasoning 块,并基于对实时代码的新读取。不得凭记忆或其他 RFC 断言状态。

停止条件:单文件琐碎编辑(转 octocode-research);头脑风暴交接标记为 Prototype First、Narrow、Park 或未就绪;不确定性改变产物形态、负责人、范围或权衡优先级;两次研究失败;范围需拆分为多个 RFC 或阶段;存在未解决阻塞需假设满足;.octocode/rfc/ 下的保存、删除或归档待明确批准。

产物路径:小型、可逆、单包工作只产出 RFC.md(含计划、验收与内联引用)。否则在保存批准后创建 <workspace>/.octocode/rfc/{name}/:RFC.md(决策)、PREREQUISITES.md(就绪,仅现有代码)、IMPLEMENTATION.md(构建)、KPI.md(验证)、RESOURCES.md(来源附录)。

按需加载:理解需求与选模式加载 references/workflow.md;研究证据加载 references/octocode.md 与 references/research-playbook.md;就绪工作加载 references/rfc-prerequisites.md;比较选项与写决策加载 references/rfc-template.md;执行计划加载 references/rfc-implementation.md;验收与 KPI 加载 references/rfc-kpi.md;保留来源加载 references/rfc-resources.md;重评、评级或清理加载 references/rfc-audit.md;改进本技能优先用 octocode-graph-eval,否则加载 references/improve-loop.md。相关路由:RFC 前用 octocode-brainstorming,事实问题用 octocode-research,KPI 严谨性用 octocode-graph-eval,改技能文件夹用 octocode-skills。交付前逐节验证文档契约并报告真实结果。限制:具体安装命令、收费与平台信息暂未提供。