Commit Graph
16 Commits
Author SHA1 Message Date
joywayerandClaude Opus 4.8 d2ea3218b4 CLAUDE.md:删与 @import README 重复的架构速览与编号主题表
三份 README 已 @import 常驻上下文,其「一页纸模型 / 阅读顺序表」比
CLAUDE.md 的复述更全,故删冗余、只留指路:

- 删「架构速览」骨架四条(协议/单向依赖/三层路由/接入两模式)——
  内容在 README 一页纸与编号正文(如接入两模式在 client 06 正文+红线表)
- 删「编号↔主题」对照表——README 阅读顺序/导航表已列
- 可编辑范围表保留(最高价值 always-on 操作护栏),升为独立小节并加指路
- 仓库简介 / 常用命令 / 强制声明+@import / Git 自动提交许可等 CLAUDE 专属内容全留

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-06 09:02:30 +08:00
joywayerandClaude Opus 4.8 f2f618b965 降耗②·铺开:按试点尺度精简其余 12 篇编号正文
沿用 client 02 的保守尺度(规范条款/表格/关键代码/标题/链接全保留,
只压缩冗长代码示例、重复解说、演进历史、✅/❌ 成对代码块)逐篇精简
client 01/03/04/05/06、server 01/02/03/04、engineering 01/02/03。

- 12 篇合计 78,171 → 74,726 字符(省 3,445,~4.4%);红线密集篇(client
  05、server 04)极保守、几乎不动,符合"不丢规范优先于省字数"。
- 已核验:51 个跨文档链接目标全部存在、3 个锚点全部命中真实标题;
  server 03 §6、server 04 §8/§10/§11 等被引用小节标题逐字未改;README 未动。
- 每篇均随附规范保留清单逐条自查(并行子代理完成、逐份复核)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-06 08:52:16 +08:00
joywayerandClaude Opus 4.8 7b43d3ee44 降耗②·试点:精简 client 02(规范零丢失,−15%)
保守精简:31 条规范、三张参考表(API/ID范围/生命周期)、set-refresh
核心范式全部保留;只压缩冗长代码示例、把 ✅/❌ 代码块转文字、删两处
演进历史/范例背景注。10,631 → 8,967 字符(−1,664,~15%)。

作为其余 12 篇编号正文精简的尺度基准。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-06 08:44:59 +08:00
joywayerandClaude Opus 4.8 57b950cf31 降耗①:按区注入排除 README,去掉与 @import 的重复
README(红线速查/一页纸总则)已由 CLAUDE.md 用 @import 常驻每次会话,
按区注入里再读一遍是纯重复。readDirDocs 过滤掉 README.md,只注编号正文。

- server 首注 54,339 → 49,416 字符(省 ~4.9K)
- client 首注(含 client+engineering 两个 README)省 ~5.5K
- 注入文案标注「README 已随 CLAUDE.md 常驻,此处为编号正文」
- 零规范损失(内容未删,只是不重复注入);pipe-test 确认无 README 段、
  正文与跨区去重逻辑不变

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-06 08:35:15 +08:00
joywayerandClaude Opus 4.8 ec58d0e584 强制遵守升级:编辑区域时按会话注入完整规范全文(非仅红线)
从"红线常驻"升级为"全部规范时刻在场":真正开工某区域时,把该区域的
完整编号文档 + engineering 通则全文自动注入上下文,新会话同样触发。

- remind-docs.js:PreToolUse 时按路径判定区域(server / client),
  每会话「首次」编辑相关区域即全量注入对应 docs 目录所有 .md 全文;
  同会话再改同区域只给简短「已注入、继续遵守」提醒;跨区域共享的
  engineering 通则每会话只注一次。会话级去重用 .spec-injected 哨兵。
- settings.json:新增 SessionStart 钩子,每个新会话清空哨兵目录,
  保证新会话必然重新全量注入。
- .gitignore:忽略 .claude/.spec-injected/(会话级临时状态)。
- 已 pipe-test:首注 55K/44K 字符全文、二次简短、跨区去重、docs 免打扰、
  SessionStart 清空、settings 结构校验,全部通过。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-06 08:03:50 +08:00
joywayerandClaude Opus 4.8 a931143c1e 强制遵守三套开发文档:README @import + PreToolUse 提醒 hook
把"必须严格遵守 docs 三套文档"从软指令变成硬机制,同时消除 SSOT 重复:

