# ai-platform

**Repository Path**: domky/ai-platform

## Basic Information

- **Project Name**: ai-platform
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-platform — 工程方法论仓库

一套**活的、有版本号的工程方法论**(当前 `standardVersion` 见 [`spec/state.json`](spec/state.json),当前为 <!-- gen:readme-badge -->**v1.32.0**<!-- /gen -->)。它回答的唯一问题是:**如何更好地开发一个项目**。

## 体系三层定位(正式版见 [`spec/current/POSITIONING.md`](spec/current/POSITIONING.md))

```
┌─────────────┐   ┌──────────────────────────┐          ┌──────────────┐
│  LLM 模型    │   │ 工程方法论(有版本号)        │  指导完成 │  干活做项目     │
│  Harness 等  │──▶│ 产出:文档(方针/问题处理/     │─────────▶│ 项目 / 工程演练 │
│             │   │ 状态管理)+ 脚本/技能包(校验/生成)│◀────────│              │
└─────────────┘   └──────────────────────────┘  指导进化  └──────────────┘
```

- 方法论**产出三形态(D25)**:文档(准则/协议/自检清单/档案)+ 脚本(`tools/`,登记于 [`tools/README.md`](tools/README.md))+ 技能包(`skills/`,可被 AI 智能体直接消费的规范,登记于 [`skills/README.md`](skills/README.md))。
- 项目与**工程演练**(`exercises/`,D26)受方法论指导;实践复盘产生信号,按 **D27 信号处置分级** 落位(进准则/进技能包/仅记录/丢弃),并以 **D29 信号台账** 跨轮持久追踪,反哺方法论进化。
- **演练受登记与生命周期治理(D34)**:每个演练登记于 [`exercises/README.md`](exercises/README.md),状态为 `进行中`/`已收官`/`已退役`;收官须"信号已入台账 + 经验已提炼",退役须有落点——演练区不再只增不减。
- 核心定位是稳定锚(M7):对定位的实质变更须经使用者显式裁决;入口文档声明与实际偏离即漂移(selfcheck 自动校验)。
- 准则声明的落地物须**同轮落盘、且由规则自身自描述**(D33 / D23):落地物清单承载于规则文件自己的 frontmatter(`artifacts`),`selfcheck` **从规则文件派生**核验,声明了归档/台账的条款一旦缺件即告警——**加一条带落地物的准则只改规则源、不改核验工具代码**(守 P1 单一事实源 / D17 演进友好)。
- 条款之间的引用须**双向可查且可核验**(D35):正向索引 [`spec/methodology/INDEX.md`](spec/methodology/INDEX.md) 回答"有哪些条款",反向索引 [`spec/methodology/REFS.md`](spec/methodology/REFS.md) 回答"这条被谁引用";改条款前先查影响面,引用未落位条款须带前瞻标记("拟")。
- 审计/度量结论须**自带口径与时点**(D36):凡引用计数、登记率、断链数、样本量这类数字,都须声明**口径 / 观测时点 / 可复现手段 / 观测效应**,并登记进 [`spec/current/AUDIT-PROTOCOL.md`](spec/current/AUDIT-PROTOCOL.md) 的口径登记表——数字不再可以脱离口径被当作"事实"引用(见 E-21 观测效应)。
- **总量可控、不膨胀**(D37):[`spec/current/RULE-LIFECYCLE.md`](spec/current/RULE-LIFECYCLE.md) 承载**准则总量预算(软上限)+ 退役 / 合并台账**——准则总量不再单调递增;退役 / 合并须经裁决留痕、**编号不复用**,由 `selfcheck §8k` 核验。
- **体系是否健康、趋势往哪走,要能判定**(D40):[`spec/current/HEALTH-METRICS.md`](spec/current/HEALTH-METRICS.md) 承载**指标阈值 + 触发动作 + 趋势台账**——凡纳入度量的指标须有**阈值**(含比较方向与**依据**,禁止凭感觉设定)、**触发动作**(越线后必须做什么,"触线"不是"建议")、**趋势留存**(值与观测时点**成对追加**,禁止覆盖);判定分 **触线 / 警示 / 正常 / 观察**。**阈值由落地物自描述、由 `audit.js` 派生,禁止硬编码在工具代码里**(守 P1);阈值是**判定基准而非可调旋钮**,为消除告警而下调视同违规;复现:`audit.js` 检查 I + `selfcheck §8p`。
- **先归因、再谈处置**(D27):[`spec/current/TRIAGE.md`](spec/current/TRIAGE.md) 承载**归因分流规范与台账**——任何"待改进项"(信号 / 候选 / 使用者主张 / 收尾时的发现 / 智能体自提议)在**进入进化流程之前**须先判**因果**:属"方法本身"(内因)才进流程;属"外部原因"(工具 / 宿主 / 环境 / 数据 / 操作,外因)则**不处理**(不改准则、不占轮次、不升版本,只归档 + 给操作建议);判定登记进台账,由 `selfcheck §8l` 核验。
- **上手要能直接用**(D42):[`spec/current/METHODOLOGY-GUIDE.md`](spec/current/METHODOLOGY-GUIDE.md) 答"**有什么能力**";[`spec/guides/`](spec/guides/README.md) 答"**遇到问题怎么做**"——一份**场景索引**("遇到什么问题 → 看哪一篇")+ 每篇含 **适用场景 / 可执行流程 / 案例**;索引与指南须双向一致、入口链接须可达,由 `selfcheck §8m/§8n` 核验。

