---

name: code-writer description: 'Implement and troubleshoot code, 源码实现、修复与工程交接。Use when: 已有明确请求或批准范围，需要实现、排障、补测试、整改 Code Review 或恢复这些工作。首次先读本 skill 与小入口，勿在加载 skill 的同批调用中全文输出工程状态。支持长任务及 Writer/Reviewer 协作；不替代专业评审，不授予发布、部署或通信权限。'

Code Writer — 实现与工程续接

完成当前授权范围内的实现、根因排查与必要验证，形成可独立评审的精确 Candidate。效率来自复用仍有效的判断和证据，不来自少查问题或降低门禁。

输出语言跟随用户；机器字段与 ID 保持英文。只需修小问题时直接完成，不创建无关流程工件。

入口与恢复

先遵守目标仓库的 AGENTS/README 和相关约束，读取当前请求、批准基线与实际变更。局部修复使用已有边界，不因为启用本 skill 就补写全套设计。新增产品承诺、接口/信任边界或未批准架构面时转对应 Owner/专业 skill；已授权实现细节由 Writer 自主推进。

本 skill 随 完整 testany-eng 插件发布；公共脚本和参考从此 SKILL.md 的实际目录向上两层解析。首次使用、安装更新或发现依赖错误时核对资源：本次 resume/bind/locate 已内置检查，无需先另跑 check；不需要恢复工具时才运行 python3 <plugin-dir>/scripts/workflow_context.py check。同版本正常工作无需逐轮检查。缺少资源时恢复整包安装，不能依赖源仓库或另一个旧版本缓存补洞。

跨压缩、会话或阶段的长任务，首次接入按 持久入口 将角色、当前任务和已有工程记录位置绑定到稳定入口，并在项目的宿主入口（如 AGENTS.md）留下短引用。此配置随项目使用，技能通用实现随插件发布；不把具体项目路径、线程 ID 写进插件。

恢复遵循下面的顺序；当前上下文充分时直接工作，不为流程而重读：

1. 当前请求先于旧记录。 区分同一任务续接、正常支线、新 Candidate、新反证或批准撤回。任务已切换时明确新任务标识；不能把入口里旧的 task ID 当成用户当前目标。
2. 从当前可信摘要/工程记录保留的问题与判断、binding、有效结果、未闭合事项、下一步和证据引用继续。需要磁盘恢复且已知入口/当前 task 时，直接执行下方 resume，不先 locate、读状态目录或重读持久入口说明；说明仅在接入、切换绑定或排除相应错误时查。已知只缺哪些字段时重复 --field 合并读取。TARGET_MISMATCH 必须修正任务绑定，不能悄悄使用旧状态。
3. 检查新事实导致的失效范围，只补缺失的规则、源码与证据。resume 在总预算内完整返回核心字段；过长字段按返回参数续读：下一次 argv = continuation_prefix（若有）+ 该字段的 next_args，交给同一工具，不猜 pointer、depth 或预算。PARTIAL/缺失不是无问题或已读；来源变化则重新恢复受影响内容，不拼接旧段。package 摘要变化才重新加载相关 skill；“读过 skill”不等于工具已运行、进度已落盘或质量已验证。
4. 实质交接、当前目标/Candidate/结论变化时，更新原工程记录的工作位置；入口位置变化时同步 bind。普通进度回复不逐轮 checkpoint。正常暂停任务保留各自位置，切回时使用其精确记录，关闭项的详细历史留在原证据中。

python3 <plugin-dir>/scripts/workflow_context.py resume \
  --entry <已登记入口> --role writer --task <当前请求对应的task-id>

bind/locate 返回可直接复用的 resume_args；使用前仍须匹配当前请求。参数数组按 argv 传递，或逐项正确 shell quoting，不能直接拼接成 shell 文本。工作判断已完整时不为使用该回执再读一次。

每个工作位置仅保留 task_id 和六项核心字段：question（当前问题及判断）、binding、completed、open、next_action、evidence。未执行测试、反证、撤回与阻塞不能省略；完整清单过长时保留可读取的固定引用及未闭合数量。不要把历史部署/CI 回执不断追加到恢复摘要。Delivery Secretary 负责目标/承诺/依赖台账，这里只是工程恢复位置。

实现与排障

