代码转需求文档:把已有实现反向梳理成产品需求规格说明书

前言

做过 B 端系统的人都知道这类处境:代码跑了两年,没人能说清它到底满足了哪些业务需求。新接手的产品经理翻完前端页面、路由表、后端接口、状态机和定时任务,还是拼不出一份能评审的需求文档。反过来,手里有政策规范、旧版规格书、原型稿,却和代码实现对不上号,想迭代却发现无从下笔。

「代码转需求文档」这个 Skill 就是为这两类情况设计的:它以现有代码仓库加示例文件为输入,反向梳理出一份产品经理视角的需求规格说明书,最终交付 Word(.docx)文件。下面介绍它的能力边界和使用方式。

这是什么

一句话定位:把实现和既有文档反向还原成业务语言的需求规格说明书生成工具。

  • 出品方:南京罗斯蒙德
  • 来源:enterprise(企业来源)
  • 当前版本:1.0.0
  • 分类:office-efficiency
  • 标签:requires_api_key=false,即不需要额外 API Key

它解决的问题是文档与代码脱节。常规做法是人工从代码里一条条抠逻辑再写成文档,耗时且容易漏掉边界分支。这个 Skill 让模型按固定结构把前端页面/路由/表单、后端接口/状态机/定时任务、以及政策规范/旧版规格书/原型稿统一收拢,产出面向产品经理的规格书。

核心功能

根据官方简介,它覆盖五类输入的处理:

1、代码仓库梳理:读取前端页面、路由、表单,以及后端接口、状态机、定时任务,按业务模块还原功能点。
2、示例文件吸收:把政策规范、旧版规格书、原型稿中的业务要求写入规格书。
3、语言转换:把偏实现的技术文档改写为业务语言,去掉实现细节,保留业务语义。
4、旧版迭代:按旧版规格书补全或细化内容,可补充流程图、做产品化改写。
5、交付修订:在评审或交付前产出、修订需求规格说明书,格式为 .docx。

最终交付物统一是 Word 文档,适合直接进入评审或归档流程。

触发条件

官方列出的触发场景是:

  • 用户要求”按已有实现/代码梳理(补齐)需求文档”
  • 用户要求”把政策或规范文件的业务要求写入规格书”
  • 用户要求”把偏实现的技术文档改写为业务语言”
  • 用户要求”按旧版规格书补全或迭代(细化、补充流程图、产品化改写)”
  • 用户要求”评审或交付前产出/修订需求规格说明书”

触发逻辑依赖用户提供代码仓库路径和示例文件,模型再据此产出规格书。

安装与启用

该 Skill 基于通用 SKILL.md 格式,通过 SkillHub 分发。官方地址:

https://api.skillhub.cn/org-0lub9joc/code-requirements-document

对应页面:

https://www.skillhub.cn/skills/org-0lub9joc/code-requirements-document

坐标:

@org-0lub9joc/code-requirements-document

关于具体安装命令和各编辑器(Cursor / Codex CLI / Claude Code)的启用方式,已抓取资料中未提供明确说明。安装前请以上述官方页面当前展示的指引为准,不要照搬其他 Skill 的安装命令。

典型用法

官方资料未给出逐字的可复现调用示例,下面按 SKILL.md 类 Skill 的常规用法给出调用思路:

1、把 Skill 安装到目标编辑器后,在对话中明确说明用途,例如:按现有代码仓库梳理需求文档,输入仓库路径与示例文件路径。
2、补充约束,例如指定输出为 .docx、要求覆盖定时任务与状态机、要求把政策条款逐条写入对应章节。
3、拿到产出后做人工复核,重点核对业务规则是否与代码一致。

涉及代码路径和文件路径时,建议在对话中直接写全,避免模型因为路径模糊而漏掉模块。

适用场景与注意

适合的人:接手存量系统的产品经理和需求分析师、需要交付 B 端规格书的团队、想把政策规范落到系统文档的对接人。

需要注意的几点:

  • 反向梳理的准确度取决于输入材料的完整度。只给部分代码或缺失定时任务、状态机定义,规格书会有缺口。
  • 政策规范和代码冲突时,Skill 不会自动判断孰对孰错,需要用户在对话中明确业务口径,再让它按口径改写。
  • 产出是结构化文档而非代码,不能替代对实现的验证,最终仍需与代码逐条核对。
  • 目前版本 1.0.0,功能点以官方简介为准,不要假定它支持多仓库合并、增量比对等未列出的能力。

结尾

这个 Skill 的价值在于把”代码 → 文档”这条逆向链路自动化,省掉人工逐条梳理的时间,同时让产出物保持产品经理可用的口径。它不是替代需求分析,而是把需求分析从翻代码里解放出来,让人去处理判断和取舍。

官方地址:https://api.skillhub.cn/org-0lub9joc/code-requirements-document

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye