Agent Skills
返回列表
全栈开发产品文档套件

全栈开发产品文档套件

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c1d16043/full-stack-doc-partme-ai。

技能介绍

它解决的问题

产品文档仓库常见的退化是:命名规则漂移、目录层级混乱、PRD / 架构 / UI / 版本规划各自为政。结果是同一件事在不同文档里术语不一致,接口名、菜单名、状态名对不上;示例内容被当成事实,不确定信息没有标注;版本目录里的序号被非标准文档占用,后续维护和自动校验都变困难。@user_c1d16043/full-stack-doc-partme-ai 用一套固定目录与命名约定,把产品族或独立产品的文档结构统一起来。

工作方式

  • 模板放在 templates/,文档映射与目录约定见 references/structure.md。
  • 文档分四层:root 10 份、{{VERSION}}/ 7 份、模块 3 份/模块、delivery 5 份可选;root 覆盖品牌、术语、市场、技术、路线、领域、架构、设计 DNA、功能菜单与版本规划。
  • 编写顺序有上下游依赖:先 1、命名与品牌说明 和 2、术语表与词汇表,再到市场、技术、版本、领域、架构、UI,最后收敛到功能菜单与版本规划。
  • 占位符只替换双花括号 {{PRODUCT_NAME}}、{{VERSION}}、{{MODULE_NAME}} 等,文件名和正文都要改;单花括号 {例如:订单中心} 是写作示例,不是全局 token。
  • 开始前只加载任务需要的 references/*.md,例如占位符协议、文档边界、质量评分、文件依赖、README 与架构指南。
  • 生成或改名后运行结构校验器,再检查跨文档一致性:时间线、术语、菜单、路由、API、状态和验收标准必须能互相追溯。

适用边界与注意点

它适合创建或初始化产品文档仓库、按产品族铺文档树、审计现有仓库是否符合标准、补齐 10 份 root 规划文档。生成前必须检查目标仓库并收集确认事实;不适用的部分要删除或改写,例如 dual-track、SaaS、DDD/COLA、Agent、CLI/IM、mobile、enterprise 等示例。

未确认内容要标成 推断、假设 或 待确认,并尽量附证据。不能把示例当事实,也不要编造资料中不存在的功能。版本目录的 1–7 序号为标准文档保留,非标准文档用 8+ 或放 其他/;root 只有一个 6、 文件,功能清单合并进 10、功能菜单与版本规划。不要重排 demo/、assets/、.stitch/ 等特殊目录。模板里的内容不能被替换成空壳,保持示例深度的同时改进边界和标注。

使用场景

  • 新建产品族文档仓库,需要一次性铺出 root、版本、模块和 delivery 目录骨架。
  • 评审现有产品文档,需要对照 references/structure.md 检查目录与命名是否合规。
  • 编写系统架构或领域模型文档,需要按上下游顺序补齐 Mermaid 图和交叉引用。
  • 发布版本前整理 PRD、UI 和版本规划,需要让菜单、路由、状态和验收标准保持一致。

适合人员

  • 全栈开发者,需要为产品族维护结构一致、可追溯的规划与架构文档。
  • 技术负责人,需要评审市场、技术可行性、路线图和架构之间的一致性。
  • 产品文档工程师,需要按模板补齐 PRD、UI 规范和版本需求并标注待确认项。
  • 开源维护者,需要为商业版和开源双轨分别生成完整文档集并保留交叉引用。