gwin-skill/README.md

gwin-skill

高云（Gowin）ACG525 / GW5A-25A 开发板 全流程工具链 Skill 仓库：设计规范、工程组织、CLI 综合、下载，以及如何让 Cursor Agent 按同一套流程操作。

谁该用

角色	入口
人类开发者	本文 + scripts/
Cursor Agent	先读 SKILL.md
其他 Agent / 自动化	AGENTS.md

仓库结构

gwin-skill/
├── SKILL.md              # Agent 主指令（必读）
├── AGENTS.md             # 多 Agent 协作约定
├── README.md             # 本文件
├── design-spec.md        # 设计规范
├── reference-pins.md     # ACG525 / TFT 引脚
├── examples.md           # TFT 刷屏端到端示例
├── scripts/              # 可执行脚本
│   ├── build.ps1
│   ├── build_and_download.ps1
│   ├── download.ps1
│   └── new_project.ps1
└── templates/            # 空工程模板
    ├── template.gprj
    ├── build.tcl
    └── src/
        ├── top.v
        ├── top.cst
        └── top.sdc

本机前置

1. 工作区示例：Documents/fpga/
2. 工具链：tool-chain/Gowin/Gowin_V1.9.11.03_Education_x64/（Education 即可）
3. 开发板 ACG525 已供电（DC 或 Type-C + 电源开关），下载线已连接
4. 可选：将本仓库安装到个人 skills：

#  junction / 复制均可
cmd /c mklink /J "%USERPROFILE%\.cursor\skills\gwin-skill" "C:\Users\Administrator\Documents\fpga\gwin-skill"

30 秒上手

cd C:\Users\Administrator\Documents\fpga\gwin-skill
.\scripts\new_project.ps1 -Name blink -TargetDir ..\proj_blink
.\scripts\build_and_download.ps1 -ProjectDir ..\proj_blink

已有工程（如 proj1）：

.\scripts\build_and_download.ps1 -ProjectDir ..\proj1

文档索引

• SKILL.md — Agent 执行手册
• design-spec.md — RTL / 约束 / 命名规范
• reference-pins.md — 时钟、按键、LED、LCD RGB565
• examples.md — 800×480 TFT 刷屏复盘
• AGENTS.md — 如何让其他 agent 学会用

许可

随本地教学工程使用；高云 IDE / 器件相关商标归原厂所有。