메뉴
强制执行 CZ 的 Git 和 GitHub 交付风格，包括 gitmoji 提交、受保护的 main、仓库本地 worktree、仅 Squash 的 Auto Merge、拉取请求监控、GitHub Actions 验证和安全清理。每当 Codex 设置或更新 GitHub 仓库、创建功能 worktree、准备或发起拉取请求、跟进拉取请求直至合并并完成 Actions，或执行相关 Git 工作流时，都应使用本技能。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
当生成或探索性工作可能失败、需要多次尝试、涉及众多约束、需要验证，或会产生不应污染主 Agent 上下文的中间发现时，主动使用本技能。 本技能运行一个整洁的主智能体循环：主 Agent 只负责协调，将上下文导出到文件，派发创建者/审查者 SubAgent，将重试过程留在主上下文之外， 并且只接收工件路径以及 PASS / RETRY / FAILED 审查说明。
用于每一项编程任务，以控制流程复杂度。对于任何创建或修改代码的任务，还应使用 clean-agent 协调模式，让创建者和审查者 SubAgent 将 clean-code 作为共同的代码规范。它强制执行复杂度门禁，将每个分支视为新增的逻辑路径，要求有明确的业务理由，尤其适用于实现和代码审查。
每当用户要求编写、重写、缩短、澄清、审查、润色、重构或改写文档及任何面向人类的说明性文本时，请使用本技能。对于任何创建或修改文档的任务，还要使用 clean-agent 协调模式，使创建者和审查者 SubAgent 将 clean-doc 作为共同的沟通规范。它把信息转化为针对特定受众和决策情境的目标导向型沟通，优先考虑读者的语言和风格，并且只保留与决策相关的信息。
当代码运行缓慢、超时、被终止、消耗大量 CPU、执行长时间批处理作业、进行参数扫描、训练模型、处理大型数据集、运行模拟，或目标规模运行时间未知时，使用本技能。它指导智能体逐步探测运行时间，在可行时进行在线 N-T 进度插桩，采用固定超时采样，执行 N-T 扩展估算，并在尝试目标规模前作出全规模运行的通过/不通过决策。如果进行了优化，它要求保留慢速版本的规范输出，证明语义逐字节等价，并在通过并行投入更多 CPU 前优先消除无效工作。本技能不封装性能分析工具，也不提供通用优化方案；它负责判断应全规模运行、停止，还是转入性能分析和原则性优化。
当任务涉及困难推理、原因不明、无法解释的观测、失败的假设、模糊诊断、复杂系统、涌现行为、调查规划，或当前解释空间不完整的任何情形时，请使用此技能。此技能应用递归残差推理：将尚未解释的内容保留为显式残差，把该残差扩展为下一个推理空间，并生成一条从观测到结论、行动或有界停止原因的可追踪路径。
当创建、修改、解释、诊断或验证模型、规则、评分系统、预测、参数选择、机制假设或研究结论时，请使用此技能。它要求同时具备先验依据与实证验证来评估可靠性，并区分可靠结论与黑箱相关性、空洞叙事、事后线索及不可靠主张。
| name | cz-git-style |
| description | 强制执行 CZ 的 Git 和 GitHub 交付风格，包括 gitmoji 提交、受保护的 main、仓库本地 worktree、仅 Squash 的 Auto Merge、拉取请求监控、GitHub Actions 验证和安全清理。每当 Codex 设置或更新 GitHub 仓库、创建功能 worktree、准备或发起拉取请求、跟进拉取请求直至合并并完成 Actions，或执行相关 Git 工作流时，都应使用本技能。 |
常规顺利流程应使用随附的简短 Bash 脚本。要求 Bash 3.2 或更高版本、git、gh、已通过身份验证的 GitHub 访问权限，以及请求操作所需的权限。JSON 选择在 gh 内部执行；不需要外部 jq。
根据已加载的 SKILL.md 将随附的 scripts/ 目录解析为绝对路径，且不要更改目标仓库的工作目录，然后设置：
CZ_GIT_STYLE_SCRIPTS="/absolute/path/to/loaded/cz-git-style/scripts"
"$CZ_GIT_STYLE_SCRIPTS/setup-repo.sh" --help
"$CZ_GIT_STYLE_SCRIPTS/sync-main.sh" --help
"$CZ_GIT_STYLE_SCRIPTS/start-worktree.sh" --help
"$CZ_GIT_STYLE_SCRIPTS/open-pr.sh" --help
"$CZ_GIT_STYLE_SCRIPTS/follow-pr.sh" --help
执行前，将示例路径替换为实际解析出的技能路径。每条工作流命令的 cwd 都应保持为目标仓库。不要猜测参数；先运行相关脚本的 --help。
创建和编辑代码或文档时，使用 clean-agent 协调模式。把本技能作为共享规范交给创建者和审查者 SubAgent。提交消息的选择应由创建者负责，因为其含义取决于具体改动。
遵循标准 gitmoji 惯例，并根据语义选择 gitmoji。
在声明工作完成或交给人类之前，提交已修改的跟踪文件和预期新增文件。编辑仍在进行或处于 clean-agent RETRY 阶段时，继续工作，不要创建检查点提交。在交付 PASS 或升级 FAILED 前，提交当前状态；对于只读工作或没有改动的工作，不要创建空提交。由 AI 选择提交含义和标准 gitmoji——不要自动化创建提交。
在预期的 main 检出目录中运行：
"$CZ_GIT_STYLE_SCRIPTS/setup-repo.sh" --repo OWNER/REPO
新仓库或现有仓库都应运行这项期望状态设置。只有在可能需要创建 GitHub 仓库时才传入 --visibility public|private|internal；创建仓库前，设置流程要求提供此参数。它绝不会替换其他 origin。重复运行会使策略文件、仓库设置和唯一一个由仓库拥有的 cz-git-style 规则集收敛到期望状态。该规则集要求使用 PR、线性历史记录和固定的 pr-check 状态，同时禁止删除和强制推送。生成的 .github/workflows/pr-check.yml 会在每个拉取请求上运行这一最小同步门禁；它不能取代项目验证。
工作流脚本不会创建具有语义含义的代码或文档提交。唯一例外是 setup-repo.sh：当策略文件发生漂移时，它只会提交 .gitignore 和 .github/workflows/pr-check.yml；如果设置未发生变化，则不会创建提交或推送。
从干净的 main 检出目录开始，基于更新后的 origin/main 创建分支 worktree：
"$CZ_GIT_STYLE_SCRIPTS/start-worktree.sh" short-feature-name
在 .worktrees/short-feature-name 中工作，验证改动，并创建具有语义含义的 gitmoji 提交。
只有验证完成后才发起 PR：
"$CZ_GIT_STYLE_SCRIPTS/open-pr.sh" --validated
返回任意检出目录，跟进 PR，直至 Auto Merge 和合并后的 Actions 完成：
"$CZ_GIT_STYLE_SCRIPTS/follow-pr.sh" PR_URL 1800 15
Actions 成功后更新本地 main：
"$CZ_GIT_STYLE_SCRIPTS/sync-main.sh"
将 --validated 视为一项证明，而不是运行验证的请求。open-pr.sh 会推送当前分支、创建 PR，并为当前 HEAD 启用 Squash Auto Merge。follow-pr.sh 使用 gh run view 轮询 Actions；轮询、合并和工作流运行发现共用同一个有界截止时间。它不会移除本地 worktree 或分支。
脚本失败时立即停止。保留原始 git/gh 标准输出、标准错误和当前状态；由 AI 检查仓库实际情况，并选择温和的恢复方式。不要重写临时脚本、弱化策略或绕过门禁。
根据投资回报管理自动化：只有当故障频繁复现，且恢复步骤已经稳定时，才将故障处理自动化。首次出现、低频或依赖上下文的错误应交给 AI。只有在反复证据表明修复方式已经收敛后，才向这些脚本添加恢复路径；不要把这一原则变成另一棵决策树。