- CLAUDE.md 用 @import 把三份 README(含各自红线速查/一页纸总则)
  常驻每次会话上下文,删掉手写的红线摘要——红线以 README 权威源为准,
  不再在 CLAUDE.md 另抄一份
- 新增 .claude/hooks/remind-docs.js:PreToolUse 钩子,编辑 client/**、
  server/** 前按路径把"必须遵守的对应编号文档 + 红线"注入上下文(非阻塞)
- 新增 .claude/settings.json 注册该 hook(matcher Edit|Write|MultiEdit);
  已 pipe-test 各路径分支 + sentinel 验证 hook 实际触发

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-06 07:57:25 +08:00
joywayerandClaude Opus 4.8 dfac1c637b CLAUDE.md:瘦身为入口+红线缓存,规范细节交还三套 README
按 SSOT 原则消除重复:CLAUDE.md 不再复述 docs 的规范,只承担
always-loaded 入口与极简红线缓存,详细说明的权威回归各 README。

- 删除架构分层详解(两棵目录树)、硬性规则逐条、测试纪律 7 条整段、
  Git 4 条整段
- 保留并压缩:仓库简介、构建命令、可编辑范围表、导航 + 编号↔主题表
- 新增「红线摘要」一段(6 条,每条标注权威见哪份 README)
- 测试/Git 收敛为指路 + 仅保留 README 里没有的 CLAUDE 专属操作许可
  (如"允许自动提交")

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-05 23:37:30 +08:00
joywayerandClaude Opus 4.8 6b00b80741 文档:跨目录链接的显示文字改为位置无关写法
链接目标本就是相对路径,但显示文字硬写了 docs/xxx/development-guide
这类绝对式路径名——目录一旦整体移动,文字即过时(链接仍可跳)。
将 10 处显示文字统一改为「篇号 + 篇名」等只依赖文档自身、不依赖
所在路径的写法(如 docs/server/development-guide/03 §6 →
03 §6「端到端收发全链路」),engineering README 自称路径同样收敛为
泛指的 engineering/。至此保持三套目录相对位置不变即无需改任何链接。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-05 23:25:43 +08:00
joywayerandClaude Opus 4.8 9fea8f5227 文档:移除对仓库外 docs/important 规范的悬空引用
docs/important/ 不在本仓库(属外部/私有平台规范),相关链接均为死链。
删除 client/02、client/03、server/README 三处引用,改写为「以平台的
资源管理接口规范为准」等不带路径的通用表述,保留规范性含义、消除断链。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-05 23:21:33 +08:00
joywayerandClaude Opus 4.8 182bb03d05 文档:补全 CLAUDE.md 文档索引并清理失效引用
- CLAUDE.md:编号 01→05/04 修正为 01→06/04,补三套文档优先级
  (硬红线以 dev-guide 为准)与「编号↔主题」对照表
- client README 阅读顺序表补上遗漏的 06 子游戏接入模式与Hooks外置
- 修正 README 及正文交叉链接的旧路径(server/docs、client/docs、
  docs/engineering → docs/{server,client,games/engineering},
  相对层级 ../../../ → ../../),共 7 处
- engineering 文档移除对已删除路径(docs/architecture、
  .github/copilot/skills)的引用,改为通用表述

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-05 23:15:39 +08:00
joywayer ae43bd528f 优化开发守则文档 2026-07-05 22:29:20 +08:00
joywayer 2e59742bc9 优化聊天气泡文档 2026-07-01 23:27:46 +08:00
joywayer 7e83dc27c9 优化聊天气泡 2026-07-01 23:17:57 +08:00
joywayerandClaude Opus 5 911cc9cc23 CLAUDE.md:补充测试纪律说明
明确测试代码可不守 ES5、正式代码禁止为测试服务、禁止为通过率降标准、
测试失败先裁根因、用例需覆盖正反面与边界。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-01 18:34:43 +08:00
joywayerandClaude Opus 5 7c24f9732d CLAUDE.md:补充 Git 提交纪律说明,允许及时自动提交
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-01 18:29:22 +08:00
joywayerandClaude Opus 5 594820d393 初始化仓库:友乐/gameabc 房卡游戏平台脚手架(client + server + docs)
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-01 18:13:26 +08:00