把默会知识
写进提示词

查询会随时间变化的产品、技术或规则信息，并且当前只需要一个可决策的结论。

“最新 + 官方 + 一句话”是非常高效的三重约束。它同时限定了时效、来源和输出密度，能避免回答者凭旧记忆展开一大段。

接手新仓库、准备架构重构，但还不希望 Agent 立即改代码。

这类提示词把“理解”和“实施”拆开了。对陌生项目尤其有效：既允许 Agent 主动取证，又用“先不要改代码”控制了授权边界。

接口、容器或本地服务“用不了”，需要定位根因，而不是收集一串通用建议。

好处不在于指定了命令，而在于指定了证据顺序。它迫使排障从表层错误走向真正的因果链，也让结论可以被复核。

已经重建、重启或重新初始化，但用户侧现象仍可疑，需要确认改动是否真正生效。

“不要重复建议，改做验收”是关键转向。它能避免修复对话在同一步循环，也能防止把“命令执行成功”误报成“问题已解决”。

添加一个小 UI 能力或修复单点交互，希望快，但不能跳过验证。

“小范围改动 + focused 验证 + 真实页面”很适合高频 UI 任务。它在速度和质量之间给出了清楚比例，不会为了一个按钮启动整套重构流程。

工作区存在多类未提交改动，希望形成可读、可回滚的 Git 历史。

“多次提交”很好，但补上分组原则更稳。实现、配置 / 版本和文档状态通常应该分开；先验证再提交，还能避免把未闭环状态写进历史。

另一个 Agent 已经处理过问题，需要独立复核，而不是让第二个 Agent继续无边界改代码。

先写“本轮只读”，能保持审查独立性。它避免 reviewer 看到问题就顺手修，导致你失去对“原方案是否正确”的判断依据。

为大家写产品操作指南、飞书文档或截图式 walkthrough。

文档也需要验收。真实页面决定操作顺序，读回结构决定交付是否完整；这比只要求“写得好看”更能避免指南与产品脱节。

让 Agent 启动或重启本地项目、市场、后端服务。

“命令退出 0”不等于“服务可用”。把持续进程、health 和页面三者写进成功标准，能显著减少假成功。

克隆、安装、构建或长任务正在运行，希望立即中止且不产生额外动作。

这是“短但好”的典型。停止、保留、禁止动作和所需回报都很明确。提示词质量不取决于长度，而取决于是否会产生分叉解释。

博客或网站功能同时涉及前端体验、上传 API、服务端限制、反向代理和线上部署。

这是 `my-blog` 任务里很成熟的问法。它把功能、设计系统和线上交付视为一个整体，也防止“本地构建成功”冒充“用户已经能用”。

生成 Amazon A+、商品图或模特图，需要避免为了氛围和排版牺牲产品事实。

视觉任务也要先定义真相源。“好看”不能覆盖商品结构；同时把验图和归档写入完成标准，产物才真正可复用。

分类迁移、远端发布或高风险数据操作存在 reviewer、canary、部署和回滚门禁。

允许 Agent 得出 NO-GO，是高质量授权。它把“完成工作”和“贸然上线”分开，特别适合 `swclawhub / ClawHub` 的迁移与发布任务。

为另一台 Mac、Windows 客户端或手机节点配置 Codex、CC Switch、OpenClaw 等工具。

它把服务侧探活和终端侧使用分开。适用于 CC Switch、OpenClaw iPhone 配对和客户端修复，能避免用一个 HTTP 200 过早宣布成功。

把本地项目创建为 GitHub 仓库、推送并修改可见性。

“创建、push、公开、回查”是一条完整外部写入链。它避免只创建 remote 或只做本地 commit 就收尾，也明确保护无关文件。

将本地 PDF 转为 Markdown，并要求原件、图片资源与输出共存。

这是非常具体、几乎不需要猜的文件任务。目标目录、产物集合、清理要求和验证方式都写清楚，适合大家直接复用。

整理桌面或个人目录，文件归类判断带有个人习惯，且误移动的成本较高。

个人文件任务的重点不是“整理得聪明”，而是尊重既有 taxonomy。可回滚、无删除、无覆盖让自动化整理更值得信任。