SuperAPI AI 工具集

code-writer

编程与开发

查看项目

更新于 10-16 10:40

技能介绍

Code Writer 用于在已授权的请求或批准范围内完成源码实现、根因排障与必要验证,并形成可独立评审的精确 Candidate。其设计目标是通过复用仍然有效的判断和证据提升效率,而不是通过少查问题或降低门禁。

用途

它适用于已有明确请求或批准范围时的实现、排障、补测试、Code Review 整改以及恢复这些工作。首次使用时先读取本 skill 与项目小入口,不在加载 skill 的同批调用中全文输出工程状态。输出语言跟随用户,机器字段与 ID 保持英文。只需修小问题时可直接完成,不创建无关流程工件。

主要能力

在实现与排障上,它要求从真实入口和调用链解释现象,再检验假设;错误日志、配置、provider/parser、caller/consumer 和跨尝试恢复状态按风险覆盖。修复上追求能恢复已批准不变量的最小完整修复,同时处理同根因的直接受影响路径,避免只修测试桩或绕过生产入口,避免顺手加无关功能、架构面或长期运维步骤。验证失败时先判断根因、测试输入或 oracle 与环境,而不是重复同一命令。测试复用只适用于精确输入、命令、配置、fixtures/toolchain 和 oracle 均未受影响且结果可核验的情况。

在长任务恢复上,它支持跨压缩、会话或阶段。首次接入时按持久入口把角色、当前任务和已有工程记录位置绑定到稳定入口,并在项目宿主入口(如 AGENTS.md)留下短引用。恢复时当前请求先于旧记录,区分同一任务续接、正常支线、新 Candidate、新反证或批准撤回;从当前可信摘要或工程记录保留的问题与判断、binding、有效结果、未闭合事项、下一步和证据引用继续。每个工作位置仅保留 task_id 和六项核心字段:question、binding、completed、open、next_action、evidence。

使用方式

首次使用、安装更新或发现依赖错误时核对资源。本 skill 随完整 testany-eng 插件发布,公共脚本和参考从 SKILL.md 的实际目录向上两层解析。恢复工具命令为:

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

bind/locate 返回可直接复用的 resume_args;使用前仍须匹配当前请求。参数数组按 argv 传递或逐项正确 shell quoting,不能直接拼接成 shell 文本。其他大 JSON 可用本插件 scripts/context_json.py <file> --pointer /field,多个字段重复 --pointer;根 pointer 是空字符串。

适用场景

包括已确认缺陷的修复与对应回归、继续既有任务的未完成测试、旧 PASS 结论与新日志矛盾时重新检查受影响输入及 oracle 等。交接内容包含精确 base/Candidate、批准范围引用、当前 delta 与影响、实际测试及未做项、未闭合问题和必要证据位置。

限制

新增产品承诺、接口或信任边界以及未批准架构面时,需转交对应 Owner 或专业 skill。Reviewer 提出的缺陷先核对根因和批准不变量,纯可选建议不自动扩大任务;Reviewer 的通过只属于源码结论,CI、部署、环境验收和用户发布许可分别保留。未授权通信时保留可转交结果,不自行创建或唤醒角色。维护本 skill 时运行生命周期及行为验证,自动脚本、独立模型样例、真实宿主和持续工程效果分别报告。