Skill 维护说明

本 Skill 的全局行为准则在知识库源目录维护，由发布钩子写入各运行环境。发布本 Skill 会更新下表全部全局指令文件；--agent 只限定 Skill 副本的发布位置，不缩小钩子的写入范围。

权威来源与写入目标

全局行为准则分两版，连同对照笔记一起放在本 Skill 的 Agent行动原则/ 目录：

• Agent行动原则-指令版.md（条目指令版）：发布源。修改时编辑这份文件，发布与同步使用环境已有的 Skill 维护能力。发布副本中的来源注释可用于定位知识库目录。
• Agent行动原则-角色版.md（角色化叙述版）：仅保留在知识库中，不进 include、不随 Skill 发布、不写入全局指令；同目录的《指令式与角色式提示词》记录两版来历与对照。

发布钩子 scripts/__init.py 将指令版逐字节复制到：

运行环境	写入目标	作用
Claude Code	~/.claude/CLAUDE.md	全局行为指令
Codex	~/.codex/AGENTS.md	全局行为指令
Pi	~/.pi/agent/SYSTEM.md	替换 Pi 默认系统提示词

发布切换记录（2026-10-17）

此前发布的是角色版。实际使用中观察到：模型在边缘决策上易自作主张，例如用户只要调查诊断、仅给出倾向，模型却在查完后直接执行修改。怀疑与角色版以关系和习惯组织行为的写法在大模型上的适配有关——此为假设，未经两版对照测试证实。作为应对，全局发布切换为约束更直接的指令版，并为两版补充同一条原则：任务范围以当次请求为准，调查止于结论与可选做法，动手改动需要明确委托。角色版保留用于对照与后续验证。

发布后怎样核对

include 先把 Agent行动原则/Agent行动原则-指令版.md 放入发布副本，作为钩子的临时输入。全部目标写入成功后，钩子删除这份临时文件；发布器再删除已成功执行的 scripts/__init.py。知识库源文件始终保留。

因此，成功发布后核对工具报告 only in vault: Agent行动原则/Agent行动原则-指令版.md，符合临时输入已被消费的预期。应结合发布结果及全局指令目标文件核对，不能只凭这一条差异判定失败或成功。

写入失败时，钩子保留临时输入并返回非零状态，发布器保留钩子供排查。部分目标可能已经更新；再次发布前，应修正源端问题并确认实际目标状态。