From 192df5507c8d9a7e8667f5b9f8f36e4190b4683d Mon Sep 17 00:00:00 2001 From: Codex Date: Sun, 12 Jul 2026 19:24:16 +0200 Subject: [PATCH] docs: require MDTODO tracking for subagents --- .agents/skills/unidesk-subagent/SKILL.md | 5 ++++- .../web-sentinel-runtime-reliability.md | 21 +++++++++++++++++++ 2 files changed, 25 insertions(+), 1 deletion(-) create mode 100644 docs/MDTODO/web-sentinel-runtime-reliability.md diff --git a/.agents/skills/unidesk-subagent/SKILL.md b/.agents/skills/unidesk-subagent/SKILL.md index 4796339d..0cd64abd 100644 --- a/.agents/skills/unidesk-subagent/SKILL.md +++ b/.agents/skills/unidesk-subagent/SKILL.md @@ -37,7 +37,10 @@ description: UniDesk 主代理调度子代理的必读技能。用户提到子 - 纯文档交付可以按 `$git-spec` 的稳定分支快路径由主代理直接 commit/push，不要求临时 branch、`.worktree` 或 PR；发现本地分叉、并行改动、分支保护或运行面影响时必须保留状态并回到隔离交付。 - 正式 GitHub issue/PR/comment/merge 仍走 `$unidesk-gh`；子代理可以提交 PR 和写调查结论，主代理负责 review/preflight/merge，除非用户明确授权某个子代理自上线自验证。 - 主代理和子代理必须通过 issue/PR/comment 链接传递可复用上下文、调查结论、证据链接和下一步边界；派发前先读既有评论，prompt 中只引用链接和增量任务，不复述长结论，避免不同子代理重复调查同一事实。 -- 主代理派发执行型子代理前必须先创建子 issue，并把主要任务、接续上下文、目标分支/worktree、范围、禁止项和验收入口写入子 issue 正文；子代理 prompt 只给子 issue 链接和极短边界，不塞大段任务正文。每个执行型子代理维护自己的子 issue 和评论作为接续上下文；主 issue 评论区只由主代理写入主线 anchor、阶段汇总、调度决策和最终 closeout。 +- 主代理派发执行型子代理前必须完成两项登记： + - 创建子 issue，把主要任务、接续上下文、目标分支/worktree、范围、禁止项和验收入口写入正文； + - 使用 `$mdtodo-edit` 将子 issue 链接登记到对应泛化问题域的 MDTODO ITEM 或 SUBITEM；不得为单个 issue 创建窄范围 MDTODO FILE。 +- 子代理 prompt 只给子 issue 链接和极短边界，不塞大段任务正文。每个执行型子代理维护自己的子 issue 和评论作为接续上下文；主 issue 评论区只由主代理写入主线 anchor、阶段汇总、调度决策和最终 closeout。 - 子代理不得把过程日志、单步证据、长调查和 post-task 反馈直接堆到主 issue 评论区，只能在主 issue 需要可见时由主代理引用子 issue/PR/comment 链接。 - 主代理跟踪子代理进度时优先读取子 issue 评论区、关联 PR 更新和 bounded issue/PR 状态；不要为了普通进度查询主动 `send_input interrupt` 打断子代理主线。只有子 issue/PR 长时间无更新且只读 worktree 也无推进时，才进入问询、关闭和重开流程。 - 每个子代理 prompt 必须写清 repo、目标分支、独立 worktree、issue/PR、禁止触碰范围、验收命令、证据字段和是否允许部署；不要让多个子代理共享同一可写 worktree。 diff --git a/docs/MDTODO/web-sentinel-runtime-reliability.md b/docs/MDTODO/web-sentinel-runtime-reliability.md new file mode 100644 index 00000000..6066764f --- /dev/null +++ b/docs/MDTODO/web-sentinel-runtime-reliability.md @@ -0,0 +1,21 @@ +# Web 哨兵运行时可靠性 + +- 范围：Web sentinel 调度、observe/analyze 终态、报告产物、SQLite/index 与 latest 查询的一致性。 +- 权威路径：沿用 YAML-first Web sentinel、既有 observe/analyze、报告产物和单一索引，不建立旁路 scheduler、store 或补洞入口。 + + +## R1 [in_progress] + +解决 [UniDesk #1861](https://github.com/pikasTech/unidesk/issues/1861)：修复 NC01/v03 Web 哨兵控制面与 cadence 正常但 latest 报告长期不更新的问题，只修既有调度→observe/analyze→产物→SQLite/index→latest 路径，不扩展次生问题，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1_Task_Report.md)。 + +### R1.1 [in_progress] + +单步定位 [#1861](https://github.com/pikasTech/unidesk/issues/1861) 中新 run 未进入 latest 的唯一断点，区分调度、终态、产物、索引和查询层，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.1_Task_Report.md)。 + +### R1.2 + +在 [#1861](https://github.com/pikasTech/unidesk/issues/1861) 边界内实现最小修复和定向测试，由 Artificer 创建独立 PR，不新增旁路或补洞，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.2_Task_Report.md)。 + +### R1.3 + +PR 合并后只等待自动发布链，使用受控 Web sentinel 原入口产生新 run，并验收 latest 返回新鲜非空 run.id/status/updatedAt，完成任务后将详细报告写入[任务报告](./details/web-sentinel-runtime-reliability/R1.3_Task_Report.md)。