implement-change

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Implement Change

实施变更

Deliver the selected outcome through code, evidence and a Draft PR, with progress written back to existing authorized Working Records. Honor a narrower requested endpoint such as local changes or a commit. Merging PRs, deploying and releasing are outside this workflow.
Use Assess Findings and its Investigate with Evidence dependency for shared records and decision-changing factual gaps. Reuse an existing assessment; implementing an agreed request does not require running discovery first. Read the working-record contract when source records or configured history exist and coordination before assigning work. If a dependency is unavailable, report the missing method and continue only work whose scope and evidence remain supported; do not claim its checks occurred.
通过代码、证据和 Draft PR 交付选定成果,并将进度回写到现有且已授权的 Working Records。遵循请求中更窄的交付终点,例如仅进行本地更改或创建 commit。合并 PR、部署和发布不在此工作流范围内。
使用 Assess Findings 及其 Investigate with Evidence 依赖来处理共享记录和会改变决策的事实缺口。复用现有评估;实施已达成一致的请求并不要求先运行发现流程。若存在源记录或已配置的历史记录,请阅读 working-record contract,并在分派工作前阅读 coordination。如果某个依赖不可用,请报告缺失的方法,并且仅继续范围和证据仍得到支持的工作;不得声称其检查已经执行。

1. Recover the agreement and current work

1. 恢复约定与当前工作

Read applicable repository instructions, the requested record/issue/spec and relevant decisions. Inspect current code, worktree changes and related PR state. Reuse sufficient prior research, checking its revision and material assumptions. The Implementation Agreement states the selected outcome, scope, preserved behavior, observable acceptance and remaining decisions. A small fix may need only its reproduction, expected result and regression boundary; link a larger spec rather than copying it.
Before editing from prior findings, apply evidence freshness and repair context. Restore the scenario, impact, acceptance, related evidence and uncertainty, rejected explanations and existing work. State which evidence remains usable, what needs refresh and what this repair will validate. Load related records by demonstrated relevance rather than copying the entire history.
Before editing, use the proposed mechanism to identify affected behavior. When changing a shared transformation, comparator, cache or derived state, trace how relevant inputs are created, transformed, updated and consumed again. Use those paths to identify preservation conditions and discriminating checks in the existing agreement. Stop at the paths needed to establish the change's impact; a local wording edit needs only proportionate inspection.
Investigate factual gaps. Ask the user only about unresolved behavior or scope decisions that block correct implementation. A positive Assess recommendation alone is not authorization to select new product behavior. A direct, sufficiently clear implementation request can supply the agreement without a Working Record or a new spec.
Check relevant claims, branches, commits and PRs before starting duplicate work. If a matching PR already exists, reconcile its coverage and continue the authorized work there when appropriate. Distinguish others' related work from this task's deliverables. Keep unavailable remote evidence explicit.
Ready when: the outcome, affected behavior and checks are actionable, current work is accounted for, and material unresolved decisions are named rather than silently chosen.
读取适用的仓库说明、请求中指定的记录/issue/spec 以及相关决策。检查当前代码、worktree 更改和关联的 PR 状态。复用充分且可靠的前期研究,同时核验其修订版本和实质性假设。实施约定(Implementation Agreement)应说明选定成果、范围、需保持的行为、可观察的验收标准以及尚待决定的事项。小型修复可能只需要复现方式、预期结果和回归边界;对于较大的 spec,应链接引用而非复制。
在根据先前发现结果编辑前,应用证据新鲜度与修复上下文。还原场景、影响、验收标准、相关证据和不确定性、已排除的解释以及现有工作。说明哪些证据仍可使用、哪些内容需要刷新,以及本次修复将验证什么。仅加载经证明相关的记录,而不是复制整个历史。
编辑前,先根据拟议机制识别受影响的行为。更改共享转换、比较器、缓存或派生状态时,追踪相关输入如何创建、转换、更新并再次被消费。利用这些路径,在现有实施约定中确定保持条件和有区分度的检查。检查范围只需覆盖能够确定变更影响所涉及的路径;局部措辞编辑只需进行规模相称的检查。
调查事实缺口。仅当尚未解决的行为或范围决策阻碍正确实施时,才向用户提问。仅凭 Assess 给出肯定建议,并不构成选择新产品行为的授权。直接且足够明确的实施请求本身即可构成实施约定,而无需 Working Record 或新 spec。
开始前检查相关声明、分支、commit 和 PR,避免重复工作。如果已有匹配的 PR,应核对其覆盖范围,并在适当时继续在该 PR 中开展已授权工作。区分他人的相关工作与本任务的交付物。对于无法获取的远程证据,应明确说明。
准备就绪的标准: 成果、受影响的行为和检查均可执行,当前工作已纳入考量,重大未决事项已被明确指出,而不是被默默选定。

2. Claim and plan proportionately

2. 按比例认领与规划

