mcpField
D
do

do

github.com/doodledoodAgent 工作流78119 次安装1 天前更新
代码仓库

关于 do

do 是面向 Agent 的执行技能,用于完成 Manifest 定义的工作。它先核对授权和验收条件,并在自主执行时保留交接决策,最终报告变更及其证据。

主要功能

  1. 01执行前读取授权与 Manifest
  2. 02核验目标和验收条件
  3. 03在技能交接中保留上下文
  4. 04报告决策与证据
  5. 05支持授权范围内的 Manifest 修订

适用场景

  1. 01在调用 /do 后执行任务
  2. 02用户暂时无法参与时继续工作
  3. 03评估受阻要求是否可解决
  4. 04按 Manifest 门槛报告完成情况

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/doodledood/manifest-dev --skill do

安装后在 Claude Code 中输入/do确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
EXTERNAL_REVIEW.md
HARVEST.md
LOG.md
VERIFICATION.md

详细介绍

原文在翻译后有更新,译文可能不是最新。

执行前请先阅读 ../ticket-up/references/AUTHORITY.md。在每次技能交接中保留本任务、适用的权限依据和已保留的决策;必须明确告知独立调用方这些内容,以及有用的意图和证据。

没有路径 → 停止并显示用法。仅在有人要求执行时才运行:用户调用了 /do 或要求构建,或者调用方工作流调用了你。用户批准计划不等于要求执行;请说明 Manifest 已就绪,给出 /do 命令,然后停止。否则,完整阅读 Manifest,然后按原文满足每一项验收标准和全局不变量;如何实现由你决定。这些要求具有约束力;初始方案和流程指导仅供参考。完成后,按各项关卡报告变更内容及其依据。

自主执行

假设用户在整个运行期间都无法响应,并将这一点传达给你调用的每项技能:自行判断权限范围内的事项,不要询问或等待;将用户消息视为指导,而非开启对话。每条终止路径都要报告重要决策及其理由,以及偏离的任何流程指导;如有执行日志,也要记录其中。

由用户决定的事项。 如果两个审慎的人依据相同证据,可能会做出不同决定,且差异会影响用户,那么该决定就应由用户决定。请用这句话检验每项重要决策;你自己的信心不能作为定论。在由用户决定的事项上,先遵循任何明确保留的决策或适用的授权委托;然后检查用户的 Taste 条目——已加载记忆文件中 ## Taste 部分的已确认偏好。只有当条目明确适用于该事项时才遵循:它必须针对这类决策,且遵循后会改变选择。诸如减少工作量或降低成本等几乎会影响所有决策的一般倾向,本身并不适用。否则,根据证据做出决定。报告决策时,先列出本次运行重新审议的每条决策记录,说明搁置该记录的理由,以及撤回的代价;再列出由用户决定的事项,逐项说明未选的方案,以及决定依据——遵循的条目,或没有适用条目。

偏好发生反转时的 Taste。 当用户的指导推翻本次运行所做的决定并说明原因,且该原因属于其他用户可能会有相反偏好的偏好——而非每个会话都必须遵循的行为——请草拟一条 Taste 条目,分为三部分:将偏好表述为适用于未讨论过的决策的一般原则,并注明涵盖的决策类型;基于用户陈述的理由撰写依据,绝不添加你推断出的理由;说明何时应让步。在终止报告中原样附上该条目,并注明应写入的记忆文件,以及该偏好是长期适用还是仅针对本案例;“仅针对本案例”视为否。不得写入任何内容:只有用户明确同意该文本后,才能将其写入该文件的 ## Taste 部分。若推翻的决策是由现有条目决定的,则改为报告冲突,并原样展示任何建议的修订或删除内容,供用户确认。不要提出其他建议。对于一次性草稿的反馈(定义见下文),无论是否推翻了本次运行所做的决策,均须严格按照 references/HARVEST.md → 对草稿的反馈 的规定草拟条目。 选择能让成果经久耐用、让下一次变更更容易做对的方案;初始计划由你决定,也可以由你修改。一次性草稿是例外:例如使用虚假数据制作的单页临时呈现,只为让人对尚无法用语言表达的内容作出反馈,而交付物可能会要求制作这类草稿。将它放在项目文件之外,完成度达到此人预期即可,几分钟内展示,不要拖到很晚;也绝不要对它进行超出将其连同所提出的问题交到此人手中所需程度的完善或验证。草稿提出的选择要等待此人的反馈;在收到反馈之前,依赖该选择的工作都必须暂停。运行中形成的持久成果应是决策以及反馈所明确的标准,而不是草稿。工作量预算——问题值得投入的变更规模——可以通过修订(修订)调整,但不能用来为已产生的过量成果开脱,也不能降低任何关卡的标准。范围外排除项、约束性要求和权限保持不变,除非用户进行修改;未列入排除项并不代表授权进行无关工作,只有每个关卡都适用的要求所规定的、适用于每次运行的修复例外。

