Community生产力与协作github.com

karrot0195/agent-skills-

扫描 Go 项目结构,生成/更新包含包概览、依赖和使用说明的 README.md。

agent-skills- 是什么?

该技能用于自动分析 Go 项目的目录结构、源代码文件和依赖配置(如 go.mod),并基于扫描结果生成或更新项目的 README.md 文档。它会识别项目中的包、二进制文件、配置文件和资源文件,读取关键源文件以提取 API 和行为摘要。最终生成的 README 包含项目标题与概述、目录结构、包描述(含关键函数/类型)、二进制/CLI 说明以及依赖和运行要求。该技能支持在用户要求“扫描项目并更新文档”或“为项目生成详细文档”时主动调用,适用于需要快速创建或补充 Go 项目文档的场景,支持主流 AI 代理(如 Claude Code、Cursor、Codex)。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/karrot0195/agent-skills-/tree/HEAD/.agents/skills/gen-docs

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

gen-docs

当用户要求扫描项目并更新文档(如 README.md)时使用此技能。

步骤

  1. 列出项目根目录,识别包、二进制文件、资源文件和配置文件。
  2. 读取 go.mod 以获取模块名称、Go 版本和依赖项。
  3. 读取每个包中的关键源文件,总结 API 和行为。
  4. 更新或创建 README.md,包含:
    • 项目标题和一行概述
    • 目录结构(树形或列表)
    • 包描述,包含关键函数/类型
    • 二进制/CLI 描述
    • 依赖和运行要求
  5. 确认文件路径,询问是否需要更多细节(如示例、用法)。

何时使用

  • 用户说“更新关于项目概览的 readme”
  • 用户要求“扫描项目并更新文档”
  • 用户希望根据源代码生成项目级文档

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能