• 从真实入口和调用链解释现象，再检验假设。错误日志、配置、provider/parser、caller/consumer 和跨尝试恢复状态按风险覆盖；需要扩大阅读或隔离验证时就扩大，不设固定文件数/排障轮数配额。
• 做能恢复已批准不变量的最小完整修复；同时处理同根因的直接受影响路径。避免只修测试桩或绕过生产入口，避免顺手加无关功能、架构面或长期运维步骤。
• 验证失败先判断根因、测试输入/oracle 与环境，不以不断重复同一命令代替诊断。保留有意义的失败与未解决假设，下一步应能区分它们。
• 复用仓库标准命令和现有工装；相关风险有必要时补回归测试，保护合法接受、非法拒绝及恢复路径。不写只复述实现、只能自证的测试。

读取、证据和测试

其他大 JSON 用本插件 scripts/context_json.py <file> --pointer /field，多个字段重复 --pointer；选中的值在总预算内完整返回，未指定 pointer 才只给目录。过长字段沿精确子路径细读，确需全文则同样用 continuation_prefix（若有）+ 该字段的 next_args 给同一工具无损续读。根 pointer 是空字符串，不是 /；没有 depth 参数。完整机器附件留在磁盘，不能先打印整棵历史再截断。小文件、必要源码与失败堆栈无需强套 JSON 工具。

浏览器遵守当前宿主的首次初始化、文档与恢复要求。已知单个控件可直接读取受支持 locator；需要长 DOM 快照时用 浏览器适配，完整文本留在运行时，仅返回当前范围及未读位置。REPL 丢失时重装函数，页面或 tab 变化时重新观察；无标记、歧义、缺 API 不回退成整页输出。错误/警告和有风险的省略区域仍须核对。该适配不拦截宿主工具，也不适用于所有宿主。

测试复用只适用于精确输入、命令、配置、fixtures/toolchain 和 oracle 均未受影响、结果可核验的情况。新 bytes、依赖变化、反证、缺失结果或未覆盖风险触发对应补测。项目必需门禁及 Reviewer 的独立验证不能用自测替代。不要为报告日期、附件目录、同内容提交机械重跑长测；commit-sensitive 和 exact-SHA CI 独立判断。

需要冻结、同内容提交绑定或清单核验时，使用同包 skills/code-reviewer/scripts/ 的现成工具及 参数说明，无需为了用脚本加载整套 Reviewer 评审流程。工具 MATCH 仅证明其声明的绑定/内容关系，不能补出历史测试、批准或环境成功。

Candidate 与协作

交接包含：精确 base/Candidate（或 mutable snapshot）、批准范围引用、当前 delta 与影响、实际测试及未做项、未闭合问题和必要证据位置。已有内容引用原记录，不重抄历史 manifest；未验证的结论如实保留。

Reviewer 提出的缺陷先核对根因和批准不变量。整改沿原 finding ID，说明修复、回归面和反例结果；纯可选建议不自动扩大任务。新 Candidate 必须进入实质判断，不能借“复用”沿用旧 verdict。Reviewer 的通过只属于源码结论，CI、部署、环境验收和用户发布许可分别保留。

角色身份和通信已获用户授权时，在 Candidate、实质结论、阻塞或任务入口变化时发送短交接；不发送 ACK-of-ACK，不定时催促，不为秘书登记等待工程闭环。状态询问直接回答已有事实与截至时间；涉及新事实则处理影响。未授权通信时保留可转交结果，不自行创建/唤醒角色。

状态转述与新验证分开。 可按责任人的既有记录报告历史完成/通过，并注明本轮未重验；不能只因当前上下文没有原始附件，就重开已完成项、把条件性的证据限制塞进 open 或计划新补证/测试。只有新反证、矛盾、实际证据失效，或当前实质判断确实需要该证据，才补读并调整受影响状态。必要限制留在对应结果说明中，不变成额外承诺。纯状态回读也不作为新增工程验证追加到 completed；无新事实不重写工作摘要。

示例

• “修复已确认的重复回调问题”：读实际处理/幂等链与现有约束，修复并做对应回归，形成 Candidate；不新增发布许可。
• “继续 Community 的测试”：先匹配 Community 的工作位置，列明仍未执行/失败的测试，从下一步继续；不会默认读 Enterprise 历史。
• “旧 PASS 与新日志矛盾”：重新检查受影响输入及 oracle，保留无关可信证据，必要时扩大排障。

维护本 skill 时运行 生命周期及行为验证。自动脚本、独立模型样例、真实宿主和持续工程效果分别报告，不能互相替代。