只有在尝试了可信的替代方案后,仍不存在获准路径,义务才算受阻:运行缺少所需的知识、访问权限或授权,或者必须修改约束性要求。失败的方法应由你重新设计,而不是重复尝试;如果基于同一前提的两种修复方案都未通过关卡,就要先检验该前提,再尝试第三种修复方案。只要总有另一件事可试,判断关卡是否无法通过的依据就应是证据,而非尝试次数:所有剩余的获准方案都无法消除的、经过测量的限制因素;近期尝试未能让结果超出其运行间波动范围;或者两个关卡相互冲突,修复其中一个会导致另一个失败。举证责任在运行方:限制因素必须经过测量,而非猜测;尝试必须是针对该限制因素的不同方法,而非同一想法的变体;所有可能改善结果的获准方案都必须试过。在此之前,关卡就不算无法通过,工作仍须继续。满足上述任一条件后,便可认定工作受阻,因为需要修改约束性要求;阻塞项必须列明已取得的最佳结果、限制因素、已尝试的方法,以及解除阻塞所需的要求变更,并且标准仍按原文执行。及时报告阻塞项,附上证据和所需干预,然后继续开展有用且独立的工作,不要猜测受阻的决策;只有在没有有用的独立工作可做时,才针对尚未解决的阻塞项调用 /escalate。仍在运行的外部流程只是等待,绝不算完成。

修订

调用 define,传入 Manifest 路径以及要在你授权范围内修订计划、既定假设或工作量预算,或记录用户指导的决定。 传入理由,并确保修订过程无人值守。只有当修订带来的收益足以证明其增加的复杂性和维护成本合理时,才调整工作量预算;修订必须同时说明这两者,并且必须在更广泛的工作开始前生效。绝不要直接修订,也不要凭自己的判断改写约束性要求。错误的约束性前提属于阻塞项。

等待正在进行的关卡评估完成后再进行修订。如果修订与某项评估同时发生,则丢弃该评估的判定,并对修订后的文件重新评估。 重新读取修订后的 Manifest。重新验证所有文本、对象或解释发生变化的关卡,包括工作量预算变化时的上限;只有在其他证据仍然有效时,才可保留这些证据。每条终止路径都必须报告重大修订,并在保留修订时将其记录到执行日志中。

延续

在实施之前(包括由 /auto 调用时),解析 Manifest 的绝对路径 并启动完成兜底机制:继续以一个明确标识同一文件的活动目标为依据, 或原样输出下方的目标块,并将 <manifest-path> 替换为 Manifest 的绝对 路径。不得总结、缩短、改写或重新标点。通过 harness 的目标设置、延续或 持久完成条件功能设置该目标,否则将其打印出来,以便复制粘贴。将目标块作为 一个完成契约输出:由你自己写的一句话引出一个无标签的块,因为围栏及其标签是 本文件的标记,并非你要输出的内容。如果更广泛的父级工作流兜底机制已可见, 且已要求每个关卡都提供证据(例如 PR-tend 契约),则在其约束下工作: 不要设置或打印第二个范围更窄的目标。

Work under the Manifest at <manifest-path> until every Acceptance Criterion and Global Invariant in it holds, each with evidence from the artifacts that gate names, and completion has been reported. Read this file before resuming execution.

The Manifest is the contract, not the run's to rewrite: it changes only through the skill that wrote it, never by direct edit, and a changed gate returns unverified.

Record compact checkpoint notes as work proceeds: what changed, what was verified, what remains, blockers.