## 目录

- `spec/` —— **活的工程方法论**。`spec/current/` 为准则文档(含 `POSITIONING.md` 定位宪章、`SIGNALS-BACKLOG.md` 信号台账、`RETROSPECTIVE.md` 跨轮复盘归档、`AUDIT-PROTOCOL.md` 审计口径规范、`RULE-LIFECYCLE.md` 准则生命周期台账、`TRIAGE.md` 归因分流规范与台账、**`HEALTH-METRICS.md` 健康度量与阈值台账**、**`MIGRATION.md` 跨仓库迁移清单**、**`CRITERIA-VERDICT.md` 判据验收台账**、`METHODOLOGY-GUIDE.md` 使用指南总入口、**`REPOSITORY-STRUCTURE.md` 仓库结构与文档治理台账(D47)**);`spec/guides/` 为**使用指南库**(场景索引 + 9 篇场景指南);`spec/methodology/` 为规则逐条管理(**M1–M7 / P1–P10 / D1–D47**,单文件+版本号+INDEX 正向索引+REFS 反向引用索引,D23/D35);`spec/state.json` 当前进化进度(P4);`spec/versions.json` 版本史;`spec/rounds/round-N/` 每轮进化档案(signals/proposal/plan/report)。
- `spec/EVOLUTION-ROADMAP.md` —— **进化计划看板 10-10-10-20**（北极星 / 上一批已落位 10 / 本轮进行中 10 / 下一轮计划 10 / 储备 20（10 短期 + 10 长期）；注意它在 `spec/` 根下，不在 `spec/current/`）。
- `exercises/` —— **工程演练载体**(D26):小型、可抛弃的演练,专职制造实战信号;不占 `projectVersion`,演练后信号落轮次档案。**演练登记台账见 [`exercises/README.md`](exercises/README.md)(D34)**。
- `skills/` —— **方法论技能包**(D25):可被 AI 智能体直接消费的规范,登记于 [`skills/README.md`](skills/README.md);现有 `methodology-evolution-closeout`(进化收尾)与 `methodology-audit-selection`(审计驱动选题)。
- `tools/` —— 方法论脚本(`selfcheck.js` / `status.js` / `gen-methodology.js` / `audit.js` / `export-methodology.js` / `scaffold.js` / `overlap.js` / `hooks/pre-commit`),登记于 [`tools/README.md`](tools/README.md)(D25)。
- **旧的自进化体系**（含归档的行为规范 v1.00–v1.06）：**本仓库当前不含该目录** —— 历史入口曾声明仓库根的 `archive/`，R35-2 实测该目录**既不在工作区、也无 git 履历**（`selfcheck §8n` 已补「结构声明项」守护，防同类假声明再发）；如需追溯该体系，另见外部存档。

## 常用命令

