用途:该技能用于规范在 Shell 工具中编写多行 git 提交信息的方式,避免因 heredoc 语法解析失败而产生乱码或错误的提交信息。
主要能力:给出明确规则——提交信息不要使用 $(cat <<'EOF' ...) 或 $(cat <<EOF ...);改用带内嵌换行的单引号字符串。示例:git commit -m 'short summary line\n\nLonger body paragraph explaining why the change exists.\nAdditional context if needed.'
使用方式:在 Shell 工具执行 git commit 时,直接以单引号包裹完整提交信息,并在字符串中写入实际换行,形成摘要行、空行与正文段落的结构。
适用场景:任何需要通过 Shell 工具提交多行 git 提交信息的场景,尤其是此前使用 heredoc 出现提交信息被替换为字面量 $(cat <<'EOF' ... 文本的情况。
限制:资料仅说明 heredoc 在该上下文中可能无法正确解析,未提供其他替代方案、工具版本要求或更多示例。