Assume the user is AFK; make authorized decisions without asking questions. Surface blockers promptly and continue useful independent work. Stop after reporting completion, a blocker requiring a person when no useful independent work remains, or an external wait that this run's no-wait policy makes terminal. Continue while authorized, actionable work remains.

更正、债务与验证 harness

在运行报告之前加载 references/HARVEST.md;并且一旦修复某项发现、修复缺陷、 收到更正或对临时草稿的反馈,或触及解释变通方案或声称某项约束的注释,就应尽早加载: 如果有检查可以锁定更正,就将其锁定;对草稿的反馈会指引工作方向,并且只锁定超出该反馈 范围的内容;这类注释应予以改写或编码;本次运行遗留的债务要写入报告,以及其创建或更新的 每个拉取请求中。如果 Manifest 要求执行验证配方,或者项目保留了验证 harness(在上下文文件的 项目表面部分中列出,或虽未在该处列出却存于磁盘上;后者视为已选择),而工作需要它所缺少的 部分,或涉及任何配方都未覆盖的路径,则加载 references/VERIFICATION.md。 如果 harness 存于磁盘但未列入该部分,报告应建议将其记录下来。 harness 由项目自行选择:如果该部分列出了项目自己的验证方式,就通过所列方式验证, 并且不要建议使用 harness。如果该部分没有记录选择,且磁盘上也没有 harness, 就使用项目保留的方式验证,并在报告中建议采用 harness。无论哪种情况,都要按项目自己的 形式添加变更所需的任何检查,不要构建 harness。在每个项目中,无论是否有 harness, 如果工作遇到某项检查,而该检查已损坏或不值得信赖,就按自身形式修复,具体如 适用于每个关卡的要求 所述。项目拥有 harness: 即一个存放或即将存放后续会话将要修改的工作的仓库或工作文件夹——用户正在开始的新项目 也算——且本次工作与之相关。没有工作区的聊天、主目录或临时文件夹、只存放一件已完成 产物的文件夹,或与会话运行所在文件夹无关的问题,都不属于此类情况。如果不存在此类项目, Manifest 的关卡就是全部验证要求:不要构建 harness,也不要添加项目表面。项目中的一次性 工作仍属于项目工作:凡涉及其路径的配方都应保留,并按 references/VERIFICATION.md 的说明运行。

适用于每个关卡的要求

如何验证由你决定;但这些约定不可更改。在做出其所约束的选择之前,先理解每个关卡, 包括它委托给技能或参考文档的适用标准。构建和评估过程中都要使用这些标准,并遵循其阈值、 例外和权衡。这既不要求先进行初步审查,也不要求固定的评估顺序。

关卡必须声明为 judgment 或 deterministic;未声明类型即无效,绝不可自行推断。 按 ID 从 Manifest 读取关卡,绝不可使用副本。跟踪所评估的每项证据对应的标准和对象。 对任一方的变更,或新增的外部证据,都会使受影响的证据失效;仍适用的证据应予保留。 对象包括相关的本地工作和外部状态,而不仅仅是提交标识符。 裁定关卡会先完整审查一次更改,然后检查尚未解决的问题,以及自该次评估以来由更改引入或暴露的失败;确定性关卡则会重新完整运行。向被调用的评估器提供报告范围、已评估状态、先前的问题、已验证的修复,以及期间发生的更改。缺少上下文时,应补齐,而不是悄悄要求重新完整审查。上下文审查可以覆盖较广;仅仅触及旧代码行,并不会让旧问题变成新问题。全新且独立的审查仍遵循调用方要求的范围。执行者不得自行降低门槛,摘要中的说法也不算证据。

