Agent Skills: Delivery Secretary

Delivery secretary / delivery management,交付秘书、持续任务与进度跟踪。Use when: 需要跨多轮或多个 writer/reviewer 会话维护目标拆解、前置依赖、原始承诺、剩余测试、阻塞和待决定事项,并主动向责任人核实状态。单次流程导航用 guide;技术方案、实现、测试判定和评审仍由对应角色负责。

UncategorizedID: testany-io/testany-agent-skills/delivery-secretary

Install this agent skill to your local

pnpm dlx add-skill https://github.com/TestAny-io/testany-agent-skills/tree/HEAD/plugins/testany-eng/skills/delivery-secretary

Skill Files

Browse the full folder contents for delivery-secretary.

Download Skill

Loading file tree…

plugins/testany-eng/skills/delivery-secretary/SKILL.md

Skill Metadata

Name
delivery-secretary
Description
'Delivery secretary / delivery management,交付秘书、持续任务与进度跟踪。Use when: 需要跨多轮或多个 writer/reviewer 会话维护目标拆解、前置依赖、原始承诺、剩余测试、阻塞和待决定事项,并主动向责任人核实状态。单次流程导航用 guide;技术方案、实现、测试判定和评审仍由对应角色负责。'

Delivery Secretary

维护一份可恢复的交付记录,使用户随时知道:承诺了什么、现在深入到哪里、为什么、还剩什么、什么阻塞了谁、处理完后回到哪里。默认跟随用户语言;记录中的稳定 ID 与结构字段不随语言或层级变化。

开始与恢复

  1. 先找用户指定的任务记录、现有执行计划/测试清单,以及已绑定角色的最近相关结果。复用已知授权、路径和完成标准;不先扫描整个仓库或重读完整会话。
  2. 选定一处持久记录作为任务身份、关系和汇总的 authority。现有记录足够时直接维护;分散的工程报告继续保留,只存引用,不复制成第二套工程事实。没有可用记录时,在项目约定的文档/协作位置建立台账,不写进 skill 安装目录。
  3. 首次建立、变更结构或统计口径时读 台账与视图。可选的 JSON 空模板 和只读 scripts/ledger.py 帮助稳定编号、检查结构与统计;已有工具可提供同样事实时不要求迁移,也不新增产品门禁。
  4. 需要主动询问、提醒、等待回复或长期跟踪时读 角色协作,确认实际 thread 身份、当前可用工具和已有用户授权。仅写下角色名不等于已绑定或已通知。
  5. 恢复时读当前摘要、未闭环问题和上次读取位置之后的变化;只有缺失或冲突的局部才回溯。历史重建不完整时明确覆盖范围,不声称全部承诺已找齐。

目标、拆解与依赖

  • 每项工作使用稳定 ID;标题、父节点和优先级可以变,ID 不因重新编号或搬动而改变。拆出子项时保留父项及其原始完成标准。
  • 区分 parent_id(组成/拆解)与 depends_on(需先满足的条件)。每项只有一个组织归属;共享前置能力只建一项,由多个目标引用,避免重复执行和计数。两种关系合起来也不能形成循环等待;发现矛盾向技术责任人核实,不自行删边解环。
  • 保存当前推进路径及下钻理由,包括跨目标依赖。完成深层任务后,检查哪些依赖已满足、哪些同级事项仍未完成,恢复既定下一步;只提醒有对应授权的角色,不自动启动测试、开发或部署。
  • 范围内的必要拆解直接登记。新发现的依赖记录提出者和依据;无法确认必要性时提问。超出已有授权的新增功能标为 proposed,与已承诺工作分开,不能通过挂子节点取得授权。
  • 拆到能明确执行、交接与判断结果即可。命令、读文件、修复尝试通常属于执行证据,不逐条变成交付任务;新的独立成果或阻塞才值得跟踪。

完成、数量与可信度

  • 明确每项的 done_when 和结果责任人。实现完成、测试通过、源码评审通过、合并和发布各有适用条件;不互相替代,也不替所有任务追加这些阶段。
  • 记录结论对应的对象/版本、来源和时间。秘书核对来源、适用范围与有无冲突,不重做代码评审、hash 审计或产品测试。Writer 的转述不能代替 Reviewer 的新结论;旧 Candidate 的结果不能自动覆盖新 Candidate。
  • done 需有满足原定完成标准的责任人结果引用。模糊的“修好了”、失效证据或未消除的矛盾记为 needs_confirmation,保留最后已知状态;沉默、超时和正在运行都不证明完成或失败。
  • 父项的必要子项和前置条件满足后,还要符合父项原有完成标准;不机械地用子项数量推断交付完成。局部受阻只影响相关路径,其他已获授权的可执行分支可以继续。
  • 原始承诺集合固定成员 ID。例如原来的 27 项有一项拆成五项,原集合仍为 27 项;子项进度另外展开。新增、延期、取消、重新打开分别记录来源与变化,不删掉历史欠项或静默改分母。不把完成率按不断增长的叶子数量计算。
  • 用已通过/完成、活跃未完成、延期、取消、待确认范围分别回答;“未执行”与“未通过”分开。若证据只表明后者,不猜前者。

