# 永生 · 项目纪要（campskill 分发）

- 项目目标：campskill 提示词套件的分发架构 + 全局规则迭代
- 约束：现场分次发放（5命令分5次），①直下md，②③④⑤各独立包

## 当前状态
- ✅ 已完成：
  - 分发架构从「1大包 campskill.tar.gz」改造为「1md直下 + 3独立skill包」（2026-06-27）
  - 文档驱动规则升级为独立顶级章节 §2（2026-06-28）
  - §1 项目纪要新增「决策记录铁律」子节（2026-06-28）
  - 新增第④个 master：git-master（一键标准化项目协作，横切于 prd/design/tdd 链路）（2026-06-28）
- ▶️ 进行中：无
- ⏸️ 待办：无
- ❓ 待确认：新规则是否立即发布到线上（需跑 build-release.sh，属 deploy 待用户许可）
- 线上产物URL（/skill/ = campskill仓库根）：
  - rules.md / prd-master.tar.gz / design-master.tar.gz / tdd-master.tar.gz / git-master.tar.gz

## 决策记录（实时追加，宁滥勿缺）
- [06-27-2026] 全局规则分发方式｜背景：现场分次发放体验，rules.md 是单文件无需打包｜结论：采用 curl 直下 rules.md 单文件（业界标准）｜来源：用户（历史重构，来源推测，原纪要未留存时分秒与上下文）
- [06-27-2026] 三大 skill 包分发方式｜背景：配合现场分次发放，各 skill 独立安装｜结论：prd/design/tdd-master 各打独立 tar.gz 包｜来源：用户（历史重构，来源推测）
- [06-27-2026] 旧大包废弃｜背景：原 campskill.tar.gz 大包被「1md直下+3独立包」新架构取代｜结论：直接废弃删除旧大包｜来源：用户认可（历史重构，来源推测）
- [06-28-2026] P1 纪要公网泄露修复｜背景：纪要通过 /skill/doc/ 公网可访问，存在信息泄露｜结论：nginx 加 `location ^~ /skill/doc/ { return 404; }` 挡住，备份在 /root/nginx-backup/｜来源：AI 发现 + 用户认可
- [06-28-2026 11:29:20] 文档驱动规则升级为独立顶级章节｜背景：原「文档驱动」埋在 §5 核心原则第13条，被前12条稀释，AI 在新会话里不遵守——改 HTML 不回写 MD、改 PRD 不下推到设计/页面/测试｜结论：规则13抽出升级为 §2「文档驱动（最高优先级·每次工作必执行）」，加入身份「文档守护者」+ 强约束词（必须/禁止/强制）+ 每次工作绑定 + 收工自检 + 汇报必含文档同步项；原 §2-§12 顺延为 §3-§13，修正3处交叉引用（安全边界§8→§9、权威顺序§2→§3、工作循环§5.13→§2）｜来源：用户拍板（用户提出"单独列章节+必须禁止强制+你是文档守护者"方案，AI 执行）
- [06-28-2026 11:29:20] 决策记录铁律改造｜背景：项目纪要决策太少（10轮对话只记3-4条没用的），时间格式不对（缺时分秒、带"北京时间"字样），决策门槛太高（用"关键决策"AI 自行筛选导致漏记），不是实时记而是攒着最后批量记｜结论：§1 新增「决策记录铁律」子节——①重新定义决策（降门槛+列举5类触发：用户答问/用户提需求/方案被认可/AI技术判断/拍板）；②实时强制（当回合内立即记，禁止攒）；③时间用 `date '+%m-%d-%Y %H:%M:%S'` 取本地时间，禁止写"北京时间"；④内容必须含背景+结论+来源；⑤宁滥勿缺导向｜来源：用户（用户详述需求含时间格式/决策定义/实时强制，AI 出方案用户确认"对"）
- [06-28-2026 14:07:52] 根 claude.md 安装说明规格化改造｜背景：原安装说明（根 claude.md 第2步）是一段写死的纯 bash heredoc（mktemp/tail/set -e/~），导致两个问题：①Windows 只有 PowerShell/cmd 时整段跑不起来（无 bash 工具链）；②把"怎么装"这种 agent 本就会、且本就知道自己平台的机械活写死，反而绑住了 agent 的跨平台能力。讨论结论：agent 本来就会"下载→改首行→备份→写入→删目录"且知道自己平台，HOW 属过度设计；但有一个 agent 推不出/会搞错的不可砍核心——载荷保真（若只说"装规则"，agent 可能用 WebFetch 取到被摘要/改写的内容，装进假规则）｜结论：把根 claude.md 第2步从"死 bash 脚本"改为"规格说明书"——只钉死 4 类产品契约（①取原始字节禁摘要禁润色 ②首行 `__NAME__`→`当前操作者：<NAME>` 只动这行 ③先备份再覆盖+跨平台家目录路径 ④只删 ppt/prototype/tech-master 三个旧 skill + UTF-8 无 BOM），HOW（命令/临时文件/路径展开/shell还是原生工具）交还 agent 自行按平台决定。好处：更短、跨平台免费搞定、躲开 PowerShell 中文 BOM 坑。注：仅改根 claude.md（安装说明源），不动 全局规则/claude.md（规则正文源）与 rules.md（构建产物）｜来源：用户（用户提出"是否过度设计、AI本就知道怎么装"，AI 给出"HOW 是过度设计但载荷保真不可砍"的分析，用户拍板"按上面讨论修改提交推送"）

