shipping-changes

A structured process for taking a substantial software change from investigation through implementation, review, testing, and merging into the main codebase.

In plain words
What is it for?
Use it for refactors, architecture changes, format or protocol updates, and other non-trivial changes that need phased implementation and verification.
Why use it?
It reduces the risk of large changes by requiring a written proposal, small reversible stages, checks, and a self-review before merging. It is intended for work spanning multiple files or modules.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/telagod/code-abyss/shipping-changes
Any agent
npx skills add telagod/code-abyss --skill shipping-changes
Clone the repo
git clone --depth 1 https://github.com/telagod/code-abyss

Made for: Claude Code, Codex.

Per session 123 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,649 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00123 $0.01649
Opus 5 $0.00062 $0.00825
Sonnet 5 $0.00025 $0.00330
Haiku 4.5 $0.00012 $0.00165

Measured 3d ago against content hash 8c4c165004f5, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

shipping-changes scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Hidden instructionshighPrompt injection

Directives inside HTML comments, invisible characters or bidirectional overrides are read by the model and not by the person reviewing the file.

<!-- safety-scan: ignore TOOLS_PRIVILEGED 知识型 skill,仅 Read;文中 git/gh/npm 命令由 agent 自有工具执行,非本 skill 落盘运行 -->
skills/shipping-changes/SKILL.md · 98 lines

How it starts

The opening of the file, as written. The whole thing — 98 lines — stays where its author put it; the contents beside it link to each section on GitHub.

渡劫之链 · shipping-changes

大改动不是一锤子。调研定题 → 提案对齐 → 分阶段守卫式推进 → PR 自审 → 补护栏 → 合并。每一关绿了才进下一关。

何时使用

场景 使用 理由
一个改动牵动多文件 / 多模块 / 公共路径 回归面大,值得先提案再施工
重构、架构调整、协议/格式变更 需要写实蓝图 + 字段映射对齐
改动可拆成可独立 revert 的阶段 守卫链分阶段,控爆炸半径
自审自己的 PR 用挑刺视角找自己埋的雷

何时不使用

  • ❌ 单文件、低风险、机械改动——直接改完跑测试即可,别套流程
  • ❌ 纯探索 / 一次性查询——无交付物,不进闭环
  • ❌ 紧急止血(宕机/事故)——走故障链「止血→定位→修复→验证→复盘」,不在此列

七关闭环

关 0  调研定题   —— 摸清现状 + 业界最佳实践,定问题域(不臆造)
关 1  提案文档   —— docs/<topic>.md:诊断 + 蓝图 + 字段映射 + 迁移路径 + 风险回滚
关 2  对齐       —— 魔尊 review 提案;歧义/破坏性/高成本处停下确认
关 3  分阶段实现 —— 每阶段单一关注点、可独立 revert;单点 PoC 绿了再横推
关 4  守卫链提交 —— assert + test + verify 全绿才 commit;任一红即阻断,不提交
关 5  PR 自审    —— 挑刺视角过 diff,把发现挂到 PR 上(含已知取舍)
关 6  补护栏     —— 把自审揪出的隐患钉成测试,follow-up 推上分支
收口  合并       —— 确认 mergeable + CI 全绿 → merge → 同步本地 main

核心铁律:守卫链提交(关 4)

这是全链最值钱的一环——绝不提交未验证的改动

# 守卫式链:前一步红,后续全部不执行(&& 短路),自然阻断提交
node /tmp/assert.js \            # 自定义不变量断言(如:零宏泄漏、无跨配串味)
  && npm test \                  # 全量测试
  && npm run verify:skills \     # 项目专属闸门
  && git add -A && git commit -F msg.txt \
  && git push -u origin <branch>
  • 任一关红 → 链断 → 不 commit:脏改动永不入库。
  • 自定义 assert 优先于通用测试:通用测试覆盖不到的领域不变量,自己写脚本断言(例:渲染产物零模板变量泄漏)。
  • stamp 在链尾:push / PR 放最后,网络受阻不影响已验证的本地 commit。

反模式(血泪):别把 test 与 commit 塞进同一个 { ...; ... } / ; 顺序块——块内命令各自独立执行,test 红了 commit 照样跑,守卫退化成「记录」而非「阻断」。必须用 && 串成短路链,让前一关的非零退出码真正掐断后续。改了源,先想哪条旧断言要同步改,否则 test 必红。

分阶段实现(关 3)

原则 说明
单一关注点 一阶段只做一类改动(接线 / 数据迁移 / 新增层 / 测试),便于 revert
向后兼容优先 新路径在旧产物缺省时退化为旧行为(byte-compat),降低回归风险
单点 PoC + 低风险先行 先拿代表性目标开刀,纯增量/行为等价的阶段先做;绿了再横推、再推中高风险阶段

影响面检查(关 4.5)

如果 abyss 可用(command -v abyss),提交前对每个修改过的函数跑影响面分析:

abyss impact <changed-function> --json
  • risk > 7:在 PR description 中标注「高影响变更」+ 列出影响面
  • uncovered paths > 0:在 PR description 中标注「需补测试」+ 列出未覆盖路径
  • 耦合文件未同步修改:提醒检查 abyss map 中的 coupling 对

Read the full file on GitHub · 98 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 98 lines · 123 tokens per session scan C 8c4c165004f5

Subscribe to this mod's changes

shipping-changes is a skill published in the GitHub repository telagod/code-abyss (239 stars, last pushed 1mo ago), licensed MIT. It adds 123 tokens to every session and 1,649 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it C with 1 finding (hidden instructions). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

codexkit-api-design-reviewer

Review REST and GraphQL API designs for consistency, usability, and best practices. Covers naming conventions, versioning strategy, error format, pagination, authentication patterns, and breaking change detection. Use when reviewing API specs, designing new APIs, or auditing existing endpoints.

hoavdc/CodexKit · 60 tokens

codexkit-change-management-plan

Build change management plans using ADKAR and Kotter's 8-Step framework. Covers stakeholder readiness, communication plans, training schedules, resistance management, and adoption metrics. Use when rolling out new systems, reorganizations, or process changes that affect people.

hoavdc/CodexKit · 58 tokens

codexkit-crisis-communication

Draft crisis communication packages including holding statements, stakeholder updates, Q&A documents, and internal briefs. Follows ICS (Incident Command System) communication principles. Use during PR crises, data breaches, product recalls, or any event requiring rapid coordinated messaging.

hoavdc/CodexKit · 57 tokens

codexkit-interview-guide-builder

Build structured behavioral interview guides using the STAR method. Map job competencies to interview questions, provide scoring rubrics (1–5), and include follow-up probes and red/green flag indicators. Use when preparing for hiring interviews or standardizing interview practices.

hoavdc/CodexKit · 58 tokens

codexkit-legal-due-diligence

Conduct structured legal due diligence for M&A, joint ventures, or investment transactions. Cover all 9 workstreams — Corporate, Contracts, IP, Litigation, Regulatory, Employment, Tax, Environmental, and Data Privacy. Produce a risk matrix with deal-breaker flags and closing conditions. Use when evaluating a target or…

hoavdc/CodexKit · 76 tokens

codexkit-a-b-test-planner

Design rigorous A/B test plans with hypothesis, sample size calculation, Minimum Detectable Effect (MDE), randomization strategy, and decision rules. Includes guardrail metrics and rollout playbook. Use when planning product experiments, conversion optimization, or data-driven feature decisions.

hoavdc/CodexKit · 62 tokens