用途:draft-review-loop 用于运行“人工—智能体”评审循环,让作者身份保留在本地 Markdown 文件中,而 Draft 作为评审界面。适用于用户要求撰写或修订文档并希望在 Draft 中评审的场景,例如“写一份文档让我在 Draft 里评审”“准备一份提案供 Draft 评审”“根据 Draft 评论修订工作区文件”“以 Draft 为评审界面、仓库文件为唯一事实来源”。
主要能力与工作流:按顺序执行——先创建或更新本地 Markdown 文件;通过 draft-cli 的连接优先模式确保 Draft 连接(draft status --json,必要时恢复);用 draft open <path> --json 在 Draft 评审界面打开本地文件;明确交接给人工评审;用 draft workspace comments <path> --json 读取 Draft 评论;再用普通文件编辑工具把接受的反馈应用回本地 Markdown 文件。
使用方式与交接话术:在 draft open <path> --json 之后使用直接交接语言,例如“我在本地更新了 <path> 并在 Draft 中打开供你评审”“请在 Draft 中留下评论,我会把接受的反馈应用回本地文件”。可复用模板包括“我在本地写了 <path>(事实来源)并在 Draft 中打开供你评审”“请在 Draft 中评审并留下评论;我会根据接受的反馈更新本地 Markdown 文件”“我读取了 <path> 的 Draft 评论,并把接受的更改应用到工作区文件”。
适用场景:提案评审、规格评审、发布说明评审等需要人工评审的文档协作。
限制与边界:事实来源是本地工作区 Markdown 文件,评审界面是从该文件打开的 Draft GUI 页面,传输与命令处理由 draft-cli 技能负责;本技能定义工作流行为,不处理底层 CLI 故障排查。当用户只询问如何运行 Draft 命令(draft status、draft page ls、draft page patch 等)、仅把 draft 当作通用写作动词(如“起草一封邮件”)、或要求以直接修改 Draft 页面为主要写作界面时,不应触发本技能。评论到达时默认编辑本地文件,除非用户明确要求页面优先修改。不暗示完全无头实时协作,不把事实来源从工作区 Markdown 移到 Draft 页面。