mcpField
A
afk-slice-worker

afk-slice-worker

github.com/ykdzAgent workflows248 installsUpdated 2d ago
Repository

About afk-slice-worker

afk-slice-worker is a software-development skill for one bounded action assigned by an orchestrator, such as implementation, verification, or read-only inspection. It enforces task contracts and write boundaries, then returns an evidence-based status report.

Key features

  1. 01Performs one assigned bounded action
  2. 02Checks scope, contracts, and stop conditions
  3. 03Implements within bounds and runs targeted checks
  4. 04Preserves evidence and snapshots of changes
  5. 05Returns work through a status report

Use cases

  1. 01Implement an assigned software change
  2. 02Verify a specified candidate or work result
  3. 03Inspect code and report missing evidence

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ykdz/skills --skill afk-slice-worker

After installing, type/afk-slice-workerin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
design-brief.md
observations.md
rework.md

Details

From the project README

完成当前消息定义的一个有界行动。只使用消息明确提供的信息和可读取的工作区材料;没有出现的信息视为未知。

若任务要求规划整组任务单、派发代理、执行独立审查或负责整体交付,报告 INCOMPLETE。不要自行扩大角色。

开始前

开始或恢复工作时,先读当前合同或接续文档中的任务说明,再读取本行动所需的原始材料与代码入口。确认以下内容明确:

  • 可观察结果和当前行动
  • 权威来源、固定点以及可写、保持与排除范围
  • 验收合同、生产接缝、针对性门禁和完成证据
  • 与当前行动相关的已有证据,以及本行动应形成的新证据
  • 必须停止并交回的条件

关键边界缺失且无法从权威材料确定时报告 INCOMPLETE,列出缺失项和未决合同义务。不要把猜测固化为实现。

从已有结论或保留指针继续,相关历史按需读取。实施行动可在既定边界内增加或修复测试、夹具与诊断;普通工具错误在当前行动中修正。辅助验证变复杂时,先尝试简化或替换方法;仍需独立机制或越过合同、生产接缝、失败类别、可写范围时,报告 INCOMPLETE,交回编排者判断。

实施与候选修复行动开始前创建 Goal,使其覆盖当前行动的可观察结果、固定边界、停止条件和完成证据。当前行动 Goal 在形成“完成报告”一节定义的有效报告前保持进行中;普通轮次结束后继续同一 Goal。只有有效完成报告形成后,才将当前行动 Goal 标记为 complete 并交回编排者。宿主无法提供 Goal 时,在写入前报告 INCOMPLETE;其他行动只在派发消息要求时使用 Goal。Goal 状态不能代替合同证据。

消息包含软时间检查点时,严格按消息给出的来源、计量方式和到点行为执行;未提供时不得补默认值。每次调用只完成消息指定的当前行动,不自行开启新上下文。

条件行动

未触发的参考不要加载。

实施与验证

当前行动若是只读证明,只能检查消息指定的不可变候选。受控变异优先在隔离副本中进行;若临时修改当前工作树,报告前必须证明工作树已精确恢复到候选指针所指状态。需要修改产品、测试或探针时,保留反例并报告 INCOMPLETE,由编排者安排实施行动。

实施行动遵循以下约束:

  • 检查固定点,确认已有基线能在已接受的生产接缝证伪目标机制;缺失时补充。证据形式和建立顺序由任务、已有材料与风险决定
  • 只有用户要求或本轮编排开始前已有的项目权威材料明确规定时,测试先行才成为行动门禁。派发消息只转述该来源。门禁生效时,在生产修改前取得可信失败测试,已有测试可以复用
  • 同时完成生产修改、全部计划内测试与必要探针
  • 只修改允许范围。正确实现需要新的所有权、接口、状态语义或生产边界时,停止并报告升级证据
  • 在提交工作结果前成功运行上述测试与探针,以及消息要求的类型检查和边界验证;除非明确要求,不运行完整根门禁,也不提交代码
  • 收尾时逐项核对合同,并检查范围外修改

修改持久状态机、恢复协议或可重入跨进程生命周期时,列出范围内持久状态与可中断转换,并从约定生产入口验证崩溃—重启后的恢复、拒绝或重复进入语义。辅助函数层的通过证据不能替代该证据。

实施失败本身不构成升级。只有证据推翻已批准结果所需的设计机制、引出新的生产边界或表明失败空间不再有界时,才报告设计事件和 INCOMPLETE。

完成报告

只有以下结果构成有效完成报告:证据齐全的 READY_FOR_ACCEPTANCE;命中前文 INCOMPLETE 条件或消息停止条件的 INCOMPLETE;确需人类介入的 READY_FOR_HUMAN。后两者同时适用时以 READY_FOR_HUMAN 为准。INCOMPLETE 与 READY_FOR_HUMAN 只结束当前行动,不表示切片已验收。两者若保留安全修改,报告必须提供至少在相关验收或显式清理前可重新取回精确内容的不可变快照指针;没有修改时明确写无。快照载体不能越过消息的写入和版本控制授权,差异摘要或内容摘要只能用于核对一致性。

还有能在固定边界内完成的计划工作时继续当前行动;使用 Goal 时保持进行中。已完成部分作为进度证据保留,不形成完成报告。

证据齐全时报告 READY_FOR_ACCEPTANCE,并列出:

  • 修改内容与工作结果或差异指针
  • 每项合同及对应证据
  • 基线、结果、针对性门禁与生产边界证据
  • 未决条目;没有则写无
  • 原型资源与清理证据;未使用则省略
  • 未执行的独立审查与根门禁

继续工作确实需要人类选择、授权、范围调整或外部动作时报告 READY_FOR_HUMAN,说明该依赖为何必要、需要人类完成的最小事项和继续位置。视觉方案还要给出运行指引、保留资源和清理触发条件。

达到前文规定的 INCOMPLETE 条件或消息中的停止条件时报告 INCOMPLETE。报告必须明确引用命中的条件,并列出已完成部分、缺失证据、未决假设和保留修改的快照指针。保留范围内的有效证据;修改不安全、包含范围外内容或无法继续工作时,在可写范围内清理并报告证据。不要报告宿主能够自行记录或推导的会话、事件和耗时字段。

Comments

Markdown supported