- [06-28-2026 14:36:46] 新增 git-master skill｜背景：营队缺一个"把项目一键配成符合多人协作最佳实践"的工具，承接前几轮讨论的 issue/PR/CODEOWNERS/CI/分支保护最佳实践｜结论：新增第④个 master「git-master」，正交于 prd→design→tdd 产品链路（任何 git 项目独立可用）；流程=检测项目→轻交互→静默生成全套 .github/ 配置→汇报；产物=SKILL.md + references/协作模板底本.md + references/CI门禁与仓库设置.md；分发架构从「1md+3包」扩为「1md+4包」（install.md/build-release.sh/git.md 同步）；铁律=不静默覆盖已有配置+CI检测优先+分支保护只给指引不自动改(安全边界)；YAML模板语法已校验全绿｜来源：用户提出需求，AI 设计实现
- [06-28-2026 19:13:17] nginx 加 /git.md location｜背景：新增 git.md 后线上 /git.md 返回 SPA HTML（nginx 根 .md 是逐个手配 location 的，git.md 漏配；/skill/git.md 文件本身已正常部署）｜结论：服务器 /etc/nginx/sites-enabled/200w.liurun.vip.conf 照 tdd.md 加 `location = /git.md { rewrite ^ /skill/git.md last; }`，备份后 nginx -t + reload 生效；验证看实际内容确认返回 markdown｜教训：①发布后验证必须看实际内容，不能只看 HTTP 状态码（200 可能是 SPA try_files 兜底的 index.html）②新增根 .md 必须同步加 nginx location，否则线上拿不到｜来源：AI 发现（curl 内容是 HTML 非 markdown）+ 用户授权 SSH 改服务器

- [06-29-2026 01:19:52] 根 claude.md 安装说明 Codex 双兼容｜背景：原安装说明虽在第3行嘴上写"Claude Code / Codex"，但安装路径/备份示例/skill清理/重启提示四处全是 Claude Code 专属，Codex 用户照跑只会装到 ~/.claude/CLAUDE.md（Codex 不读它），等于装了也白装｜结论：四处改为真双兼容——①安装目标按"你跑在哪个工具"分别装到 ~/.claude/CLAUDE.md 或 ~/.codex/AGENTS.md（Windows 对应 %USERPROFILE% 路径）②备份示例补 AGENTS.md.bak ③清理旧 skill 限定"Claude Code 环境，Codex 无 skill 目录跳过"（skill 目录是 Claude Code 概念）④重启提示改为"重启你安装到的那个工具"⑤用户指令那句从"发给 Claude Code"改"发给 Claude Code 或 Codex"｜来源：用户（用户问"考虑 codex 了吗"，AI 诊断确认名义有实质无，用户拍板双兼容 + 给出路径 ~/.codex/AGENTS.md）

