Axıs
随笔
技能目录

Axiom 变更日志

Axiom 变更日志

记录对象：Axiom 丛书（apps/skills/axiom/axiom.md）的版本——第零部至第四部的增删改与动机。CLI 版本在同一条目内以「/ CLI x.y.z」附注。

版本记录对齐第二部第四十条（版本号、日期、原因、增删、影响、测试）。

1.19 — 2026-09-26

  • 原因：修复遗留的单一真相源违规与载体歧义——① axiom.md 文末「修订记录」与本文件记录同一批修订，属同一语义两处维护（第零部三节「单一真相源」禁止维护副本）；② 本文件原在 cli/ 下且标题含混，会被误读为「CLI 的变更日志」，而它记录的其实是丛书版本。实际演进统一入本文件，核心文件只留正文与版本头
  • 增加：卷末新增「附录：axiom.md『修订记录』迁入（2026-09-26）」，收纳两次当时未编号的历史修订（2026-08-22、2026-08-24）；文件头改为「Axiom 变更日志」并显式声明记录对象是丛书版本、CLI 版本作附注
  • 删除：① axiom.md 文末「修订记录」整节——内容未销毁，已编号的 2026-08-31 与 2026-09-26 两次并入 1.16 / 1.17 / 1.18 条目，未编号的两次移入卷末附录，历史仍可经 git 追溯；② 文件自 apps/skills/axiom/cli/CHANGELOG.md 迁至 apps/skills/axiom/CHANGELOG.md（与 axiom.md 同级）
  • 影响：修订记录只有一处权威，且落在与记录对象同级的位置；axiom.md 回到「正文 + 版本头」，不再需要与本文件对账；1.17、1.18 条目中原先指向 axiom.md 的「详见」引用改为自包含表述，不留悬空指针；站点 /skills/axiom 会多出一个变更日志文档页（apps/web/src/lib/skills/discover.ts 的 scanDocs 取技能目录顶层的全部 *.md，仅排除 README.md）——若不打算公开，在该函数加一行排除 CHANGELOG.md 即可
  • 测试：axiom.md 已无「修订记录」标题、卷末止于「丛书附则」（全文 2899 行）；本文件版本序列 1.19 → 1.18 → 1.17 → 1.16 连续；已读 cli.py、paths.py、apps/web/vite-skills.mjs 确认无代码读取本文件路径，且 vite-skills.mjs 只遍历 apps/skills/* 目录层级、不受本文件位置影响。注：本次修订的执行环境 shell 与 ripgrep 不可用（spawn bash ENOENT），axiom skill sync / skill status / 站点 pnpm check 未能实跑；SKILL.md 的 metadata.version 按 render_skill() 规则手工对齐为 1.19；旧路径 cli/CHANGELOG.md 因无 shell 无法删除，暂留为指针文件——请在可用环境执行 rm apps/skills/axiom/cli/CHANGELOG.md，然后复跑 ./axiom skill sync && ./axiom skill status 确认 fresh

1.18 — 2026-09-26

  • 原因：AIP–Clearance 第二批沉淀，与 1.17 独立成批（第零部「变更的原子性」：一批只改一个维度）——阈值横评只调判断与门控、不写业务状态；温度拟合把 T=1.0 恒列为候选，样本不足或单边退回出厂值，合成样本只验链路、不入拟合表。抽象时剥离了具体指标、算法与存储实现，只保留「用数据调参数时如何不把事情变坏」这一可迁移逻辑
  • 增加：第四部第四十章「评测与拟合的纪律」，含两条原则：①评测必须无副作用——只调纯判断函数与门控函数、真实产物写临时沙箱、输入用冻结样本集、脏数据单独登记、结论可复算（样本数与每档通过/失败/错误计数）；②拟合的候选集必须包含出厂值且只吃与部署分布一致的数据——出厂值恒为候选、平局保留出厂值、单边样本不产出拟合值、拟合集只吃真实分布数据、报告拟合前后指标与有效样本数、只改参数不改结构
  • 删除：无。新增前核对覆盖关系：第三部 11.1（反馈闭环的确定性）、第四部十一.3（核心路径的自动化验证）、十四.5（预防复发的结构性防线）属相邻内容，均不含「评测自身的副作用」与「拟合的单调不劣化」；本批未使任何既有条目失效
  • 影响：凡含「用数据调参数」环节的系统（阈值、温度、权重、排序系数）有了可迁移的评测与拟合纪律；不绑定具体指标、算法与存储实现
  • 测试：axiom skill sync 重新生成 SKILL.md（metadata.version: 1.18，源哈希 38d2f86ff7e1 未变——第一部未改动）；axiom skill status axiom 条目 fresh；grep 校验第四部编号连续（三十九 → 四十 → 丛书附则 → 修订记录）无重号

1.17 — 2026-09-26

  • 原因：AIP–Clearance 审核网关产品化中沉淀——引擎插槽只产出提议、网关注册表与置信门控决定生效、人工兜底承接不确定；同时暴露「纯关键词兜底无命中即自动放行」与「自动放错必须为零」的目标冲突。抽象时剥离了具体动作名、阈值与存储实现，只保留「自动判断如何合法地变成有后果的执行」这一可迁移逻辑
  • 增加：第四部第三十九章「自动判断的生效纪律」，含三条原则：①判断与执行分权——产出方只能提议，生效权归不参与产出的网关；生效方只读动作名与数值置信度、动作名只在注册表枚举、风险等级只声明一处、最危险等级不注册、校验顺序固定；②低置信一律转人工，代价排序编码进选择函数（三态而非两态、评测工具无副作用、转人工率是成本指标）；③降级不得放宽执行边界——兜底来源的放行置信度必须低于自动阈值，结论自述来源与不确定度
  • 删除：无。修订前先核对覆盖关系：降级显性化（三十一）、依赖方向（三十三）、最小权限（第三部 8.3）已覆盖其中一部分，重复处改为引用而非新建
  • 影响：凡「自动判断产生有后果的动作」的系统（内容审核、批处理、Agent 工具调用）有了可迁移的生效纪律；不绑定具体动作名、阈值与存储实现
  • 测试：axiom skill sync 重新生成 SKILL.md（metadata.version: 1.17，源哈希 38d2f86ff7e1 未变——第一部未改动）；axiom skill status axiom 条目 fresh；grep 校验第四部编号连续（…三十八 → 三十九）无重号

1.16 — 2026-09-03

  • 原因：MDShot 项目从构思到构建的全链路抽象沉淀；随后按第零部「抽象层次的收敛方向」将初稿中的 Vite / Shiki / 768px 等具体实现剥离，改写为可迁移表述（两次提交 02702ee → 9ba562e）
  • 增加：第四部第三十六~三十八章（粘贴优先与单卡所见即所得 / 语义分页与按节滚动 / 离屏可见与单次落盘）
  • 删除：无（绑定具体实现的表述在同批内被重写，未对外发布过具体实现版本）
  • 影响：第四部部内章节号至三十八；剪贴板粘贴、长文档分页浏览、截图离屏三类场景有了抽象依据
  • 测试：axiom skill sync 生成 SKILL.md；第四部编号连续。注：该版本发布时未按本文件体例补记，2026-09-26 依据提交历史回填——回填内容以提交信息与实际 diff 为准

1.15 / CLI 1.6.0 — 2026-08-23

  • 原因：集百家之长（anthropics/skills · obra/superpowers · mattpocock/skills · agentskills.io 调研）——农场自动发现多 skill，元技能自我维护，spec 合规校验
  • 增加：skill install/status/uninstall 自动扫描 apps/skills/*/SKILL.md 全量挂载；sync 注入 frontmatter metadata.version；新建 writing-skills 元技能（写作法则引用第零部五节 + invocation 经济学 + 上架清单）；落地页版本徽章；构建校验 name=目录名等规范硬约束
  • 删除：无
  • 影响：新增 skill 零注册成本（建目录 + install 即三 agent 可用）；SKILL.md 机器可读版本号
  • 测试：install 挂载 2 skill × 3 = 6 链接全 OK；build 日志 injected 2 skill(s)；check 0 错误

