docs: require MDTODO tracking for subagents
Pipelines as Code CI / hwlab-web-probe-sentinel-nc01- Success
Pipelines as Code CI / platform-infra-gitea-nc01- Success
Pipelines as Code CI / unidesk-host- Success

This commit is contained in:
Codex
2026-07-12 19:24:16 +02:00
parent 3ea06cabdb
commit 192df5507c
2 changed files with 25 additions and 1 deletions
+4 -1
View File
@@ -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。
@@ -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)。