Initial gwin-skill: Gowin ACG525 full toolchain skill for agents.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-09-14 20:18:41 +08:00
commit 1b1a68ae28
16 changed files with 765 additions and 0 deletions
@@ -0,0 +1,73 @@
+# gwin-skill
+
+高云（Gowin）ACG525 / GW5A-25A 开发板 **全流程工具链 Skill 仓库**：设计规范、工程组织、CLI 综合、下载，以及如何让 Cursor Agent 按同一套流程操作。
+
+## 谁该用
+
+| 角色 | 入口 |
+|------|------|
+| 人类开发者 | 本文 + `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 / 器件相关商标归原厂所有。