AI LogicTune

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install logictune
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 logictune。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AI LogicTune 是一份指导手册，用于将策略性工作原则应用于代理接到的任务。它指示代理阅读技能包内附的 AGENTS.md，在遵守更高优先级指令的同时遵循其中的原则，并将外部参考资料作为证据，而不是替代指令。本指南不会授予新的能力或授权。
在用户明确要求时，LogicTune 也可以合并到当前工作区的 AGENTS.md 中，作为持久化设置。它强调保留现有指令、透明地解决实质性冲突、验证保存的结果，并区分文件编辑成功与在新会话中确认加载。这使 Openclaw Skills 适用于希望以有纪律、可审计的方式塑造代理行为的团队。

应用场景

在完成特定的用户请求任务时应用 LogicTune 原则。
明确将 LogicTune 添加到当前代理的操作指令中，以便持续使用。
检查现有的
AGENTS.md
并合并原则，不丢弃既定规则或偏好。
references/checks.md
中的相关案例诊断行为故障或检查合规性。
评估关于支出、文件访问或停止行为的保证请求：找出现有运行时控制，并将任何必要变更单独提出。

工作原理

阅读随附的 AGENTS.md，并将其中相关原则应用于所请求的任务，同时遵守更高优先级的指令和用户的明确选择。
如需持久化设置，从已知上下文或用户选择的路径中确定当前工作区的 AGENTS.md；如果目标位置不明确，则询问用户。
阅读目标文件中的指令，检查是否已有相关原则和版本标记，然后在不重复内容或删除既定规则的前提下进行合并。更改受影响的指令前，先指出实质性冲突。
将更改限制在所选指令文件中。不要更改运行时配置、权限、其他代理、记忆文件或后台任务。
回读保存后的文件，并检查可用的运行时诊断信息，以确认实际生效的指令文件并检查是否可能发生截断。
在授权工具允许的情况下，于新会话中验证加载情况，不重启服务或重置当前对话。否则，提供验证步骤，并报告加载状态尚未验证。
报告目标位置、版本、合并结果和观察到的加载状态。如果无法写入，则提供拟议的新增内容，但不要声称已成功安装。

配置指南

此软件包不包含脚本，也不需要凭据。用于任务时会读取随附指南，并使用代理现有的工具。持久化设置需要用户明确请求，并且能够访问所选工作区的 AGENTS.md。
确定当前工作区，或询问用户指定目标 AGENTS.md。
阅读现有指令并合并 LogicTune 随附的原则，同时保留现有规则和偏好。
回读保存后的文件并检查可用的诊断信息。报告是否观察到指令已加载；如果未能验证会话加载情况，不要声称已验证。
此技能未指定 CLI 安装命令。仅加载或调用 LogicTune 并不构成持久化编辑的授权。“install and activate AI LogicTune”（安装并激活 AI LogicTune）这一请求授权将其合并到当前的 AGENTS.md 中，除非目标位置不明确，或存在需要用户决定的实质性冲突。

数据架构

LogicTune 基于指令和参考资料，不定义生成的数据格式，也不包含脚本。
项目 用途
SKILL.md 定义何时及如何应用此技能、持久化设置的边界、行为检查以及访问要求。
AGENTS.md 随附的源指南，其中包含要应用或合并的操作原则。
references/checks.md 用于用户要求的行为检查或已观察到的故障诊断的相关案例。
当前工作区 AGENTS.md 用于经明确授权后进行持久化合并的可选目标。
版本元数据 技能版本为 0.1.4；检查目标文件中是否已有 LogicTune 版本标记，但不要仅凭标记就认定原则已经存在。
此技能默认不会生成单独文件。持久化设置仅限于所选指令文件，并且必须区分已保存的合并内容与代理实际加载的指令。

高级特性

受控的持久化设置：
需要明确授权，仅以所选的
AGENTS.md
为目标，并保留现有规则和偏好。
考虑冲突的合并：
合并重复内容，并指出实质性冲突，而不是悄然覆盖指令。
编辑后验证：
回读已保存的内容，并检查可用的运行时诊断信息，以确认实际生效的指令文件并检查是否截断。
加载状态报告：
区分已完成的文件合并与已确认的会话加载；不会为了验证而重启服务或重置对话。
按需进行行为检查：
在用户要求时或诊断已观察到的故障时，使用
references/checks.md
中的相关案例，而非每项任务完成后都运行检查。
考虑辅助代理的任务上下文：
将相关原则传递给已参与任务的辅助代理，并在可观察的情况下检查其实际生效的指令，但不假设指令会继承，也不编辑其工作区。
明确的授权边界：
不授权新增钩子、权限、硬性限制、运行时变更或创建辅助代理。

name: logictune description: Apply AI LogicTune's strategic working principles when the user asks to use LogicTune, or add them to the active agent's operating instructions when the user requests persistent setup. license: MIT-0