- [06-29-2026 01:28:35] 分发页拆分：单页四命令 → 四独立页 + 导航页｜背景：原 index.html 四条命令挤一页，分发时不便单独发某个步骤的链接｜结论：删 index.html，新建 5 个 HTML——start.html（导航入口）+ claude.html/prd.html/design.html/tdd.html（每页一条命令，复用原终端卡片视觉+一键复制），子页带"← 返回"回 start.html；线上 URL 均在 /skill/ 下（仓库根部署在 /skill/，根域名是另一主站有 SPA 兜底）；注意：删 index.html 后 /skill/ 根默认入口需 nginx index 配置或跳板，当前分发用具体页面 URL 不受影响｜来源：用户（用户提出"去掉这个页面改成四个页面"，AI 对齐路径命名/导航页去留/风格后执行）
- [06-30-2026 08:31:15] 新增 /goal 分发页｜背景：现有4个可复制命令页（claude/prd/design/tdd.html）覆盖 skill 安装，缺一个面向 /goal 全流程一键编排提示词的分发页；内容源在另一仓库 200m-ai-camp/提示词/10-全流程一键编排.md（约3900字，非单行命令，无法像其它页那样直接显示在卡片 code 区）｜结论：新建 goal.html，复用 tdd.html 卡片视觉，但把全文放进 <script type="text/plain" id="goal-payload"> 隐藏载体（script 为 HTML raw text，浏览器不解析标签/实体，原样保留），按钮读载体 .textContent.trim() 写剪贴板；卡片 code 区只显示"/goal 全流程一键编排提示词（完整内容）"作视觉锚点；Node 逐字校验载体与源 md trim 后完全一致（3910 字符 IDENTICAL:true）；按用户指示不进 start.html 导航｜来源：用户（指定主题 /goal、指定内容源文件、要求点复制即复制全文、明确"不用管导航"，AI 实现并验证）

- [06-30-2026 08:42:08] goal.html 展示完整 + 文案去字数｜背景：上一版全文藏 script 载体、卡片只显示一行锚点，用户要"进来后让用户看到完整的"；同时要求 sub 文案去掉"（约 1900 字）"｜结论：①卡片顶栏移入复制按钮，新增可见内容区 #goal-view，JS 加载时把载体 textContent 注入该区（用 .textContent 赋值自动转义，安全显示含尖括号路径不被当 HTML 标签吞），pre-wrap + 等宽字体 12.5px/1.75 行高保留原文换行与缩进；载体 script 原样保留作复制源与显示源（单一真相）；②sub 文案从"点复制即得完整提示词（约 1900 字）· 粘贴到..."改为"点复制即得完整提示词 · 粘贴到..."；③验证：Node 确认载体逐字一致(3910)、显示区存在、注入 JS 存在、字数已去、文案正确｜来源：用户（用户提"进来后让用户看到完整的"+"去掉括号里面的内容"，AI 实现）

- [06-30-2026 08:52:53] goal 提示词「时间/token」改顿号｜背景：源 md 末行"时间/token 充足"用了斜杠，用户指出应为顿号；该内容同时存在于源仓库(200m-ai-camp)与分发页(campskill/goal.html 载体)｜结论：按文档驱动先改源再同步产物——①源 200m-ai-camp/提示词/10-全流程一键编排.md 改"时间/token"→"时间、token"；②campskill/goal.html 载体同改；③Node 验证两处逐字一致(3910字符)、旧串清零、新串到位｜来源：用户（用户指出"时间/token 应该是顿号"）

- [07-01-2026 01:23:37] GitHub 教程定位澄清｜背景：用户让我参考"老王奶爸级 GitHub 文案"+git-master 写教程，初判为通用入门；用户澄清真实需求完全不同｜结论：教程面向**公司内部团队协作**（非开源、非外部贡献者），成员混合——部分有 Claude/AI 工具、部分纯手动 git、部分仅网页提 bug 的非开发（业务/测试/产品）；git-master 作为"团队长一键配置协作规范"的基建环节，讲它**干嘛的+怎么用**，**不讲安装**（安装走营队分发页 git.md/install.md）；老王那篇开源入门文案不适配内部团队场景（fork/开源协议等用不上），不作为基础，仅作 GitHub 功能常识参考；产物先行写草稿到 campskill 根，是否进线上分发待用户定｜来源：用户

