learn · git:20261026.a78b4df · 2026-10-26 · sha256 b5f170b9e7ef25a1
learn git:20261026.a78b4dfA
Immutable. This exact content never changes and is served at /api/v1/blob/b5f170b9e7ef25a1.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_iwn5qykdec42w2ry/b5f170b9e7ef25a1f1e183ee14cf392fd7cd4321bc8b4d4a871b300e6a70500c.json
Then /plugin install learn@markdownregistry-iwn5qykdec42w2ry in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: learn description: 学习项目(/learn):CHANGELOG/git/archive→.growing/learn/。不写 .cursor。 disable-model-invocation: true --- # learn **用这个**:沉淀**本仓库**约定 → `.growing/learn/`。**不是那个**:学 Rust/新框架等通用技术 → **study**(可写 `SPIKE-*`)。 边界见 **cursor-standalone** · `workflow.json` → `growth.learn_sources` **docs 体系**:首次 `/learn` 时据仓库证据建议 profile(web 全栈 / API / 前端 / **library**(纯库无数据库)/ CLI),然后 `runner.sh docs-init --profile <p>` 铺 `docs/` 号位骨架;号位与 profile 语义 → `rules/execution/project-docs.mdc`。 ## Growth 边界(产出 · 非母版 SSOT) | 层 | 规则 | |----|------| | **写入** | 本 skill 只产出 `.growing/learn/`(及 `/plan`·`/run` 写 plan · archive) | | **读取** | `/run` 可**按需**读已有 `learn/`;`/learn` 可吸收本地 `archive/` · `plan` — **仅本机项目上下文** | | **母版禁止** | `.cursor/` 文档**不得**链具体 archive 文件名;对外发版由 **release** 写仓库根发版文件(母版正文不链) | | **不是** | 把 archive 当安装包内容;把 Growth 路径写进母版业务代码 | ## 输出(仅 `.growing/learn/`) **自动引导**(无需等用户说 `/learn`): 1. **`install-super-cursor.sh`** — 复制 `templates/growing/` → 目标 `.growing/` 2. **`hooks/growth-init.sh`**(`beforeSubmitPrompt`)— 若目录缺失则创建;**按文件**种子 `learn/*.md`(已存在的不覆盖) 首次 **`/learn`** 在种子文件上**增量填写**「待填」项,并吸收 CHANGELOG / archive / plan。 ### 空模板最小采集(首次闭环 · 不必读全仓) `learn/` 全为「待填」时,**先用 3 个问题**把最小闭环填上(AskQuestion 或正文编号;能从仓库直接读出的**不要问**): | # | 问什么 | 落点 | 为什么必须 | |---|--------|------|-----------| | 1 | 开发/测试命令(或「没有」) | `dev-conventions.md` · `scripts/test.sh` | `task-verify` 的兜底与验收列都依赖它;没有就是明确写「无」 | | 2 | 代码分层与入口(模块、目录、依赖方向) | `module-map.md` | 让 `/plan` 拆 TASK 时落点准确,减少返工轮次 | | 3 | 发版节奏(谁打 tag · 频率 · CHANGELOG 习惯) | `release-rhythm.md` | `/release` 与 ship agent 的判断依据 | 读完这 3 项再按需补 `acceptance.md` / `changelog-insights.md`;**不要**为填表而通读全仓。 安装脚本会在结尾提示「首次必做 → `/learn`」;跳过它,闸门与验收会空转(验收列只能写描述性文字,而 `task-verify` 对描述性验收是 fail-closed)。 | 文件 | 内容 | |------|------| | `plan-conventions.md` | archive 命名 · 可选 plan 段落 · Sprint 标题用语 — 供 **plan** / **run** / `plan-check` | | `dev-conventions.md` | 命名、目录、测试/verify 命令、分支策略 | | `module-map.md` | 模块边界、入口、依赖方向 | | `release-rhythm.md` | 发版频率、谁打 tag、CHANGELOG 习惯 | | `changelog-insights.md` | 近期对外变更摘要 | | `last-sync.md` | 本次同步时间、来源、待确认项 | | `acceptance.md` | (可选)design tokens · i18n · OpenAPI — 供 **delivery** skill | **大型仓库(可选)**:可在 `learn/` 下分子目录(例:`core/` · `api/` · `ux/` · `perf/`),根目录仍保留上表 7 个种子或链到 `core/`。母版不强制深度;复制 `templates/growing/learn/*.example.md` 作专题起点。 **摩擦趋势**(若 `.growing/logs/friction.jsonl` 存在)→ 运行 `./.cursor/bin/runner.sh friction-report`,把一行结论写进 `dev-conventions.md`(例:`avg_rounds=2.3 · verify_fail=1/8 — 验收列偏描述性`)。这是**唯一**衡量"少拉扯"是否真的改善的证据。 **实验 / 批跑坐标**(通用闭环见 **spike** agent §experiment-loop)→ 写入 `dev-conventions.md` 或 `learn/` 专节:产物根目录 · 报告命名 · 索引 README · gate 脚本路径。**勿**把项目路径写进 `.cursor/` 母版。 ## 何时运行 | 时机 | 动作 | |------|------| | 新项目接入 | 首次 `/learn` 建骨架 | | Sprint 结束 | 吸收 archive 中 **Goal**、决策、**Out of scope** / ROADMAP | | 大重构后 | 更新 `module-map` | | 发版后 | 更新 `release-rhythm` + `changelog-insights` | | 重复劳动审计 | 用户要求或 Sprint 密集 patch 后 → §CHANGELOG 重复模式审计 | | 约定缺口 | 用户说「该加规则吗」或反复踩同一坑 → §建议约定 | | 命令/验收意外失败 | 记 **ERRORS** 摘要 → §经验捕获 | | 用户纠正(「不对」「其实…」) | 记 **LEARNINGS** → §经验捕获 | ## 经验捕获(任务中 · 可选) **用这个**:可复用教训写入 `.growing/learn/`。**不是那个**:改母版 `.cursor/`(须 plan 授权 + TASK)。 | 类型 | 写什么 | 默认落点 | |------|--------|----------| | **ERRORS** | 失败上下文 · 根因 · 已验证修复 | `dev-conventions.md` §建议约定 或 `changelog-insights.md` | | **LEARNINGS** | 偏好 · 纠正 · 可复用模式 | 同上;跨模块边界 → `module-map.md` 一句 | **晋升门禁**:重复 ≥2 或广泛适用 → 走 §建议约定 → **用户确认** → `learn/` 或 `rules/local/`;**禁止**自动改 `.cursor/skills|rules|config`。单会话草稿可留在回复中,不必每次落盘。 ## 建议约定(蒸馏自 suggesting-cursor-rules) **用这个**:从本仓证据提出「该记哪条约定」。**不是那个**:新开 Sprint 拆 TASK → **plan**;学通用技术 → **study**。 ### 何时建议 - Sprint 收尾 / `/learn` 吸收后,发现重复决策或口头约定未落盘 - CHANGELOG / archive 同症状簇 ≥2(见上节重复模式审计) - 用户明确问「要不要加 rule / convention」 ### 证据 → 建议 → 落点 | 证据来源 | 建议形态 | 默认落点 | |----------|----------|----------| | archive · plan Out of scope | 一行「本仓不做什么」 | `learn/plan-conventions.md` 或 `dev-conventions.md` | | 命名/目录/verify 命令 | 可执行约定 | `learn/dev-conventions.md` | | 模块边界 | 依赖方向一句 | `learn/module-map.md` | | 团队特化门禁(仍属本仓) | 短 rule | `.growing/rules/local/`(链 `.cursor/rules/local`) | | 母版 SOP 缺口 | **仅建议 + 等授权** | **禁止**日常写入 `.cursor/` | ### 输出格式(写给用户确认) ``` 建议约定: - 证据:…(CHANGELOG 版本 / archive 名 / file:line) - 建议条文:… - 落点:learn/… 或 rules/local/… - 不写入:.cursor/ 母版(除非用户明确授权 + plan TASK) ``` **禁止**:无证据空建议;擅自改 `.cursor/rules|skills|config`;把通用技术笔记塞进 learn(去 **study**)。 ## CHANGELOG 重复模式审计(可选) 当用户说「重复工作」「follow-up 太多」或 `followup_gate` 触发时: 1. 读 `CHANGELOG.md` 最近 7/30 天(或用户指定窗口) 2. grep 症状关键词簇(进度/上传/弹窗/刷新/error_message/检测器/死代码…) 3. 对照 `.cursor/rules/execution/async-progress.mdc` 等 **通用根因类型** 归类 4. 更新 `.growing/learn/changelog-insights.md` §重复工作模式(**只写项目符号与版本**) 5. 建议 plan 候选:合并 Sprint · SPIKE · 关闭多余 follow-up 模板:`.cursor/templates/growing/learn/changelog-insights.md` · SPIKE:`.cursor/templates/spike-regression-cluster.md` ## 合并原则 - **增量合并**:保留旧条目,标 `(已废弃)` 而非直接删 - **不确定** → `(待确认)`,不写入 `.cursor/` - **不 commit** `.growing/`(git 忽略) - 读序仍为:rules → config → **learn/**(覆盖项目默认) ## 演进循环 | 变更类型 | 去向 | 谁可写 | |----------|------|--------| | 项目约定、模块地图 | `.growing/learn/` | **learn** | | 母版 `.cursor/` SOP | 须用户明确授权 + plan 任务 | 非日常 learn | | Sprint 决策 | `.growing/archive/` + plan 索引 | **plan** 收尾 | - 母版与项目边界:见 `rules/feedback/evolution.mdc` - 增量合并 learn;标 `(已废弃)` 而非静默删除