Agent Skills
返回列表
项目文档生成器

项目文档生成器

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_dd91c74f/project-doc-generator。

技能介绍

解决的具体问题

很多项目能跑,但交接成本高:目录结构、模块关系、接口参数、数据库字段和部署步骤分散在代码里。人工补文档容易漏掉边界条件和版本变更。

工作方式

该技能以项目代码为输入,先分析目录结构、核心代码、领域模型、数据仓储、业务逻辑、设计模式和架构,再生成中英文文档。它会检查 Git 状态,用 git rev-list --count HEAD 等命令生成版本信息;作者按当前用户、最近 Git 提交作者、留空三级优先级填写。文档通常写入 Doc/cn/ 和 Doc/en/,并覆盖 需求规格、概要设计、详细设计、数据库设计、API 文档、测试计划、部署与用户手册。

适用边界

它适合有可分析代码库、需要快速形成完整文档套件的场景;对仅口述需求、代码不可读或强依赖私有上下文的项目,仍需人工补全业务背景。文档中的接口、表结构和部署步骤应结合真实环境复核后再用于发布。

使用场景

  • 接手陌生仓库后,根据目录结构、核心代码和 Git 提交信息补齐中英文项目文档。
  • 重构模块前,从代码与数据仓储推导概要设计、详细设计和数据库表关系。
  • 上线前,基于 API 调用、异常场景、部署配置生成部署手册和测试计划。
  • 评审代码库时,用生成的需求、设计、API 文档核对业务规则与接口入参出参。

适合人员

  • 负责接手遗留系统的后端工程师:希望从代码恢复模块关系、接口和数据库设计。
  • 准备发布的服务端开发者:需要把 API 参数、异常、部署配置整理成中英文手册。
  • 做代码评审的技术负责人:想用需求、设计和 API 文档核对业务规则与实现。
  • 维护内部工具的独立开发者:希望快速生成可交接的项目文档套件。