gvt skill — 生成 AI Skill 文件

为当前项目生成 AI 辅助开发所需的 Skill 文件，覆盖项目架构、编码规范、GVT 工具链全部功能场景。兼容 OpenCode / Claude Code / 通用 Agent。

用法

gvt skill                  # 生成 skill 文件（已存在则跳过）
gvt skill --force          # 强制覆盖已有 skill 文件
gvt skill --name my-app    # 指定项目名称（默认从 go.mod 或目录名推断）

参数

参数	简写	说明
--force	-f	强制覆盖已有 skill 文件
--name	-n	项目名称（默认从 go.mod 或目录名推断）

生成的文件

• .opencode/skills/gvt-project-conventions/ — 主 skill 定义 + 参考文档
• .claude/skills/gvt-project-conventions — 符号链接（兼容 Claude Code）
• .agents/skills/gvt-project-conventions — 符号链接（兼容通用 Agent）

文件结构

.opencode/skills/gvt-project-conventions/
├── SKILL.md               # 主 skill 定义（架构、规范、工具链）
└── references/            # 参考文档（按主题拆分）
    ├── architecture.md
    ├── conventions.md
    └── toolchain.md

Windows 兼容

Windows 下符号链接受限时，gvt skill 自动回退为文件复制，确保各 Agent 目录均获得完整 Skill 内容。

适用场景

• 新生成的项目接入 AI 编程助手
• 已有项目补充架构与规范上下文
• 团队统一 AI 辅助开发的知识基线

注意事项

• 不强制覆盖：默认跳过已存在的 skill 文件，使用 --force 覆盖。
• 参考文档按单一职责拆分，单文件行数控制在 250–300 行。