--- name: commit description: 按 Only Player 项目规范创建、修改和整理 Git 提交。创建提交、补充提交内容、修改提交说明或处理提交历史时使用。 --- # 提交 先阅读根目录 `AGENTS.md`,按其中的实际架构、配置来源、代码约束与提交要求执行,以当前分支、工作区和暂存区为提交依据。 新增或修改测试代码以用户明确要求编写测试为前提;必要验证采用构建、已有测试和应用调试,纯文档按实际范围检查。 ## 提交信息 - 标题、正文和尾注使用英文;与用户沟通使用简体中文。 - 标题采用 `type(scope): summary`,scope 按实际模块填写;适合整体描述的改动使用 `type: summary`。 - type 使用 feat、fix、refactor、perf、ui、docs、style、test、build、ci、chore、revert 中实际对应的类型。 - scope 使用真实模块/子系统的小写名称,摘要用英文祈使句描述最终变化,省略句末句号,建议控制在 72 个字符以内。 - 简单改动使用标题;需要正文时与标题空一行,用短段落或项目符号说明具体问题与最终结果,验证说明对应实际执行结果。 ## 执行流程 1. 执行 `git status --short --branch`、`git diff`、`git diff --cached`,检查已有改动和提交归属。 2. 按 AGENTS 核对实际模块依赖与持续代码约束,并执行必要格式化与验证;纯规范/文档检查内容与实际配置的一致性。 3. 确认改动归属后,按当前独立任务的具体路径或补丁暂存;其余改动保留原状,归属明确后分别处理。 4. 执行 `git diff --cached --check` 和 `git ls-files --cached --ignored --exclude-standard`,确认前者通过、后者结果为空。 5. 清理新增文件中的本机私人路径、账号、签名信息和其他凭据;补齐白名单规则后,通过普通 `git add` 暂存。 6. 复核暂存内容与说明,按实际验证结果确认完成状态;必要验证失败时先处理失败项,再创建完成状态的提交。 7. 创建本地提交,保留本次纳入内容与验证结果,供完成核对。 ## 版本、问题关联与历史 - 更新版本时阅读同级 `../version-bump/SKILL.md`;版本元数据和日志按该技能独立提交。 - 关联 issue 前阅读原文并对照实际交付;完整满足需求且证据充分时使用 `Closes #编号`,部分完成时使用 `Refs #编号`。 - 修改历史前核对用户授权、提交的推送状态并保存可恢复引用;已推送历史在明确授权覆盖本次改写后处理。 - 仅修改提交信息时,核对各提交改写前后的文件树一致。 ## 推送 - 需要推送时,阅读同级 `../git-push/SKILL.md`,由该技能核对远端、目标、实际命令和执行次数。 ## 完成与维护 检查最新提交与工作区,报告实际纳入的文件、验证结果和待提交事项。 `.codex/skills` 为主源,修改前先检查镜像及同步基线;修改后立即运行 `python scripts/build_support/sync_skills.py --sync`,再运行同一入口的 `--check`。镜像存在独立修改时先核对归属并合并到主源。主源与镜像的相关变更一起提交。