- [07-01-2026 01:32:26] 教程 main 保护表述修正 + 迎合反省｜背景：用户质疑教程 1.2「git-master 让主干 main 谁都不能直接动」这句——指出 git-master 没这功能；我第一反应凭记忆附和"你说得对"未查原文，用户追问"你看了吗"，暴露我违反「证据优于推断 / 独立判断优于迎合」｜回查取证（SKILL.md:49/100/168、CI门禁与仓库设置.md:159/161）：git-master **默认不自动锁 main**，只生成「仓库协作设置指引.md」给团队长手动开（含 gh CLI 命令+网页步骤），除非用户当次明确要求才用 gh CLI 自动设｜结论：教程 1.2 与文末把"main 不能动"算作 git-master 功能 = 夸大误导，已改为"给指引、团队长手动开分支保护才生效，默认不自动锁"；可复用教训=**被纠正时先回查原文取证再表态，禁止凭记忆附和**｜来源：用户纠错 + AI 回查

## 待解决问题
- 新规则发布到线上（build-release.sh）待用户许可

## 注意
- 全局规则/claude.md 是规则正文唯一源，build 时 cp 出 rules.md，源不动
- 提问收敛闸门.md 在三个skill各有一份，打包各cp各的
- deploy.yml 约40秒完成，验证线上要等够时间

## 工作文件集
- 前次：rules.md / 全局规则claude.md / 张永生纪要（见历史决策）
- claude.md（前次：根安装说明源规格化）
- 本轮（新增 git-master）：
  - git-master/SKILL.md（新建：定位/流程/纪律）
  - git-master/references/协作模板底本.md（新建：issue表单×2+config.yml+PR模板+CODEOWNERS+CONTRIBUTING，YAML已校验全绿）
  - git-master/references/CI门禁与仓库设置.md（新建：6技术栈CI模板+分支保护gh CLI/网页指引+标签+stale bot）
  - git.md（新建：安装说明）
  - install.md（改：4→5条命令）
  - build-release.sh（改：SKILLS数组+git-master）
  - doc/项目纪要-永生.md（本次：记 git-master 决策）
- 本轮（Codex 双兼容）：
  - claude.md（改：安装说明四处双兼容——安装路径/备份示例/skill清理限定Claude/重启提示）
  - doc/项目纪要-永生.md（本次：记 Codex 双兼容决策；上轮遗留 git.md nginx 记录一并提交）
- 本轮（新增 goal.html）：
  - goal.html（新建：/goal 全流程一键编排分发页，全文放 <script type="text/plain"> 隐藏载体，按钮读载体写剪贴板，Node 校验与源 md 逐字一致 3910 字符）
  - doc/项目纪要-永生.md（本次：记 /goal 页决策）
- 本轮（goal.html 展示完整 + 文案去字数）：
  - goal.html（改：卡片新增可见区 #goal-view，JS 注入载体原文显示（textContent 自动转义），pre-wrap+等宽保留格式；复制按钮移顶栏；sub 去掉「（约 1900 字）」）
  - doc/项目纪要-永生.md（本次：记展示改造与文案调整）
- 本轮（goal 提示词顿号修正，跨两仓库）：
  - 200m-ai-camp/提示词/10-全流程一键编排.md（改：末行"时间/token"→"时间、token"，源文档先改）
  - goal.html（改：载体同处同步"时间、token"）
  - doc/项目纪要-永生.md（本次：记顿号修正决策）
- 本轮（公司团队 GitHub 协作教程，新写）：
  - 公司团队GitHub协作教程.md（新建：面向公司内部团队协作，分角色——团队长用 git-master 配基建 / 业务网页提 issue / 开发两条路改代码+PR；git-master 讲干嘛+怎么用不讲安装）
  - doc/项目纪要-永生.md（本次：记教程定位澄清决策）
- 本轮（教程 main 保护表述修正）：
  - 公司团队GitHub协作教程.md（改：1.2 与文末——「让 main 谁都不能直接动」原算作 git-master 功能=夸大，改为「给指引、团队长手动开分支保护才生效，git-master 默认不自动锁」；依据 SKILL.md:49/100/168 + CI门禁:159/161）
  - doc/项目纪要-永生.md（本次：记 main 表述修正 + 迎合反省）