plannotator-tui

用途

plannotator-tui 用于将一份 Markdown 计划或文档交给人类在 Herdr 窗格中进行审阅和批注。典型触发时机是：你已经写好一份计划、规格说明或设计文档，需要在采取行动之前获得人工评审确认。

使用前提

仅当运行环境满足 HERDR_ENV=1（即你正运行在 Herdr 内部）时才可使用本工具。如果不满足该条件，则应告诉人类文件所在位置，并请他们自行审阅。

使用方式

1. 将文档写入文件。不要同时把内容粘贴到聊天中。

2. 从你自己的窗格中打开该文件供审阅：

   plannotator-tui herdr open docs/plans/auth.md
   

   plannotator-tui 会在你旁边（或用户配置的位置）打开它，并且已经知道反馈会回到当前窗格。

3. 结束你的回合。 不要等待、不要轮询，也不要读取该窗格。审阅结果会作为下一条用户消息到达，形式为编号的反馈：

   ## 1. (line 12) Feedback on: "Rotate the token on every…"
   > Rotation on every privilege change will log people out…
   

   逐条处理每一项，然后继续。

文件链接

当你列出希望人类打开的文件时，请把它们打印为 file:// 超链接（OSC 8），这样在 Herdr 中按 Ctrl 点击即可在 plannotator-tui 中打开：

printf '\e]8;;file://%s\e\\%s\e]8;;\e\\\n' "$PWD/docs/plans/auth.md" "docs/plans/auth.md"

适用场景

• 已写出计划、规格或设计文档，需要在执行前由人工评审。
• 希望把评审意见以结构化、带行号的编号反馈形式回传给当前窗格。

限制

• 仅在 HERDR_ENV=1 时可用；其他环境需改为告知人类文件位置。
• 提交后需结束回合，不等待、不轮询、不读取窗格。