For recorded work, save the owner, execution location/branch, last known progress and next action under existing record authority. Reread before writing the claim. If another owner is active or its state is uncertain, resolve continuation, collaboration or handoff before overlapping edits. Age alone does not release ownership. Inspect available task/process/branch state; ask for direction only when the conflict cannot be resolved from evidence and existing authority. Claims are advisory, not a distributed lock.
For an interrupted task, recover the last action, evidence, pending checks and owned resources; confirm the former executor stopped affected actions before transfer. Preserve unrelated user changes. Use an isolated checkout when needed for parallel writable work, following repository and host rules; do not reset or clean an existing checkout to obtain isolation.
Keep small or tightly coupled changes with one executor. For larger work, split by independently demonstrable results and genuine dependency edges, not simply by file or technical layer. A broad migration may need expand, migrate and contract stages. Dispatch only ready work and also check shared-file, interface, environment and service conflicts: absence of a graph edge does not prove safe concurrency.
Read roles and handoffs when delegating or integrating multiple contributions. Retain scope, shared-record writing and final delivery under one coordinator. No fixed team size is required.
Ready when: ownership is clear and each active unit has an outcome, allowed changes, dependencies, acceptance and an executor; blocked units have a next condition.
对于有记录的工作,在现有记录权限下保存负责人、执行位置/分支、最近已知进度和下一步操作。写入认领信息前应重新读取。如果另一负责人正在操作或其状态不确定,应在重叠编辑前明确是继续、协作还是移交。不能仅因任务已分配很久就释放所有权。检查可用的任务/流程/分支状态;只有当冲突无法根据证据和现有授权解决时,才请求指示。认领仅供协调参考,并非分布式锁。
对于中断的任务,恢复最后执行的操作、证据、待完成检查和已占用的资源;移交前确认原执行者已停止相关操作。保留用户进行的无关更改。需要并行执行可写工作时,使用隔离的 checkout,并遵循仓库和 host 规则;不要通过 reset 或 clean 现有 checkout 来取得隔离环境。
小型或紧密耦合的变更交由同一执行者负责。对于大型工作,应按可独立验证的结果和真实依赖关系拆分,而不是仅按文件或技术层拆分。大范围迁移可能需要 expand、migrate、contract 阶段。仅分派准备就绪的工作,同时检查共享文件、接口、环境和服务冲突:依赖图中不存在依赖边并不能证明可以安全并发。
在委派或整合多项贡献前,阅读角色与交接。范围界定、共享记录写入和最终交付均由同一协调者负责。不要求固定的团队规模。
准备就绪的标准: 所有权清晰,每个执行中的工作单元都有明确的成果、允许的更改、依赖关系、验收标准和执行者;每个受阻工作单元都有后续推进条件。

3. Implement and integrate

3. 实施与整合

Follow the repository's design and validation conventions. Use existing deterministic commands and reusable environments when appropriate. For a reproducible bug, use a discriminating regression check when it meaningfully guards behavior; for a new capability, check the agreed outcome and preservation conditions. Derive expected results from the agreement and observable contract rather than copying the implementation into the assertion. Low-impact wording edits need proportionate checks, not artificial tests.
Workers return changes, inspected code state, actual checks, new evidence and remaining limits. Integrate dependency-ready contributions while preserving unrelated work. Resolve conflicts against the agreement, then validate the integrated state. If new evidence changes a shared assumption, update the record and affected owners before they continue dependent work.
When the repair changes mechanism or intervention layer, revisit the affected paths and preservation checks before relying on the earlier validation plan.
Handle in-scope defects discovered during implementation. Preserve independently actionable side findings through co-active Yak or the authorized working-record method without silently adding their repair to the task. A deeper cause can change the proposed repair unit; keep separate acceptance boundaries and return genuinely new product scope to the user.
Complete when: the agreed implementation is integrated, affected assumptions are reconciled, and remaining limitations or blockers are explicit.
遵循仓库的设计和验证规范。适当时使用现有的确定性命令和可复用环境。对于可复现的 bug,当回归检查能够有效保护行为时,采用有区分度的回归检查;对于新能力,验证约定成果和保持条件。预期结果应源自实施约定和可观察的 contract,而不是将实现复制到断言中。低影响的措辞编辑只需进行规模相称的检查,无需人为增加测试。
执行者返回更改、已检查的代码状态、实际执行的检查、新证据和剩余限制。在保留无关工作的情况下整合依赖关系已满足的贡献。根据实施约定解决冲突,然后验证整合后的状态。如果新证据改变了共享假设,应先更新记录及相关负责人,再让其继续依赖性工作。
当修复改变机制或干预层时,应重新审视受影响的路径和保持检查,然后再依赖之前的验证计划。
处理实施过程中发现的范围内缺陷。通过 co-active Yak 或已授权的工作记录方法保留可独立处理的其他 findings,不得在未说明的情况下将其修复加入任务。更深层的根因可能改变拟议的修复单元;应保持独立的验收边界,并将确实新增的产品范围交回用户决定。
完成标准: 约定的实施已整合,受影响的假设已协调一致,剩余限制或阻塞事项已明确说明。

