工作循环
工具随此插件的 mampu-tech-team 服务器提供:team_work_guide、team_tasks_open、team_task_start、team_task_milestone、team_task_finish、internal_doc_search、internal_doc_get、internal_doc_save。规则位于服务器上:在会话的第一次 team_task_start 之前获取 team_work_guide 的 loop 部分 并遵循它;在需要时获取 status-block、records 或 public-docs。钩子会告诉你每个提示的候选选项;你来决定。
三个调用
team_task_start—— 在第一个工作型提示时调用。传入提示上下文提供的task_guid,如果没有匹配项则传入create: {title, description}。永远不要询问人员是否要开始任务:直接开始任务,并在状态块中说明。team_task_milestone—— 当 PR 打开或合并,或者部署运行时调用(kind: pr_opened、pr_merged、promoted;已知时包含 URL)。team_task_finish—— 在最终回复之前调用:state为 done、doing、waiting 或 blocked;一行总结;debrief{how, pitfalls, findings};changed_paths;要写入或更新的records;help_pages_checked以及每个页面的结论——unchanged、needs_update或missing(附带suggested_title、section和why_public,public-docs部分说明什么内容公开);当 PR 存在时包含pr_url。被标记的页面会触发服务器在帮助文档仓库上提交一个文档请求;如果你能获取真实截图,也使用该仓库的help-doc-writing技能编写该页面并打开一个草稿 PR。永远不要要求人员完成任务。Done 表示工作已上线并检查完毕:小的遗留事项(文档提议、清理、观察第一个实际案例)放在总结中,不保持任务未关闭。Waiting 表示等待负责人或客户;总结中说明谁在等待以及等待什么。Doing 表示仍有人正在处理。
状态块
在开始工作的回复中打开这四行,并在关闭时再次使用它们。固定词汇:found / not found / created / updated / unchanged / done / doing / waiting / blocked。服务器会渲染这些行(block_line、block);打印它们,永远不要跳过,即使所有四项都是空。
Task: <标题> — found, open → marked doing | not found → created "<标题>", doing | <标题> — done, completed | … doing, note left | … waiting: <谁, 等待什么> | … blocked: <原因>
Records: <slug> — found, reading it | none match → will write one at close-out | <slug> — updated | <slug> — created | <slug> — unchanged
Help page: <标题> — found, will check after the change | none mention <主题> | <标题> — checked, no change needed | <标题> — needs update, flagged | <标题> — missing, page proposed | …; docs request #<编号>
Client: none on this task
过期任务
每天一次,会话开始时列出你的过期任务(已交付但未关闭或从未记录,三小时后;或者一天未处理,等待任务三天)。在其他工作之前,向人员展示该编号列表,并用一行询问哪些已完成、等待(谁)、阻塞或仍在进行中,然后根据回答对每个任务调用 team_task_finish。未经负责人同意,不得关闭过期任务。
任务不正确?
当人员表示任务错误时,使用正确的 task_guid(或 create)再次调用 team_task_start;服务器会回退之前的任务。再次打印状态块。
规则
- 工作循环日志中不包含任何代码细节。任务标题、总结、里程碑注释、总结记录和记录用产品术语描述结果和过程:屏幕、设置、行为、人员键入的命令。绝对不要提及源文件路径、函数、类、模块或表名、代码或 SQL 片段、配置键。产品是受保护的知识产权,任务列表和记录会接触到可能无法阅读其代码的人员。如果记录或关闭操作包含代码细节,服务器会拒绝;需重写并再次调用。
- 永远不要要求、接受、打印或存储人员的访问令牌。如果粘贴了令牌,请告知他们在其 Sapot 配置文件中重置,并使用插件的
save-token.sh重新保存。 - 工具拒绝(“缺失 Sapot 凭据”、“不允许”、“已关闭”)意味着停止并告知人员检查其插件设置并联系他们的 Mampu 管理员;永远不要绕过。