```bash
node tools/status.js     # 查看当前进化进度(只读,P4)
node tools/selfcheck.js  # 校验四方自洽 + 定位防漂移 + 产物/演练登记 + 信号台账 + 条款→落地物核验(从规则 frontmatter 派生)+ 引用核验 + 审计口径核验 + 指南存在性 + 准则总量/生命周期核验 + 归因分流核验 + 场景化指南库核验 + 入口文档链接可达 + 规则元数据自描述核验 + 健康度量与趋势留存核验 + 复杂度预算数值一致性 + 判据验收/迁移真机/技能包真机/语义版本守护(§8r)+ 篇幅纪律核验(§8s,含轮次档案篇幅 §8s(d))+ 统一裁决台账(§8t)+ 自检段登记表双向一致(§8u)+ 储备池结构自洽(§8v)(只读,D15/M7/D25/D29/D33/D34/D35/D36/D42/D37/D27/D23/D40/D7/D45/D44/D41/D46/D19/D3)
node tools/selfcheck.js --quick  # **快检层**:仅核心阻断校验(5 段),供提交钩子等高频场景使用;默认(不带参数)与 --full 等价,跑完整 34 段
node tools/scaffold.js round 28 / exercise <名称>  # 轮次 / 演练骨架脚手架(D24/D26/D34;生成物须随即登记,见 tools/README.md)
node tools/overlap.js    # 准则重叠识别辅助(中文 bigram 相似度,**只提示不判定**;是否退役 / 合并仍须按 D37 §2 裁决)
node tools/gen-methodology.js  # 重建规则文件 + 正向索引 INDEX.md + 反向引用索引 REFS.md(派生自事实源,D23/D35)
node tools/export-methodology.js <目标目录>  # 导出方法论最小可用集合到指定位置(跨仓库迁移自举,D44;对源仓库只读)
node tools/audit.js      # 只读审计报告:准则总量 / 引用健康与密度 / 三区登记率 / 审计口径覆盖率 / 指标现测值 / 指南可操作性与入口链接健康 / 条款元数据自描述率 / 健康度量与阈值判定(阈值从落地物派生,自带口径与观测时点声明,D36/D40)
```

## 当前状态

- 活方法论 <!-- gen:readme-status-badge -->**v1.32.0**(tag `methodology-v1.32.0`)<!-- /gen -->:**接班目标判据化 + 文档规范自查 + 项目侧治理轮**(R36)——把接班目标「**外部有效性**」判据化为 **`G8`**(补 D45 四要素 + 立**非执行者证据源分档认定协议** + 可执行守护 `§8ay`);**修订 D46 / D47** 两条:**篇幅治理由「限行数」改为「压履历」**(补「**记录字段**」位置判据 / **有效窗口** / **一行索引**,并**废除单文件行数上限**),**文档治理由「本仓库」扩到「被服务项目」**(项目侧总量软上限 **20** + 必需件 `docs/README.md` + 守护 `§8ax(g)`);规则 `type` 字段 **0/60 → 60/60**、**I-7 复归达标(35/35)**。**零新增准则编号**,活跃 **60 条 / 余量 0**。案例基座 `exercise-doc-spec-audit`(外部小项目 + 可移植审计器)在**立案前**真跑,检验规范的**核验侧**搬出本仓库后是否成立。依 **D41** 判 **MINOR**。
- **预算口径(现行,仍适用)**:`D7` = 单轮 **5–10 个主题任务、上界 10、默认取 10**;低于 5 仅限**收尾轮 / 候选确实不足 / 待裁决项阻塞**,且须在当轮 `proposal.md` **写明正当理由**;**无理由少装同样是越界**(violation 判「**> 10**」或「**无正当理由低于 5**」);批内须满足**三条独立性**(独立可验收 / 独立可回退 / 不稀释裁决)、跨域须显式化。**看板容量 `10-10-10-20`** 与之对齐。
- **判据现状**:⇒ **北极星 `G1–G7` 七条判据仍全部认定为 ⬤**——认定于 **R24**(认定人 = **使用者 · 2026-09-19**,**授权代书**;执行者无权自认,D45 §2 纪律 2),此后各轮均未改认定;宣称须连**证据与观测时点**一起引用(D36 / D45)。**接班判据 `G8`（外部有效性）已判据化（R36-A）但状态 = ○ 未认定**——首份证据属**半独立**（同宿主同模型、零方法论上下文），只支撑「机制与协议就位」,**不足以**认定（分档规则见 `CRITERIA-VERDICT.md` §2.7）。
- **远端同步**:守用户明示「git 只需要本地提交」——`methodology-v*` 标签与领先提交**仅本地生成、不推送远端**(D19「未登记的事项不得引用为已批准」);远端 `master` 仍为 `e004f2c`。
- 无活动项目(`projectVersion` 为空);演练载体 `exercises/` 已登记 **18 个**演练(**15 个已收官 + 3 个进行中**——`exercise-project-docs-bootstrap`(R35 立案前真跑)与 `exercise-doc-spec-audit` / `exercise-external-validity`(R36)均为**案例基座**,随各自轮次收尾转发为已收官),**全部已登记且不长期悬置**。
- 本体系自身的演进史见 `spec/versions.json` 与各轮档案 `spec/rounds/round-*/`；**旧体系归档不在本仓库**（见上条）。
- **上手 / 接手**：想"**遇到问题该怎么做**"→ 直接看 [指南库场景索引](spec/guides/README.md)；想知道"**有什么能力、现在做到哪**"→ 看 [`spec/current/METHODOLOGY-GUIDE.md`](spec/current/METHODOLOGY-GUIDE.md) 与 [`state.json`](spec/state.json)。