# gwin-skill

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

**远程仓库：** https://git.whcself.xyz/FPGA-IQBoost/gwin-skill.git

## 谁该用

| 角色 | 入口 |
|------|------|
| 人类开发者 | 本文 + `scripts/` |
| Cursor Agent | **先读 [`SKILL.md`](SKILL.md)** |
| 其他 Agent / 自动化 | [`AGENTS.md`](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：

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

## 30 秒上手

```powershell
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`）：

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

## 文档索引

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

## 许可

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