Document agent ask-first rules across AGENTS and manuals.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
swl
2026-10-10 02:02:00 +08:00
co-authored by Cursor
parent cd2fb51575
commit 1de2654858
5 changed files with 183 additions and 74 deletions
+15 -2
View File
@@ -1,6 +1,13 @@
# songforge 使用手册
本手册讲「怎么跑」。参数铁律、踩坑与版本史见上级目录 [`生歌规则.md`](../../生歌规则.md)(唯一规范)。
本手册讲「怎么跑」。
| 文档 | 用途 |
|------|------|
| [`../AGENTS.md`](../AGENTS.md) | **Agent 必读**:流水线、铁律、**遇事先问** |
| [`../README.md`](../README.md) | clone / 安装 / 远程 |
| [`../config/default.toml`](../config/default.toml) | 算法默认(本仓为准) |
| 若仍嵌套 ComfyUI:`生歌规则.md` | 踩坑长文;与 `default.toml` 冲突时以 TOML + AGENTS 为准 |
推荐:clone 到任意目录后在**仓根**执行(先配 `config/local.toml`):
@@ -16,7 +23,13 @@ cd D:\CodeFiles\Thinking\ComfyUI-MiniMaxH3\user\default\workflows
python songforge\songforge.py <命令> [选项]
```
`local.toml` 填 `engine.server` + `paths.comfy_root` 即可连本机 ComfyUI。QC 音频栈用 `paths.qc_python`(常为 ComfyUI venv)。
`local.toml` 填 `engine.server` + `paths.comfy_root` 即可连本机 ComfyUI。QC 用 `paths.qc_python`(常为 ComfyUI venv)。
### 给 Agent / 自动化
1. 先读 [`AGENTS.md`](../AGENTS.md),再跑命令。
2. 没有 `local.toml`、Comfy 没起、风格/歌名/歌词来源不清 → **先问用户**,不要猜路径或改铁律。
3. 交付以 `qc --baseline` PASS 为准;不要把 `style_fam` 说成「风格已验证」。
---