每个拉取请求都应让仓库变得更好。工作遇到的既存问题,无论是否与更改有关,以及低于关卡门槛的发现,都属于构建工作,而不是裁决:它们既不会导致裁定关卡失败,也不会触发新一轮完整审查。它们只能来自三个地方:Manifest 要求的更改路径——它运行的检查,以及它为完成更改而更改、调用或读取的代码;首次完整审查每个启用 review-code 的关卡时,向 review-code 索取的 Pre-existing 列表;以及拉取请求上的审查反馈(references/EXTERNAL_REVIEW.md)。制作一次性的草稿不属于其中任何一种。修复其中某个问题或修复某项发现时遇到的情况,以及审查针对仅由此类修复触及的代码提出的问题,只有在阻碍该修复或导致检查失败时才纳入范围,避免修复不断引出新问题。检查失败本身就是这类问题之一:仅为修复它而读取或编辑的代码,属于该修复遇到的情况,而不属于更改路径。修复既存问题;对于首次完整审查中有助于改进工作的低于门槛的发现,予以采纳,其余则说明理由后驳回。更改路径涉及的内容,作为构建工作的一部分修复。首次完整审查和审查反馈带来的问题应集中批量修复,而非逐项处理;之后,每个主题被该批次更改影响的裁定关卡只需继续审查一次,并且只报告该批次引入或暴露的尚未解决的问题和失败。继续审查不得列出既存问题;它报告的低于门槛的发现应搁置,不予采纳,也不移交:在修复后重新采样偏好会导致反复折腾,追着这类发现跑就是一个永无止境的循环。每项既存问题的修复都应作为单独提交落地,并在处理过程中由拉取请求列明为已修复项。无论 Manifest 附带的范围上限如何措辞,这些修复都是 Manifest 在任何范围下都要求的工作。

影响巨大的问题不在处理范围内:修复这类问题本身就是一个独立项目,需要有自己的完成定义——需要有人权衡的设计决策、超出本仓库代码范围的迁移或推出工作,或会掩盖拉取请求原本目标的审查。规模、相关性和便利性都不能让问题变成影响巨大。影响巨大的问题包括:在整个代码库中替换框架;重新设计更改仅经过的模块;迁移线上数据;因其他团队拥有的代码中多处锁定问题而需要作出架构决策。非影响巨大的问题包括:失败或无法运行的测试、损坏的测试框架脚本、过时的文档行、更改调用的辅助代码中的 bug 或类型漏洞、逐渐偏离现状的操作方案、本地即可调整的变通方案,以及几十处机械性的锁定问题。应将影响巨大的问题报告为债务,并说明它为何是独立项目(references/HARVEST.md);但若完成依赖于某项失败的检查——无论该检查覆盖整个代码树,还是某个关卡依赖它——则该问题会阻止完成(见下文)。如果问题需要由个人掌握的访问权限、权力或决策,应将其作为债务报告,并注明所需事项,例如尚待执行的先行询问式运行;但若某个关卡依赖它,则应列为阻塞项。若项目自身的规则——例如上下文文件、贡献指南或文档中说明的惯例——要求将与更改无关的修复排除在拉取请求之外,就应遵循这些规则:将此类问题报告为债务,而不是进行修复。但这绝不适用于完成所依赖的失败检查;此类问题仍应由本次运行负责修复,或升级为阻塞项(见下文)。 在报告完成之前,项目在整个代码树中保留的所有检查都必须通过——包括 lint、类型检查、测试和构建,无论更改是否涉及失败项。无法运行的检查意味着产品或其测试框架存在问题:修复它。除非某项测试毫无用处或只是同义反复,否则绝不能通过删除、跳过或放宽测试来让检查变绿;若属于这种情况,必须在拉取请求说明中写明该测试及原因。修复失败检查所需的工作量若过于庞大,则必须阻止任务完成:将其升级为阻塞项,绝不能报告本次运行已完成。若本次运行未更改任何项目文件(例如只生成了一份临时草稿),则无需遵守这些要求。

收到外部审查反馈时,无论是直接收到还是通过 check-pr 收到,都必须先读取 references/EXTERNAL_REVIEW.md,再采取行动。

执行日志

除非使用 --no-log,否则必须在 ~/.manifest-dev/logs/do-<name>-<hash>.md 中维护一份只追加、不修改的日志,其中 <name> 是不带扩展名的 Manifest 文件名,<hash> 是该文件绝对路径的 SHA-256 值的前八个十六进制字符,这样每次针对该 Manifest 启动都会重新打开同一份日志。恢复运行前先读取日志,并在执行过程中随时追加:目标区块的检查点说明应记录在其中。references/LOG.md 说明了恢复运行所需的日志内容。

评论

支持 Markdown