Nimi Coding
Nimi Coding 是一套厂商中立、面向 AI 原生开发的方法论产品，专门用来治理高风险的 AI 辅助软件工作。它以独立 npm 包 @nimiplatform/nimi-coding 的形式分发，可以在任意代码仓库里建立项目级的 .nimi/** 真相层，把"AI 看起来已经做完了"变成"四个闭合维度都有证据可查"。
Nimi Coding 是 Nimi 平台中的一项产品，与平台其他模块共同构成 AI 开发方法论。它也可以单独采用：这个包是宿主无关的，无论你是否用平台的其他部分，都能在任意仓库里跑起来。
Nimi Coding 与平台的其他部分互为压力测试。Nimi Coding 让 Nimi 这种规模的系统可以被一个小团队借助 AI 完成；反过来，平台真实的工程量也让 Nimi Coding 的主张能够被实证检验。
为什么有这一节
绝大多数 AI 产品解决的是"编辑器里的 AI"。Nimi Coding 解决的是"任何人怎么相信 AI 做出来的东西"。答案不在于更好的提示词，也不在于更全的测试，而是方法论：明确的机制，工作开始前就声明闭合条件，工作结束后再以证据形式核验。
如果你曾经历过这样的场景：AI 改完的代码在所有可见信号下都没问题——类型检查通过、测试通过、代码评审通过——但事后发现它在权威归属、影响范围或产品语义上是错的，那这一节就是写给你的。
新手起步
第一条成功路径有意做得很短：
- 安装 npm 包到现有仓库。见 安装指南。
- 初始化
.nimi/：执行nimicoding start，再用nimicoding doctor --json确认结果。 - 重建项目权威到
.nimi/spec/**，记录来源依据和未解决的缺口，而不是凭空写一套漂亮的规则。 - 创建 topic，对应第一个高风险或权威性变更。
- 拆分 wave，让每个 wave 只负责一个所有权域、一个闭合目标。
- 冻结 packet：开工前固定允许的读、允许的写、验收恒定式、负面测试、停止线、重开条件。
- 由准入的 AI 宿主执行或交接，并记录强类型证据。
- 关闭 wave 时四个维度都要满足：权威、语义、消费方、抗漂移。
这条路径就是产品的缩影：AI 的工作变成可持续、有边界、可审计的项目状态，而不是一段当时看着挺像样的对话。
本节目录
范式
- The Paradigm —— AI 编码治理新增了什么、为什么是范式而不是检查清单。
- 四个闭合维度 —— 权威、语义、消费方、抗漂移四种闭合作为思考框架。
- 伪闭合形态 —— 方法论要识别的命名失败形态。
- 禁用反模式 —— 显式拒绝的反模式清单。
角色与权威收敛
生命周期
- Topic 生命周期 —— proposal、ongoing、pending、closed；wave 的细粒度状态；true close。
- 白皮书 —— 把 AI 辅助实现视为权威性工作的概念论证。
- Topic 工作流 —— topic / wave / packet / 预检 / 审计 / 关闭的实际流程。
- 流程演示 —— 一个端到端的合成示例。
包
- The Package ——
@nimiplatform/nimi-coding包含什么、不包含什么。 - 宿主无关边界 —— 为什么换 AI 宿主不会改变方法论。
- 技能 —— 四个声明的技能：
spec_reconstruction、doc_spec_audit、audit_sweep、high_risk_execution。 - CLI Surface —— 命令面板的概念层概览。
- 安装 —— 当前安装姿态。
对比与采纳
实践分支
- 教程 —— 学习导向的分步课程，覆盖从安装到
.nimi/spec/**、topic 执行、sweep 审计、sweep 设计、长任务宿主工作的完整路径。 - 操作指南 —— 按问题形态组织的操作配方。
- 参考 —— Schema 级数据字典。
附录
- oh-my-codex 适配器 —— 已准入的外部宿主适配层。