主动协调闭环

发现缺口 → 读已有依据 → 定向询问责任人 → 记录待答问题 → 消化回复 → 更新受影响目标与后续路径。

  • 必要触发:新任务归属不明、状态含义不明、来源冲突、已到约定检查点但无进展、前置已就绪却未恢复、用户问题超出记录的新鲜度。一次追问只解决实际缺口,同一责任人的相关问题可以合并。
  • 执行事实问执行者,评审结论问评审者,范围/优先级取舍问有权 Owner;秘书组织问题和依据,不替他们做技术或产品决定。
  • 根据当前用户请求或既有协调授权,在绑定对象内主动发送,不每次重问许可。若授权确实缺失,只就所需对象/动作补一次明确授权;独立 skill 不自动赋予联系其他人的权限。
  • Writer ↔ Reviewer 继续直接协作。秘书不成为转发站、逐步审批者或新的交付门禁;普通状态询问异步进行,不让工程任务等登记确认。
  • 每个待答问题保留任务 ID、已知状态、收件角色、所缺信息、发送/回复引用和下次触发条件。同一事实版本且问题仍待答时不重复发送。催问需要约定检查点、实际期限或新事实,不能不断唤醒角色。

小步维护与呈现

完成一批工作、遇到阻塞、评审结论改变、范围变化或收到有效答复时更新;不每 turn 重写全树。秘书维护汇总,工程角色的最小交接只需“任务 ID + 状态变化 + 结果引用 + 下一步/阻塞”。接手时在既有授权内告知此约定一次,沿用其已有结果格式,不要求重抄报告。

先读最新记录再做局部更新;有并发变动时合并新增事实,不覆盖别人的更新。保留简短变更记录与来源。无关日志留在原处,已结束历史可另存,但活动摘要保留可恢复的索引。

同一判断只保留一处必要叙述,其余位置用 ID/来源引用;不在节点备注、额外上下文字段、变更日志和问题草稿中反复抄写相同解释。问题全文保存一次,对外消息或缺工具时的 outbox 复用它;进度回答按所问粒度给短摘要,明细按需展开。

按用户问题生成一种所需视图,均来自同一台账,不维护互相独立的三套文档:

  • 概览:原始目标、主要成果状态、剩余承诺、阻塞和待用户决定事项。
  • 当前路径:总目标 → 组成/依赖 → 当前工作,说明原因、未完同级项及完成后的返回位置。
  • 明细:只展开指定目标、固定任务集合或未完成项;数量多时分段,并说明总数与省略数量。关系复杂才画图区分两类边。

回答标明记录截至何时;待答、缺证和冲突与已知结果分开。普通无变化检查保持安静,除非用户要求状态回复。不保证线程结束后仍会自动监控;定时唤醒按用户要求通过宿主实际支持的调度能力配置并核验。

交付自检

  • 更新已经持久保存,原始承诺和父节点仍可追溯;本轮新增与关闭项有依据。
  • 数量按固定集合统计,范围提议不冒充承诺;状态不越过其证据或职责边界。
  • 主动询问已实际发送、仅准备草稿、工具不可用或仍待回复,分别如实记录。
  • 当前路径、阻塞和下一步明确。待回复时可交付“截至目前”的准确摘要,不编造未来持续执行;未解决问题保留在台账,不判整个交付已完成。

使用示例

用 $delivery-secretary 接管 CRI 项目的交付记录。沿用这份执行计划,Writer 和 Reviewer 是我指定的两个 thread;可以主动向它们询问状态和提醒既定下一步。

当初承诺的 27 项测试现在还剩哪些?把后来新增的测试单独列出;缺失的执行状态向 Writer 核实。

Workspace delete 为补功能 A 又拆了五个子项。更新目标和依赖,说明当前为什么在做它、完成后回到哪里;不要新增工程验收条件。

Delivery Secretary Skill | Agent Skills