Skip to content
cccskills
FreePublished on GitHub

codexhost-pre-push-checks

在推送、标记 PR 就绪或声称“检查通过”之前,按 diff 触及的面选择最小而充分的本地检查,不反射式跑全量。覆盖 TypeScript、Rust、Renderer、发布脚本与 Gate 的选择规则,以及改写历史推送的保护。

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

codexhost 推送前检查

目标:用最小的、回归时会失败的检查,为即将推送的 diff 提供本地证据;全量矩阵由 CI 负责。命令一律以 package.json 与相应配置为准,下表是选择依据,不是命令目录。

先看范围

git status --short --branch
git diff --stat <base>...HEAD      # 先确认真实的 PR 基线

CI 对仅修改 docs/** 与 **/*.md 的 PR 不触发(见 .github/workflows/ci.yml);纯文档改动只需核对链接与 docs/index.md。

按改动面选择

diff 触及优先检查
packages/*/src 逻辑该包 test/ 下的聚焦测试:npx vitest run --config tests/vitest.config.js <file>;共享契约变化时加相邻包测试。跨包导入经由各包 dist,改动了被依赖的包后先 npm run build:typescript(test:typescript 也是先构建再测试)。
类型、导出、tsconfignpm run typecheck(包含 tests/tsconfig.json)。
依赖方向、跨包 importnpm run lint(含 tools/check-boundaries.mjs),改动前后各看一次结果。
格式npm run format:check;只对改动文件运行 prettier 即可定位。
crates/**、Cargo.*npm run check:rust,或对所属 crate 的 cargo test / cargo clippy,沿用 package.json 里的 features。
packages/renderer-extensionnpm run build:renderer;绑定与 DOM 行为用 tests/e2e 中对应 renderer-*.spec.ts(npm run test:e2e);怀疑与 Codex Desktop 版本相关时用 probe:renderer-binding 或 codexhost-update-impact-audit。
scripts/release/**、打包、发行元数据tests/release/**/*.test.mjs,必要时 release:* 对应脚本的烟测;发布流程参见 codexhost-release。
tools/gate-*、Harness Adapter 的真实行为对应 gate:*:hermetic;live 类 Gate 需要凭据与真实 CLI,只在用户明确要求且环境具备时运行,不打印密钥。
平台敏感代码(fs、进程、路径、环境变量)说明 macOS / Windows 未本地验证的部分,交由 CI 二级平台;可用 CODEXHOST_TEST_SCOPE=platform 近似二级平台的选择。

规则:每个行为改动至少有一个“回归时会失败”的测试或检查;没有现成的就补一个或说明缺口。不要因为即将提交就重复跑刚通过的检查。

完整本地预演

仅在用户要求、排查 CI 失败,或改动横跨仓库、没有更窄的可信集合时,才运行 npm run check。使用 package.json 现状,不凭记忆重建聚合命令。

失败处理

  • 推送前相关检查失败:先修复或说明阻塞,不要“先推上去看 CI”。
  • 疑似环境问题:记录确切命令、失败用例与平台差异,确认非平台相关的证据仍通过,再决定。
  • 不得绕过本地钩子或门禁,除非用户明确同意,并如实报告失败内容。

推送

仅在用户要求推送时执行。

  1. 运行已选择的检查,各一次。
  2. 改写历史后推送时,先 git fetch 并记录远端分支的确切 OID,使用 --force-with-lease=<branch>:<oid>;不使用裸 --force。
  3. 推送后核对 git rev-parse HEAD origin/<branch> 一致。
  4. PR 用 gh pr checks 查看远端结果:未完成的如实报告为 pending,失败的先检查再归因。改写历史后,重新核对未解决的评审线程与批准状态,旧的 commit hash 与行内评论锚点不再是当前证据。

不得声称检查通过,除非它已被执行;被跳过或无法运行的检查,报告原因。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

为 codexhost 新增 Harness 插件,或规划、审查、补全现有 Harness Adapter。按当前公共契约实现原生能力,区分插件后端、预装发行和 Desktop 产品接入;不用于单纯添加 Model、Provider 或账号。

The English summary is being prepared. Showing the original description.

BytePioneer-AI/codex-host2.9KUpdated Oct 18, 2026

审查 codexhost 的 Pull Request 或本地 diff 的正确性与边界。检查包与 Rust 所有权边界、官方 Thread 与外部 Harness Thread 的区分、Renderer 私有绑定、生命周期与测试强度。用于“review 这个 PR / diff”;一批 PR 的总览与推荐分请先用 codexhost-pr-overview,再对其中需深审的 PR 使用本 skill。

The English summary is being prepared. Showing the original description.

BytePioneer-AI/codex-host2.9KUpdated Oct 18, 2026

在 codexhost 中寻找有证据支撑的简化候选:无生产调用方的接口、镜像表示、为未来而设计的通用性、可由依赖或内置能力替代的手写代码。默认只读,输出带证据的候选清单;用于审计 AI 辅助开发造成的过度设计,不用于实现新功能。

The English summary is being prepared. Showing the original description.

BytePioneer-AI/codex-host2.9KUpdated Oct 18, 2026

把一批 codexhost PR 汇总成一张表:推荐分(1–5)、作者及已合并数、作用、范围、状态、关联、理由。带“暂缓”标签的 PR 只列出、不检查。用于“看一下现在的 PR”“这批 PR 怎么处理”;单个 PR 的代码缺陷审查请接着用 codexhost-code-review。

The English summary is being prepared. Showing the original description.

BytePioneer-AI/codex-host2.9KUpdated Oct 18, 2026

发布 codexhost 正式版、预览版,编写或确认 Release Notes,检查发布 CI,暂停、恢复或排查发布。支持正常正式发布,以及 npm latest + GitHub Prerelease、不给现有用户更新提示的预览发行。不用于普通代码提交或 Harness CLI 更新。

The English summary is being prepared. Showing the original description.

BytePioneer-AI/codex-host2.9KUpdated Oct 18, 2026

审计或修正读起来像“推理过程泄漏”的注释与文档:引用已不存在的设计会话、讲变更而不讲现状、面向评审者辩解、带“以前/不再/本次”等时间性叙述。用于清理 codexhost 的源码注释、JSDoc、docs 功能文档与提示词字符串。

The English summary is being prepared. Showing the original description.

BytePioneer-AI/codex-host2.9KUpdated Oct 18, 2026

See all skills by BytePioneer-AI

Report a problem with this skill