Shipping software with AI assistance

Shipping a change involves several distinct states: edited files, recorded versions, proposed integration, merged code, and deployed behavior.

交付一项修改涉及多个不同状态：文件已编辑、版本已记录、集成已提出、代码已合并，以及行为已部署。

変更の公開には、編集したファイル、記録した版、統合の提案、マージしたコード、配備済みの動作という別々の状態があります。

An assistant should report the state actually reached rather than describe a local patch as a released feature.

助手应报告实际到达的状态，而不是把本地补丁说成已经发布的功能。

アシスタントはローカルの修正を公開済み機能と呼ばず、実際に到達した状態を報告すべきです。

A pull request makes a proposed change available for review with its problem statement, scope and validation evidence.

拉取请求（pull request）让拟议修改可供审查，其中应包含问题描述、修改范围和验证证据。

プルリクエストは、問題、範囲、検証の証拠とともに、提案した変更をレビューできるようにします。

The description should help someone unfamiliar with the original conversation understand the trigger and resulting behavior.

说明应帮助不了解原始对话的人理解触发条件，以及修改后的行为。

説明は元の会話を知らない人にも、発生条件と変更後の動作が分かるようにします。

Reviewers need the actual diff and relevant evidence, because a fluent AI summary can omit a changed permission, dependency or failure path.

审查者需要实际代码差异和相关证据，因为流畅的 AI 总结可能漏掉权限、依赖或失败路径的变化。

流暢なAIの要約は権限、依存先、失敗経路の変更を省く可能性があるため、実際の差分と根拠が必要です。

Continuous integration runs the configured checks, but a green result only means those checks passed under their tested conditions.

持续集成会运行已配置的检查，但绿色结果只表示这些检查在所测试的条件下通过了。

CIは設定した検査を実行しますが、成功の表示は、その条件でその検査に合格したことだけを示します。

Inspect new dependencies and configuration for their purpose, maintenance burden, and access to sensitive resources.

检查新增依赖和配置的用途、维护负担，以及它们对敏感资源的访问。

新しい依存関係や設定について、目的、保守の負担、機密資源へのアクセスを確認します。

Secrets belong in appropriate secret-management mechanisms rather than source files, example prompts or shared logs.

密钥等机密信息应放在适当的机密管理机制中，而不是源码文件、示例提示词或共享日志里。

秘密情報はソースファイル、プロンプト例、共有ログではなく、適切な秘密管理の仕組みに置きます。

Deployment should identify the target environment, the version being released, and the verification that confirms it is running correctly.

部署时应明确目标环境、将发布的版本，以及用于确认其正常运行的验证方式。

配備では、対象環境、公開する版、正しく動いていると確かめる検証を特定すべきです。

A rollback plan should restore a useful prior state while accounting for migrations and external side effects that code reversal does not undo.

回滚计划应能恢复到一个仍然可用的先前状态，同时考虑代码回退无法撤销的数据迁移和外部副作用。

復旧計画では、コードを戻すだけでは取り消せないデータ移行や外部影響も考慮し、有用な以前の状態へ戻します。

The complete delivery record connects the user's intended outcome to reviewed code, passed checks, observed deployment and ongoing ownership.

完整的交付记录，会把用户期望的结果与经过审查的代码、已通过的检查、实际观察到的部署情况，以及后续负责安排连接起来。

完全な提供記録は、利用者の成果を、レビュー済みコード、合格した検査、確認した配備、継続する担当責任へつなぎます。