From 55ee5a483ce74da7ec09f14a6570ee39bd0b32c5 Mon Sep 17 00:00:00 2001 From: lanrtop Date: Sat, 18 Jul 2026 10:25:01 +0900 Subject: [PATCH] =?UTF-8?q?feat(templates):=20=E6=96=B0=E5=A2=9E=E5=86=85?= =?UTF-8?q?=E7=BD=AE=E6=A8=A1=E6=9D=BF=E3=80=8C=E7=9F=A5=E8=AF=86=E5=BA=93?= =?UTF-8?q?=EF=BC=88=E6=8B=A9=E5=8D=87=E7=8E=AF=EF=BC=89=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 三层晋升结构的知识沉淀文档库初始化:dialogues 对话原料 → concepts 概念卡 → CORE.md 稳定核心(上限 300 行强制过滤),cases/ 为检验层。 晋升/降级规则与写作纪律内置于模板 AGENTS.md,agent 进库即按择升环工作流运转; init_commands 为 git init,建库即版本化。 Feature-Confirmed: true --- .blueprint/modules/project-templates.md | 12 +++ src-tauri/src/commands/templates.rs | 116 ++++++++++++++++++++++++ 2 files changed, 128 insertions(+) diff --git a/.blueprint/modules/project-templates.md b/.blueprint/modules/project-templates.md index 7db5795..9e95809 100644 --- a/.blueprint/modules/project-templates.md +++ b/.blueprint/modules/project-templates.md @@ -37,3 +37,15 @@ progress: 100 - `builtin-vite-react`:React 19 + TS + TailwindCSS v4 + React Router v7,纯前端 SPA 起点 - `builtin-tauri-react-tailwind`:Tauri v2 + React + TailwindCSS v4,客户端应用带样式 - `builtin-web-mobile-monorepo`:Web + Mobile 共享 Monorepo,packages/core(业务逻辑)+ packages/types + apps/web(Vite+Tailwind)+ apps/mobile(Expo+NativeWind) + +### 🔵 知识库(择升环)模板 +- status: in_progress +- complexity: S +- files: src-tauri/src/commands/templates.rs +- acceptance: | + agent_verify: [Rust] cargo build 通过;seed 数据含 builtin-knowledge-loop,files 覆盖 CORE.md/concepts/dialogues/cases/AGENTS.md + human_verify: 应用内新建项目选该模板 → 生成目录结构与晋升规则内容符合预期 + +新增内置模板 `builtin-knowledge-loop`:方法论/知识沉淀文档库。 +三层晋升结构(dialogues 原料 → concepts 概念卡 → CORE.md 稳定核心), +晋升规则写入模板 AGENTS.md,agent 进库即按择升环工作流运转。init_commands 为 `git init`。 diff --git a/src-tauri/src/commands/templates.rs b/src-tauri/src/commands/templates.rs index 15bb2d3..1616adf 100644 --- a/src-tauri/src/commands/templates.rs +++ b/src-tauri/src/commands/templates.rs @@ -1589,6 +1589,122 @@ export default function HomeScreen() { "#), ], }, + // ── 知识库(择升环)──────────────────────────────────────────────────── + Tpl { + id: "builtin-knowledge-loop", + name: "知识库(择升环)", + description: "方法论 / 知识沉淀文档库。三层晋升结构:dialogues 对话原料 → concepts 概念卡 → CORE 稳定核心,晋升规则内置于 AGENTS.md,agent 进库即按择升环工作流运转。", + platform: "both", + tech_stack: r#"{"体系":["知识库"],"框架/工具":["Markdown","Git"]}"#, + init_commands: "git init", + variants: None, + files: vec![ + ("CORE.md", r#"# {{project_name}} · 核心层 + +> 本文件是知识库的稳定核心——只收录经过实践检验、表述已收敛的内容。 +> ⚠️ 过滤铁律:全文上限 300 行。收录新内容超限时,必须合并或挤掉旧内容—— +> 只升不择的核心层会失去判断力。 + +## 定义 + + + +## 已验证原理 + + + +## 修订记录 + + +"#), + ("AGENTS.md", r#"# {{project_name}} — AI Agent 工作规程 + +本仓库是知识库,不是代码库。目录即晋升流水线: + +``` +dialogues/(对话原料,允许粗糙) + → concepts/(概念卡,一事一文件) + → CORE.md(稳定核心,上限 300 行) +``` + +cases/ 是检验层:概念卡晋升 CORE 的依据来自真实案例。 + +## 每次会话必须执行 + +1. 先读 `CORE.md` 与本次话题相关的 `concepts/` 卡——上一轮的结论是这一轮的输入 +2. 探讨结束后,把整理稿写入 `dialogues/YYYY-MM-DD-主题.md` +3. 对照晋升规则检查是否触发晋升 / 降级,触发则执行 +4. git commit 收尾——本库以 git 历史作为演化台账 + +## 晋升规则(择) + +| 从 | 到 | 条件 | +|----|----|------| +| dialogues/ | concepts/ | 同一想法在 ≥2 次对话中出现,或 ≥1 个真实案例站住 | +| concepts/ | CORE.md | 状态「稳定」+ 经 cases/ 检验 + 表述收敛为一段话 | + +降级同样重要:被案例证伪的概念卡标记废弃;CORE.md 超 300 行必须挤旧。 +只升不择,核心层会膨胀成噪音。 + +## 写作纪律 + +- 单一事实来源:同一结论只在一层的一个文件里详述,其他位置引用 +- 概念卡必须写「边界」(什么条件下不成立)——没有边界的结论不可信 +- 修改 CORE.md 必须在其修订记录写明:进了什么、挤了什么、为什么 +- 案例复盘必做归因二分:执行缺口(概念没用好)修行动; + 规格缺口(概念本身有漏洞)回改概念卡——后者是全库最值钱的信号 +"#), + ("concepts/README.md", r#"# concepts/ — 概念卡层 + +一个概念一个文件,文件名 kebab-case(如 `pinggu-wai-huan.md`)。 + +## 概念卡格式 + +```markdown +# 概念名 + +- 状态:孵化 | 稳定 | 已入核 | 已废弃 +- 出处:dialogues/YYYY-MM-DD-xxx.md +- 最近验证:YYYY-MM-DD(cases/xxx.md) + +## 定义 +一段话说清它是什么。 + +## 为什么成立 +支撑它的推理或证据。 + +## 边界 +它在什么条件下不成立。 +``` + +## 晋升与降级 + +- 晋升进 CORE.md 后,状态改「已入核」,详述保留在卡内,CORE 只收一段话结论 +- 被案例证伪 → 状态改「已废弃」并写明证伪案例,不直接删(失败也是判断力) +"#), + ("dialogues/README.md", r#"# dialogues/ — 对话沉淀层(原料) + +每次探讨结束后,把整理稿存入本目录。这一层的目标是「不丢」,不是「精炼」。 + +- 命名:`YYYY-MM-DD-主题.md` +- 开头写三行摘要:讨论了什么 / 新想法 / 待验证 +- 同一想法第二次出现时,检查是否触发晋升为概念卡 +"#), + ("cases/README.md", r#"# cases/ — 实例复盘层(检验) + +记录概念在真实事件中的应用与翻车。案例是概念卡晋升 CORE 的检验依据。 + +- 命名:`YYYY-MM-DD-事件.md` +- 必写字段:用了哪个概念 / 预期 / 实际结果 / 归因(执行缺口 or 规格缺口) +- 规格缺口 → 回改概念卡;执行缺口 → 概念不动,记录教训 +"#), + (".gitignore", ".DS_Store\nThumbs.db\n*.tmp\n"), + ], + }, ]; for t in &templates {