1.14 / CLI 1.5.1 — 2026-08-23

  • 原因：建立 apps/skills 统一技能区；Axiom 作为首个 skill 迁入，站点新增 /skills 菜单自动注入
  • 增加：apps/skills/<name>/SKILL.md 即上架约定；apps/web/src/lib/skills/（discover/page）+ vite-skills.mjs 校验插件；DocSidebar 支持 link 字段
  • 删除：apps/docs/ai/axiom/（内容迁出）、apps/axiom/（CLI 迁出合并为 cli/ 子目录）；旧导读页 other/Axiom.md；旧 URL 不做重定向
  • 影响：真相源变为 apps/skills/axiom/axiom.md；symlink 农场重建指向新路径；站点浏览入口从 /docs/ai/axiom/* 变为 /skills/axiom*
  • 测试：./axiom -v、skill sync/install/status 全绿；pnpm check && pnpm build 通过且日志输出 injected skills

1.13 / CLI 1.5.0 — 2026-08-13

  • 原因：确立「一源三读」分发体系——axiom.md 为唯一真相源，SKILL.md 为机器扉页（生成物），symlink 农场分发到各 agent；同时完成全书结构整理（方案A）
  • 增加（文档）：
    • SKILL.md（axiom skill sync 生成）：frontmatter + 第一部全文 + 分层加载协议（工程读第三四部、修订读第零二部）
    • 第三部新增第十七章「框架与平台契约」（原十八章移入）
    • 第四部部内重编号一三十（原十七四十七）
    • 丛书附则移至全书卷末
  • 增加（CLI）：axiom core（复制第一部）、axiom skill sync|install|status|uninstall
  • 删除：无
  • 影响：用户不再逐 repo 复制 axiom.md；opencode / Cindy / Claude Code / Codex 通过 skill 挂载自动发现；修订后需 axiom skill sync 刷新投影
  • 测试：./axiom -v（1.5.0）、skill sync 生成 SKILL.md、skill install 三挂载 OK、skill status 全绿；grep 验证第四部一~三十连续、无旧号残留

1.7 — 2026-07-29

  • 原因：从实际项目（SillFlow / XHS 自动化内容系统）的构建与调试中，提炼 Shell 脚本编排、AI Agent 集成与跨层一致性方面的抽象原则
  • 增加：第四部第三十章「Shell 脚本中的多层集成与 AI Agent 编排」，含四条原则：
    • 管道阶段的跨层一致性（多文件同步更新约束）
    • AI Agent 输出的结构化解析（JSON 流式输出解析）
    • Shell 脚本中的配置驱动行为（内嵌 Python 读取 JSON 配置）
    • 文件排序中的元数据优先（mtime 替代字典序排序）
  • 删除：无
  • 影响：面向 Shell + Python + Agent 编排场景的工程判断依据
  • 测试：原则来源可追溯至 SillFlow 项目的实际构建会话

1.4.0 — 2026-07-26

  • 原因：移除三部曲拆分，简化维护；增加角色功能
  • 增加：axiom role 子命令（列出/复制角色文件）；axioms TUI r 键角色选择器
  • 删除：axiom sync、axiom 1/2/3；part-*.md / overview.md 拆分文件
  • 影响：axiom 始终直接读 axiom.md；角色文件为 ai/axiom/ 下除 axiom.md 外的 .md 文件
  • 测试：./axiom -v、./axiom、./axiom role、./axiom role zuan 冒烟通过

1.1 — 2026-07-10

  • 原因：迁入 Axis（emNav）前的稳定版；三部结构已成型
  • 增加：第一部执行提示词、第二部协作章程、第三部技术实现宪章；总序七层秩序
  • 删除：无
  • 影响：可作日常系统提示词与工程纪律依据
  • 测试：未在 Axis 内跑固定测试题（见第七编第四十一条）；迁入后由 AGENTS.md Revise 流程维护

1.0 — （历史）

  • 初始 CLI + 丛书骨架（独立仓库 emVisible/Axiom）

1.3.1 — 2026-07-13

  • 删除：ref / copy link（TUI 与 CLI）
  • 优化：axioms 去掉二级菜单；⏎ 直接复制；0 跳转 Axiom；补充 docs/collaboration-system.md
  • 文档：重写 AGENTS、README、CLI README、Wiki synthesis

1.3.0 — 2026-07-13

  • 原因：路径式子命令难用，需要交互式文档浏览器
  • 增加：axioms TUI（Axis 暗色紫灰主题）；./install 同时安装 axiom + axioms
  • 影响：日常用 axioms 浏览；axiom 专注复制丛书
  • 测试：非 TTY 优雅降级；entries 列表；axiom -h/-v

1.2.0 — 2026-07-13

  • 原因：深度融入 Axis 文档库，扩展 Self Doc CLI
  • 增加：正文迁至 apps/docs/ai/axiom/；CLI 迁至 apps/axiom/；ls/cat/copy/find/ref/edit/path/root
  • 删除：仓库根目录旧 axiom/ 内容包（改为根启动器脚本）
  • 影响：安装入口为根目录 ./install；默认 axiom 仍复制全书
  • 测试：./axiom -v、ls、path、find、cat、ref、root 冒烟通过

附录：axiom.md「修订记录」迁入（2026-09-26）

2026-09-26（1.19）整节迁出 axiom.md。以下两次修订当时未分配版本号，故按日期保留原文、不追认版本号；2026-08-31 与 2026-09-26 的修订原本已有版本条目（1.16 / 1.17 / 1.18），不在附录重复。

2026-08-22

  • 原因：常驻应用排障与单引擎化迁移两次实战会话的模式沉淀
  • 增加：第三部 7.6（引擎选型先核实硬件路径）、11.2（测试的平台无关性）、17.4（第三方依赖能力与标识符查证）；第四部一.4 追加「数值越界回退默认而非钳位」；第四部二新增 2.4（卸载清理的对象分类与重装资产保全）；第四部九「闭包中的时间绑定」泛化为「异步结果的引用时点绑定」并补充跨线程派发案例；第四部十五「常驻应用的单实例基线」补充进程匹配锚点与严格模式空结果两条抽象逻辑
  • 删除 / 影响 / 测试：当时未记录。按第零部「声明与承诺的对等」，此处不追补——留白优于事后编织

2026-08-24

  • 原因：Hertz 项目 v0.22.x 大规模解体与能力预检实施中沉淀的通用工程原则
  • 增加：第四部第三十一~三十五章（静默降级显性化 / 结构手术确定性 / infra 依赖方向纪律 / 核心能力依赖晋升 / 共享测试全量文件隔离）
  • 动机细目：翻译引擎静默产出英文字幕、行号切片产出悬空头、deps.py 反向导入 pipeline、sentencepiece 可选组被 uv run 摘除、conftest 未隔离 log_dir
  • 删除 / 影响 / 测试：当时未记录（同上）