jue-preset-internal

Imported from zenHeart/ai-jue (packages/jue-preset-internal/AGENTS.md). Install upstream with npx skills add zenHeart/ai-jue --skill jue-preset-internal. Copyright stays with the author.

ai-jue Internal Governance

本文件定义 ai-jue 仓库内部协作约束，用于 jue-preset-internal 自举场景。

1. 目标

• 保障仓库持续迭代时的语义一致性（README/docs/spec/实现一致）。
• 保障变更质量（可验证、可回滚、可审查）。
• 保障最小知识原则（不引入额外用户概念）。

2. 执行原则

1. 先文档后实现：先修正文档语义，再改代码。
2. 架构优先：复杂变更先给设计边界与验证策略。
3. 小步提交：每次变更保持最小范围，确保可独立验证。
4. 向后兼容：默认保持兼容；破坏性变更必须显式标注。
5. 失败显式化：不允许静默降级或吞错。

3. 仓库治理检查清单

• 是否对齐当前 TODO.md 优先级与范围边界。
• 是否对齐 _drafts/ai-jue.md 的能力映射原则。
• 是否对齐 README.md 与 packages/docs 的规范叙述。
• 是否补齐相应测试/脚本验证与回归说明。

4. 预设边界

• jue-preset-base：提供通用用户场景能力。
• jue-preset-internal：仅提供本仓治理、自举与扩展开发约束。
• internal 不承载通用业务命令，不替代 base。

5. 适配与资产约定

• 规范目录：AGENTS.md、commands/、rules/、hooks/、tools/（按需启用）。
• commands 元数据统一写入 prompt.md YAML frontmatter。
• 不使用历史冗余概念与中间字段。

6. 架构语义门禁

1. 稳定概念只允许 Capability、Preset、Canonical DSL、Extension、 Adapter、Artifact；新增概念必须先由 RFC 证明不可合并。
2. Canonical DSL 是唯一中间层；Extension 是唯一可执行扩展机制；Adapter 是 单个 Agent 的完整正反转换单元；Plugin、Bundle 和配置统一视为 Artifact。
3. 优先复用 npm、Node.js 和 Agent 原生机制，不创建独立 Extension manifest 或 重复 inventory。
4. 核心 CLI 只允许 init、apply、inspect；内部阶段使用选项或 Adapter 方法表达，不扩张用户命令面。
5. 任何 README、Guide、Architecture、Reference、Spec、Developer 或实现变更都 必须通过旧术语、旧命令和中英文一致性扫描。
6. 稳定文档只写当前模型的正向合同。不得用否定句继续介绍已删除或未采用的 概念、命令和抽象；取舍历史仅进入 RFC。
7. 如果删除一句“系统没有什么”的文字不影响用户操作或实现者完成合同，该句必须 删除。
8. 变化放大门禁：公共能力的基线和缺省只允许由 Core 在一处定义，Extension 默认导出是 Adapter 方法与能力元数据的唯一事实源。若新增一个能力值要求所有 Adapter 重复添加相同声明，必须先把共同语义收敛到宿主缺省；CLI 只调用校验后 的 Adapter 对象，不得从包顶层导出重建并行插件合同。