SuperAPI AI 工具集

commit-ko

编程与开发

查看项目

更新于 10-16 08:37

技能介绍

用途:commit-ko 用于把 AI(如 Claude)生成的中文(韩文)提交信息草稿中的公文式、翻译腔词汇(如“~을 수행함”“~을 진행함”“~적 개선을 실시함”等)改成开发者实际使用的自然韩语提交信息。与 humanize-korean 不同,它针对的不是散文段落,而是 1~2 行的提交信息。

输入:提交信息草稿(1 行 subject 加可选 body),多条则分别处理。若为 Conventional Commits 格式(type(scope): subject),保留 type/scope 前缀,只润色冒号后的韩语部分。可选提供 git diff 或变更摘要,仅用于对照确认润色过程中未歪曲含义,而非添加新内容。

原则:不改变含义、范围、类型(feat/fix/docs/refactor/chore 等)、scope 及事实关系;不插入原文没有的理由、效果或数值;也不朝过度礼貌或过度正式方向改写,若“~함”这类提交惯用结尾已自然,不升级为“~하였습니다”。

处理流程:先读 references/commit-lexicon.md;在提交信息中查找公文式动词(수행/진행/실시 等)、汉字词名词化(-성/-적/-화)、过度礼貌结尾、冗长名词短语,以及英语直译句式(“~에 의해”被动、双重被动“~되어지다”、“가지고 있다”类 have 直译);但已固化为开发术语的外来语(업데이트、리팩터링、버그 等)不在处理范围,问题在于句式结构而非词汇来源。仅按 lexicon 处方替换命中的模式;若无命中,则提示“已是自然的提交信息”并结束,不强行修改。保留 type/scope 前缀、issue 编号、文件与函数名等专有标记。

输出:润色后的提交信息 1 条(与原文格式一致,仅 subject 则只输出 subject);含糊时可并列 1~2 个备选表达;并用一行说明改了什么、为什么改。

参考:其替换表由 skills/humanize-korean/references/ai-tell-taxonomy.md 的 A-7、A-8、A-9、A-12(翻译腔句式)与 F-4(汉字词名词化 -성/-적/-화)处方针对提交信息语域特化而来,完整 ID 列表见 references/commit-lexicon.md 顶部;taxonomy 更新时需同步检查该文件,可用 python3 scripts/check_commit_lexicon_ids.py 校验头部与正文 ID 一致性及 taxonomy 是否实际存在。文段级散文(报告、专栏、博客等)的润色应使用 humanize-korean 而非本技能。