docs(agents): 修复提交正文换行约束

- 补充 Git 提交规则,禁止使用 Bash $"..." 传递多行 commit body

- 规定多行正文应改用多个 -m 或 ANSI-C $... 引号,避免字面量 \n 被写入提交信息

- 验证 docs 站点构建通过
This commit is contained in:
GeWuYou 2026-04-21 16:46:25 +08:00
parent 48e45787f3
commit d836ec8027

View File

@ -32,6 +32,9 @@ All AI agents and contributors must follow these rules when writing, reviewing,
`更新``补充``重构`.
- Each commit body bullet MUST describe one independent change point; avoid repeated or redundant descriptions.
- Keep technical terms in English when they are established project terms, such as `API``Model``System`.
- When composing a multi-line commit body from shell commands, contributors MUST NOT rely on Bash `$"..."` quoting for
newline escapes, because it passes literal `\n` sequences to Git. Use multiple `-m` flags or ANSI-C `$'...'`
quoting so the commit body contains real line breaks.
- If a new task starts while the current branch is `main`, contributors MUST first try to update local `main` from the
remote, then create and switch to a dedicated branch before making substantive changes.
- The branch naming rule for a new task branch is `<type>/<topic-or-scope>`, where `<type>` should match the intended