4. Review and verify the actual result

4. 审查并验证实际结果

Keep three questions distinct: does the change implement the agreement, does it follow repository standards, and does the behavior work under the tested conditions? An available code-review method can help with the first two; it does not replace execution. Additional skills are optional; activate explicit-only skills only when the user selects them.
Choose independent review or verification when complexity, risk or hidden author assumptions justify it and delegation is available. Give a verifier the acceptance conditions, delivered artifacts, setup and safety constraints, not a preferred verdict. Inline checks remain valid where proportionate but are not labeled independent.
Record each meaningful review finding's disposition: repair a supported in-scope issue, explain evidence against an unsupported claim, or return a scope-changing choice to the user. Recheck affected behavior after repairs or integration changes. Bind evidence to the examined code state and environment; an earlier worker branch passing does not establish that the final integrated result passed. Missing execution access remains an explicit verification limit.
Complete when: material findings are resolved or explicitly pending, and the final change has proportionate evidence for its acceptance and preserved behavior without claiming unrun checks.
区分三个问题:变更是否实现了实施约定,是否遵循仓库标准,以及行为在测试条件下是否正常工作。可用的 code-review 方法可帮助回答前两个问题,但不能替代实际执行。额外 skill 均为可选项;仅当用户选择时,才激活必须显式启用的 skill。
当复杂度、风险或作者未言明的假设有必要,且可以委派工作时,应选择独立审查或验证。向验证者提供验收条件、交付物、设置步骤和安全约束,而不是倾向性结论。在检查规模相称时,内联检查仍然有效,但不得称为独立检查。
记录每项重要审查 finding 的处置方式:修复有证据支持且属于范围内的问题;用证据反驳缺乏支持的主张;或将改变范围的选择交回用户。修复或整合变更后,重新检查受影响的行为。证据必须与被检查的代码状态和环境绑定;此前 worker 分支通过测试,并不能证明最终整合结果也通过了测试。缺少执行访问条件仍应作为明确的验证限制。
完成标准: 重要 findings 已解决或明确标记为待处理,且最终变更有与其验收标准和保持行为相称的证据支持,同时不得声称执行了未实际运行的检查。

5. Deliver and write back

5. 交付与回写

Inspect the final diff, repository commit/PR conventions, target branch and existing PR before publishing. Prepare an accurate description of the scenario, trigger, impact, change value, evidence and limits. Preserve that scenario account when producing a shorter author explanation; describe supported use without inventing personal experience. Under the user's implementation request and applicable authorization, commit and create a Draft PR, or update the matching PR without creating a duplicate. Preserve an existing PR's draft/ready state unless a change is authorized. Attach the PR to the current task when the host requires it. Never merge it as part of this skill.
Write the actual PR link, provenance, coverage, checked state/date, final-state verification evidence, changed relationships or affected conclusions, and remaining work to each affected existing Working Record under its recording authority. Changes to a formal issue or spec follow that source's own authorization; a direct implementation request does not require creating a Working Record. Update claims and next actions: waiting for review is not resolved acceptance. Complete authorized record commits under the shared contract; code commits and record commits belong to their respective repositories. A failed publish or writeback is a named pending action with retained work, not a reason to repeat already successful external actions.
Clean or transfer only task-owned resources, preserving required evidence and unfinished work. Return the actual delivery link or local result, relevant verification, record paths and any blockers. Do not mark the change fully delivered while a required PR or record update remains pending.
发布前检查最终 diff、仓库的 commit/PR 约定、目标分支和已有 PR。准备准确说明场景、触发条件、影响、变更价值、证据和限制。生成简短的作者说明时,仍应保留该场景描述;在不虚构个人经历的前提下说明有证据支持的用途。在用户实施请求和适用授权范围内,提交 commit 并创建 Draft PR,或更新匹配的 PR 而不创建重复 PR。除非另有授权,应保持现有 PR 的 draft/ready 状态。host 要求时,将 PR 关联到当前任务。绝不在此 skill 中合并 PR。
在各项记录权限下,将实际 PR 链接、来源、覆盖范围、检查状态/日期、最终状态验证证据、发生变化的关系或受影响的结论,以及剩余工作,写回每个受影响的现有 Working Record。对正式 issue 或 spec 的更改应遵循该来源自身的授权;直接实施请求不要求创建 Working Record。更新认领状态和下一步操作:等待审查并不代表验收已解决。按照共享 contract 完成已授权的记录 commit;代码 commit 和记录 commit 分别属于各自的仓库。发布或回写失败时,应将其列为明确的待办事项并保留已有工作,而不是重复已经成功执行的外部操作。
仅清理或移交任务所属的资源,保留所需证据和未完成工作。返回实际交付链接或本地结果、相关验证、记录路径以及所有阻塞事项。只要必需的 PR 或记录更新仍处于待处理状态,就不得将变更标记为完全交付。