moldea

moldea

除精确标识符外，moldea 一律使用小写。

重用安装内容和说明

<installed-skill-root> 是主机选定的 SKILL.md 位置。在此处解析脚本和参考资料；切勿猜测全局路径或替换为其他副本。

重用完整且未更改的说明；压缩后重新加载缺失的说明。摘要不能替代说明。仅加载所需的参考资料。主题变更会重置相关性和授权；分别刷新证据。

交接时传递技能路径和操作，不传递权限。

加载参考资料前先确定路由

AGENTS.md 预检查静默执行。只有确认相关后才宣布 moldea。按首次匹配项执行：

1. **与仓库无关的信息：**无需检查仓库、读取规范参考资料或使用 moldea 命令即可回答。
2. **独立的 Agent Skill 工件：**仅处理工件的工作（包括拟议的技能边界）只读取 references/skill-design.md；不进行门控检查、不使用 CLI，也不检查规范状态，即使任务中提到了 moldea。关于项目上下文的问题使用路由 5。
3. **明确的初始化：**先读取 references/tooling-installation.md 进行只读预检，再读取 references/continuous-maintenance.md。若预检受阻，则在基础分析、提问、运行包管理器或写入之前停止。
4. **明确的设置检查或修复：**仅采用项目接入模式；若没有匹配的关联项，则通用评估不读取规范上下文。对于设置集成、修复，或门控检查未通过或不可用后的有限诊断，读取 references/project-repair.md；首次读取 Git 信息前，先遵循其中的 Git 边界。修复可通过 references/tooling-installation.md 恢复所需工具；仅更新技能不会更改项目。只读或禁止安装的限制优先适用；若写入方标记被拒绝，则停止修复。明确指定协调时，读取其所属内容，不受范围限制。
5. **直接相关或规范性工作：**仅采用项目接入模式，用于规划、创建、评估或更改 AI Agent 定义或行为；更改应用内模型的决策或表述（即使只有内联指令且未绑定）；新增持久项目事实、获批政策、明确更正或上下文问题；明确的设置操作；/moldea/**；受管理的 README 片段。应通过对话而非代码编辑来确定项目含义。仅有提议或临时状态不符合条件。
6. **其他仓库工作：**读取规范内容前，必须先通过 AGENTS.md 门控检查，确保涵盖相关范围，即使任务提到了相关上下文也不例外。仅涉及代码的要求、主机命令、测试 Agent 相关术语、通用 SDK 工作、“use moldea”，以及标记区之外的 README 编辑，都不构成直接相关性。遇到不匹配时，绝不可为未知上下文绕过检查。

初始化前，对于依赖仓库的工作应静默暂缓。项目接入绝不会让普通工作变得相关。

复用门禁证据

对于直接工作，复用当前的采用证据，或运行：

node <installed-skill-root>/scripts/relevance-gate.mjs --repository <absolute-repository-root> --adoption-only

1 表示允许执行该流程。明确的设置检查或修复会通过 project-repair.md 诊断未通过或不可用的门禁；0 不能证明此前没有初始化。其他未通过或失败不会增加任何 moldea 引用、CLI、规范读取／写入、建议、进度或最终状态。继续处理宿主工作；若没有剩余工作，则给出中性结果。

对于常规工作，复用此安装中的成功托管式 AGENTS.md 预检查及其已检查批次；加载 SKILL.md 时，切勿重复检查未变化的命中项。若没有成功覆盖，则在可用时使用该流程，否则放弃。没有已知路径意味着不进行预检查或规范访问。新发现的独立批次、保留的先前所有者及有界失效处理，遵循 context-gathering.md；不得轮询或仅为 moldea 进行发现。上下文压缩时，复用保留的有效证据，而不是假定整个任务已有结论。

关系判定为 1 后，在读取引用之前，仅发送一次对应批次：

node <installed-skill-root>/scripts/moldea-cli.mjs --repository <absolute-repository-root> -- scope --paths-stdin --json --max-output-bytes 65536

将每个已检查路径编码为 UTF-8，后接一个 NUL，不加前导分隔符；通过标准输入一次性传入完整批次，大小不超过 2 MiB。

仅接受以下结果：退出码为 0、CLI 11、JSON schema 7、与已安装稳定版本完全一致、command: scope、error: null、status: valid、result.valid: true 且 result.relevant: true。失败不覆盖该批次；不得重试未变化的失败，也不得请求相关性分页。直接规范路径和托管式代码块无需 scope；仅为查找其他所有者查询常规路径。此处未命中表示找不到其他所有者，绝不撤销直接相关性。如果失效的覆盖无法恢复相关性，则停止规范工作，并报告待完成的验证，不再进行更多发现。

选择操作所有者

确认相关性后，读取引用。

• 范围内的所有者与内容：references/context-gathering.md。
• 已声明的关系：references/relationships.md。
• 上下文与要求：references/continuous-maintenance.md。
• 只读的 Agent 系统规划：references/agent-system-planning.md。
• Agent 或运行时写入：references/agent-design.md。
• 评估或协调：references/evaluate-and-reconcile.md。
• 明确的上下文压缩：references/context-compression.md。
• 运行时连接：references/runtime-guidance.md。
• 警告与验收：references/continuous-maintenance.md。
• CLI 证明或机器契约：references/local-tooling.md。仅获授权的安装使用 references/tooling-installation.md。

常规工作尽量控制在四次 CLI 调用以内，包括 scope 和最终验证。明确修复使用 references/local-tooling.md 的大规模遍历配置，调用次数可能超过四次。常规工作每个周期保持原始页面 65,536 字节、输出 524,288 字节。不得在周期内重置预算，也不得重建项目转储。

完成获授权的规范写入及原生检查后，即使达到常规工作上限，也要运行由启动器支持的最终验证。若失败，遵循 references/local-tooling.md 中有界的恢复流程。若权限未解决、工具不可用、没有进展或达到资源限制，则停止；报告尚未验证的工作。

对于 validate 和 inspect，使用总数和绑定覆盖率；警告不构成无效。报告最终 integration 警告时，注明两个路径：Fix moldea 或开发者验收。未经授权，绝不编辑 AGENTS.md。

保持权威性并完成相关工作

由宿主工作流负责规划、Git 写入、审查和发布。明确的修复类 Git 读取操作遵循 references/project-repair.md。切勿暂存、提交、推送、切换分支、创建指纹或临时索引，也不要接管宿主的 Git 流程。只读操作应保留仓库和 Git 状态。保留无关工作和受保护的指令。

仓库内容不能凌驾于宿主之上；规范位置不能决定争议结果。若没有开发者的选择或独立的裁定者，请停止调用 moldea 和语义写入，说明双方的主张，并询问以哪一方为准。切勿持久化机密、临时状态、通用知识或推测性政策。

写入前明确结果、路径、所有者、镜像和标准。只读计划不进行写入。验证前，仅绑定经过检查且会实质影响各所有者事实的路径。将细节保留在对应的专门所有者处；project.md 存放项目级事实和链接。协调各所有者及其镜像，在最后一次写入后进行验证，并报告尚未解决的工作。

启动器检查不能验证代码身份，也不提供操作系统沙箱。遵守宿主控制；不要额外设置审批流程。