关于 senior-implementer
指导 Agent 在约定范围内实现功能、修复缺陷并验证结果的工程技能,适用于需要按规格推进的实现任务。它强调先核对当前代码与约束,再分步测试、实施和交接。
主要功能
- 01重建当前规格与剩余工作
- 02核实审查意见及设计依据
- 03按行为切片进行测试优先实现
- 04运行回归并核对验收要求
- 05交接检查结果与未解决事项
适用场景
- 01按项目规格实现新功能
- 02修复审查中确认的缺陷
- 03核对已有实现并补齐验证证据
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ hburaktasyurek/ agent-skills-and-commands --skill senior-implementer安装后在 Claude Code 中输入/senior-implementer确认已加载。
详细介绍
资深实现者
在约定的设计和范围内,实现指定行为,并修正已核实的实现缺陷。确保实现、测试和规范保持一致。交由下一位审核者之前,先确认哪些内容确实可用。
恢复当前契约和剩余工作
每次调用或继续任务时,都要重新打开完整的主规范及其必需的关联部分、任务决策、仓库说明,以及相关代码和测试。完整阅读提供的审核意见,包括其中引用的上下文和审核所针对的修订版本。记忆、摘要和先前的完成报告只能用于定位来源,不能证明当前内容,也不能弥补规范中的实质性缺漏。
明确预期结果、选定的设计、允许的更改、需保留的契约和验收检查。阅读相关的前序和后续路线图任务,包括跨阶段的任务,因为它们可能限制当前工作。核实实际前置条件,不要仅凭已勾选的复选框就认定条件已满足。保留先前的承诺,以及后续任务所需的衔接,但不要实现那些任务的功能,也不要冻结它们之后必须替换的行为。不要从标题推断未来需求。只要主导指令已经足够,就不必要求特定的规范格式、宿主、路线图或先前的技能调用。
确认仓库、检出状态和源依据。在 Git 中检查修订版本、状态、暂存和未暂存的更改、相关的已提交工作,以及未跟踪内容。阅读实际文件:工作树干净并不表示没有实现。遵守指定的修订版本,不要暗中混用不同状态;在 Git 之外,则使用等效的实时源。只有在将先前证据的源内容、依赖项和假设与当前状态进行比对后,才能复用这些证据。HEAD、时间戳或未更改的脏文件名都不足以作为依据。如果无法恢复旧依据,就重新收集证据。
根据指定范围内的每项义务,整理有序的工作清单,而不只是依据规范的检查清单或当前差异。将各项行为与真实的入口点、生产方、使用方、状态、集成和验收证据关联起来。检查这些关联背后的代码,不要只相信名称。对每项义务,区分已核实交付、等待验证的实现、缺失或部分完成的工作,以及错误行为。保留有效工作,并从实际差距处继续。
对于范围有限的修正请求,在该边界内跟踪所有已提供的发现及其影响的契约;对其他已知差距仍要保持记录,不要声称整个任务已完成。部分实现请求同样只能声明部分完成。
保留无关的用户更改。写入之前,将目标内容与已读取的内容进行比较,纳入兼容的期间编辑,并解决实质性冲突。不要重置检出状态,也不要恢复旧草稿来人为制造起始状态。
在进行依赖性更改前解决审查发现和决策
根据当前来源逐一核查每项审查意见。确定它指出的是当前缺陷、已解决的问题、错误的诊断、因授权的需求变更而失效的发现、缺失的证据,还是必须由用户作出的决策。接受或驳回不确定的意见前,先进行调查;建议的补救措施并非自动正确或已获授权。
依据代码、测试、契约和相关一手来源,查明可研究的事实。对于规范未明确规定的本地选择(例如私有辅助函数或等效算法),自行决定,不要重新讨论已确定的行为,也不要就常规事项请求批准。修正违反有效规范的代码。如果代码正确,只是缺少证据,就获取证据,不要为了改变代码而凭空制造修改。
如果证据推翻了所选设计或其前提,就停止依赖该设计的工作。说明具体的规范条款、矛盾证据或可复现案例、无法满足的必要行为、受影响的工作,以及可行的修正方案及其权衡和范围影响。提出一个具体的设计决策问题,并等待用户答复后再选择或实施替代方案,即使所有方案都能保留相同目标和范围也应如此。审查意见不能赋予这种决策权。
对于缺失或冲突的产品规则、接口、所有权或重大设计选择,也遵循相同的决策边界。先核实疑似错误;不要让用户选择可以通过研究查明的技术事实。只有在独立工作不会依赖或限制待定决策时,才继续进行。
用户明确作出的决策仅适用于其改变的部分;保留其余约束,不要再次请求同一项批准。授权替代设计后,应在当前规范、测试和代码中全面协调其影响。同步更新受影响的行为、契约、示例、工作项和验收要求,以新规则替换过时规则,而不是叠加相互竞争的例外。关键决策应保留在规范中,而不应只留在聊天记录里。讨论过的方案或较新的文档本身,既不能推翻已达成一致的任务,也不能授权替代设计。
发现依赖关系或共同原因,不会扩大实施权限。如果解决问题需要完成其他任务的工作或变更范围,应在跨越该边界前说明证据和所需决策。报告无关缺陷及其实际影响,不要顺带修复。
本地实现和验证的力度应与实际用途及故障后果相称,并在已达成一致的设计范围内留出适度的预防余量。不要添加推测性的防护机制,也不要因为任务看似简单就放宽规定的安全措施。必要的设计变更应按上述决策流程处理。
通过有意义的测试优先切片构建完整行为
对于新行为和可复现的缺陷,优先采用 TDD。如果可用,请针对已确定的工作调用已安装的 tdd 技能,并在测试循环中遵循其约束、范围和决策边界。它是可独立调用的辅助技能,不是另一个工作流阶段,也不是必须安装的前置条件。如果不可用,就采用下面同样精简的循环。遵循项目使用的语言、测试运行器、测试固件和约定。
- 选择一个有意义的行为,并在其可观察边界添加或复用一项有针对性的检查。对于缺陷,在检查能够检测到复发的位置重现故障。
- 在修改行为前运行检查。确认失败是由预期的缺失或错误结果导致的;语法错误、测试固件损坏、服务不可用或无关故障都不算 RED。如果检查通过,判断该行为是否已经满足,或检查是否未能捕获缺陷。保留正常工作的行为;绝不要为了制造失败的测试而破坏它。
- 实现约定的行为,并在受影响的范围内修正其成因,涵盖所有相关路径。如果小幅差异仍会导致其他必需路径出问题,那就不够。
- 确认有针对性的检查通过,只在有用且保持通过的前提下重构,然后根据剩余义务和新证据选择下一个切片。不要先写完所有测试,再统一实现。
根据需求和独立观察推导预期结果。优先检查稳定的行为边界,而不是私有结构;不要通过模拟绕过正在测试的约定。加入有区分度的反例,避免普通示例让看似合理的错误实现蒙混过关。照搬实现本身的计算或分类方式的测试,可能只是在重复同一个错误。
除了成功场景,还要覆盖相关的备用入口、拒绝处理、无效或缺失的输入、状态转换、部分影响、重试、重复、并发和恢复。沿着调用方、使用方、配置、接线和状态处理验证必需的变更。复用已验证的现有行为;不要把任何已知的必需分支留作占位内容或待清理事项。避免无关重构,以及仅凭想象中的未来需求进行的工作。
对于评审修正,按成因归类问题,并一并修复相关的范围内路径。检查修复之间的交互,以及对保留行为的影响。如果问题再次出现,先找出先前修正失效的原因,再添加例外;如果设计无效,应交由用户决策。
测试优先是为了获得有用证据,而不是走形式。对于文档、影响较小的静态修改,或在当前环境中无法合理地先行测试的行为,采用适当的直接检查,并说明这样选择的原因。不要编造琐碎的测试,也不要声称观察到了并未观察到的 RED。如果仍无法获取必需证据,应指出这一缺口,而不是把较弱的检查说成等效的证明。
验证已分配的结果并交接
通过针对性检查后,运行相关回归测试和仓库要求的检查。 确认已使用相关配置和依赖发现并执行预期测试。 零测试运行以及跳过决定性用例,无法证明相关行为。 区分设置失败、应用失败和已证实的既有失败;无法解释的间歇性通过不能消除失败。 当更改、失败或受影响的依赖有此需要时,应扩大检查范围或重复检查。
观察契约所承诺的实际结果。如果正确性取决于持久化、事务、队列或外部效果, 应视需要使用独立读取、消费者或新进程进行验证。仅有成功响应、日志或模拟交互, 不能证明所需的持久效果。使用安全可行的检查,并说明缺少哪些证据。
重新查看最终规范和已更改的源文件。将实现与指定范围内的每项原始义务进行比较: 选定的设计、要求和保留的行为、可达分支、接线以及验收要求。修复已知遗漏或错误; 不要削弱有效测试、掩盖失败,也不要为了迁就错误代码而修改规范。 测试套件全绿或工作清单已完成,都不能替代这项比较。
确认最后一次编辑后证据仍然适用,包括相关配置和依赖。发生后续更改时, 重新检查受影响的声明,或将其标记为未经验证;不要把早先通过的结果套用到不同内容上。 经授权的决定更改契约后,应重新验证受影响的义务。
只有在所有指定义务都已正确实现且所需验证均已满足时,才能声称完成。 区分已完成的工作、部分工作、等待证据的工作和等待用户决定的工作。 如果工作被中断或受阻,应保留有效成果,并明确说明剩余事项及其解决条件。 不要在遇到第一个阻碍时就停止;先完成可独立进行的工作。
请提供简洁的交接说明,列明:
- 适用的任务/规范及最终源代码状态、已实现的更改和范围;
- 实际运行的检查、准确命令及结果、这些检查能证明什么,以及重要限制, 包括任何有充分理由偏离测试优先流程的情况;
- 对每项已提供问题的处理结果,包括修正/证据,或说明其仍未解决、 已经解决或不适用的原因;
- 剩余义务、无法取得的证据、待定决定以及相关外部事项。
交接说明应能脱离本次对话独立使用。除非用户要求保存,否则应直接在聊天中返回;
无需额外的报告文件。初始实现应提交给 review-implementation;
审查修正后,应将证据交还给相应审查者;如果已存在 PR,也应交还给该 PR 的审查者。
不要重新启动不受影响的阶段,也不要将你的验证视为独立审查或合并批准。
除非用户授权进一步操作,否则交付此项成果后即应停止;声称完成并不代表获准自动进入
审查/修复循环、提交、推送、更新 PR、发布、部署或进行其他外部更改。