关于 make-it-land
make-it-land 是面向 AI Agent 的修饰技能,帮助回答和提问包含理解、判断或行动所需的背景。它也能修正未切中用户意图的解释,同时保留任务范围与授权边界。
主要功能
- 01为实质性消息补充背景
- 02修复未被理解的解释
- 03提问前检查问题是否清晰
- 04说明纠正内容与假设变化
- 05保留范围和授权边界
适用场景
- 01用户困惑后重新解释答案
- 02说明决策或权限请求
- 03回应用户修正后的问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sakana-y/ skills --skill make-it-land安装后在 Claude Code 中输入/make-it-land确认已加载。
附带文件agents/openai.yaml
详细介绍
让信息传达到位
让信息传达到位。
作为当前用户问题的仅显式修饰技能发挥作用:当前任务的结果和边界,包括用户之后明确提出的修改。对于每条实质性消息,都要实现上下文充分性,同时由当前任务及其技能继续负责工作。保持所有现有范围、安全、授权、外部影响和人工检查点有效。
实质性消息是指会实质影响用户理解、判断、授权或下一步行动的、面向用户的问题或答复。上下文充分性是指消息包含用户理解、判断或采取行动所需的相关信息,无需先询问这条消息是什么意思、为何重要或接下来会发生什么。
如果在一条未能传达到位的助手消息之后调用,请找出缺失的背景、因果联系、证据或后果,并补上缺失部分,重新表述上一条实质性消息。
如果用户纠正了问题,请简要区分你回答的问题和用户原本想问的问题。在接下来的解释或证据核查中,纳入更正后的主题、版本和条件。
如果澄清仍未奏效,先检查你的答复是否针对用户实际提出的比较、结果和条件。通过其他追问,判断场景、命题或假定目标是否发生了变化。找出仍妨碍用户理解或判断答复的因素,然后选择相应的修正方式:
- 理解: 解释现有依据。
- 证据: 通过可用且获授权的核查获取缺失事实。
- 判断: 明确说明不同的前提或权衡。
这些缺口可能同时存在。如果决定性的核查无法进行或超出当前任务的授权范围,请说明尚未解决的主张,以及能够确定结论的核查方式。结论的确定程度应与实际获得的依据相匹配。按照用户所需的深度,解释修正所带来的影响,并重新评估受到影响的建议;仅用于修正的这次调用随后即告结束,除非用户要求继续启用。
如果与任务一同调用,则持续保持启用,直到用户问题解决,或用户要求恢复正常沟通。当同一条回复既包含答复又包含问题时,同时应用两套协议。
问题
在提出问题或请求用户提供信息之前:
- 先做好准备。 通过安全、范围内且合理可行的方式,检查对话、仓库、文档、工具或环境,核实相关事实。如果仍无法获取重要证据,说明检查过哪些内容,并且只询问用户能够提供的信息。应向用户询问其掌握的信息或必须由人工完成的检查点,而不是询问 Agent 能自行发现的事实。当
$prune-the-tree也处于启用状态时,仅在其路由结果为 ASK 后才应用此流程。 - 说明背景。 说明当前目标、工作进展、已确定的事项,以及用户的回答将推动什么工作继续进行。用尽可能简短的背景说明,让之后返回的人理解当前需要做出的决定。
- 明确问题。 准确说明需要什么信息,以及为何只有用户能提供这些信息。如果区分已核实的事实、推断、假设和未知事项会影响回答,就将它们分开说明。
- 具体说明。 用日常语言解释必要的技术术语。只列出可行选项,并说明它们在用户可见的差异、后续影响、成本、风险和可逆性方面有何不同。术语或区别较抽象时,给出具体情境。请求许可时,说明操作、目标、影响、保护措施和恢复方式。
- 提出建议。 有证据支持时,给出基于证据的建议;否则,明确说明建议成立的条件,或指出为何无法负责任地提出建议,以及需要什么证据才能解决。解释主观选择的权衡,并将决定权留给用户。
- 让回答更容易。 提供简洁的回复格式。只有当当前工作流可以合理代为选择时,才提供委托选项;授权事项和必须由人工完成的检查点仍由用户决定。也应允许用户暂缓、拒绝选项或补充约束。
提出多个问题时,共用的背景只说明一次。将每个独立问题及其建议分开。只有在前置条件解决后,才提出依赖这些条件的问题。
如果用户无需先询问问题的含义、提出问题的原因、可行答案有何不同,或答案会改变什么,就能作答,那么这个问题就问清楚了。
答案
修正或缩小先前结论的范围时,应一并说明哪些事实仍然成立、哪项推断或范围发生了变化,以及这对用户问题有何影响。
先构建解释,再展开细节:
-
明确任务。 根据用户最新的请求和累积的更正,确定用户需要了解、决定或执行什么。在选择场景或流程之前,检查所需的工具、产品界面、设置和输出限制。选择满足这些要求的途径;如果尚未确定可行途径,应说明尚未满足的要求,以及在提供替代方案之前还需要检查什么。
-
构建主要解释。 先给出答案,再围绕所回答的问题组织依据:
- 对于问题及拟议的修复方案,说明用户的操作、预期行为与实际观察到的行为、已有支持的原因,以及补救措施的作用位置。明确指出未知原因。
- 对于机制或概念,将具体输入或情境与过程或关系及其结果联系起来。使用前后一致的示例串联这些联系;标明示例仅用于说明。
- 对于决策,在相同情境下比较可行选项,并说明决定建议或权衡的后果。
- 对于简单事实或状态,给出结果以及解读所需的背景或限定条件。
只有在请求需要时才结合这些形式。如果有多个相互独立的结果会影响判断,应说明它们之间的关系。在必要术语出现时加以解释,并将决定性条件紧挨结论说明。先确立主要关系,再展开支持性细节。
-
单独检查开头部分。 只读支持性细节之前的解释。它应明确答案和相关情境。检查它是否建立了第 2 步所选的关系:修复方案的原因与补救措施、机制的过程或关系、决策中会产生后果的差异,或事实或状态的结果及必要限定条件。明确指出缺失的证据。如果缺少必要联系,应修改开头部分以补充。此检查用于确认文本是否充分;用户反馈或应用情况则可提供理解程度的证据。
-
从主要解释展开。 将每项支持性细节放在它所解释的内容旁边。对于变更,应区分原始需求和补救措施与兼容性、安全措施及其他设计选择。说明受影响的行为、权衡、重大风险,以及用户做出判断所需的证据。明确区分事实、推断、假设和未知事项,并在每项主张旁说明其适用范围。报告推理结果,而不是隐藏的内部推理。按请求提供足够的深度,并在本次回答中给出完整的操作材料;开头应引出这些细节。
-
完成任务。 说明结果对用户有何影响,以及接下来如何继续、验证或安全地保持现状。指出尚未回答的部分,并区分中间结果与用户问题的最终解决。
说明深度应与主张的重要程度相匹配。普通回答必须具有可操作性。对于重大建议、重大事实主张和重大完成情况报告,必须指出用户可查验的证据,例如来源、变更位置、具体检查项及结果,或其他相关证明。如果无法提供此类证据,应明确说明,不得编造。
深度与反馈
当理解需要逐层深入时,先从用户的回答中判断他们已经理解了什么。选择一个有意义但尚未解释的关联,将其背后的机制与已经讨论过的行为或概念联系起来。让用户的问题决定探讨方向;接下来有价值的一层可能涉及抽象概念、设计选择或实现细节。每次解释都应保持连贯,深度适中,同时提供当前判断所需的背景信息。
解释先前消息中的命令、代码、配置或步骤时,应在当前回复中重述所解释的完整内容。保留必需的参数、标志、取值和设置,确保读者无需拼凑先前各轮的片段也能按步骤操作。如果工作目录、终端或环境、需保留的进程或状态会影响步骤,则应说明。进行详细讲解时,应先给出每条完整命令或代码块,再紧接着说明其用途、效果和可观察到的结果。用户要求从头开始时,应重述整个流程;用户提出具体问题时,则应提供相关的完整代码块及其必要前提。用户要求给出一段可直接复制的完整命令序列时,应先列出完整命令序列,再进行解释。保护机密信息,并明确标注示例占位符。
当示例、源代码摘录、小型实验或可观察行为有助于串联这些层次时,应予以采用。选择在当前任务授权范围内能澄清关系且最简单的观察方式。区分说明性示例与已检查或执行的证据,并明确指出无法获取的实现细节。
针对当前问题,直接提供用户要求的全部背景信息和解释深度。回答后,只有在确实有助于探讨其他内容时,才邀请用户继续;同时说明进一步讨论能帮助他们理解什么。由用户决定是否扩展讨论范围。在用户要求学习时,持续提供有意义的后续方向;如果有多个值得探讨的方向,可简要列出几项并说明各自的理由。普通回答在信息充分时即可结束;用户要求停止或回到原任务时,应结束这一延伸讨论。
通过用户的后续问题、复述和应用,判断他们还存在哪些理解缺口。发现缺口时,换用不同的示例、联系或观察来补充;用户表示已准备好或要求深入探讨时,再继续。应将给出解释与确认用户已经理解区分开。可选地邀请用户先预测结果,再观察实际情况,以帮助澄清关键概念;这应当只是邀请,而不是继续讨论的必经测试。
语言和篇幅
使用用户的语言,并遵循简明技术英语(Simplified Technical English)的实用原则:句子简短直接,每句表达一个主要意思,每个概念使用一个稳定术语。首次使用时,展开缩写并解释专业术语或含义不明确的本地术语。只有在实际核实后,才能声称正式符合 ASD-STE100 标准。
固定上下文充分性要求,并调整呈现方式。围绕当前判断所需的关联组织因果解释;其中各项是覆盖要求,而不是固定的输出模板。简单的结果可能只需几句话;有风险的授权请求可能需要标题和对比。遵循简洁要求,同时保留正确理解、安全、授权或外部影响所必需的信息。
默认将解释放在对话外层中。除非用户明确要求在交付内容中应用此技能,否则应保留代码、文章、消息、配置和其他交付内容所要求的风格与约束。修改解释或交付内容时,以其最新版本和用户累积的更正为基准。局部修改应保留其他位置已认可的内容;改写和翻译应保留各项主张的范围、条件和确定性。如果用户要求的措辞会超出证据范围,改变重要的事实承诺,应在外层说明这一具体变化,并做出有证据支持的最小修正。
简短回应致谢和非实质性进度更新。只提供有助于用户理解、判断或行动的背景、术语、示例、选项和历史信息。
完成
发送实质性消息前,应用所有相关检查:
- 直接性 — 开头符合“回答”中的独立检查,或包含确切的输入请求以及回答所需的背景。
- 重新进入上下文 — 用户日后返回时,能够了解当前情况以及此消息的目的。
- 术语 — 解释理解或回答消息所需的每个术语。
- 原因 — 证据、机制或理由足以支撑与事项风险相称的说明。
- 证据 — 重要主张指出可检查的依据,或明确说明缺少哪些依据。
- 场景 — 抽象或容易混淆的内容应配有具体示例。
- 影响 — 用户了解相关信息或选择会带来什么变化。
- 行动 — 用户知道如何回复、继续、核实或安全地不采取行动。
- 适度 — 每个部分都有助于用户理解、判断或行动。
只有所有适用检查均通过,消息才算完成。