From 0946a21cd3a5b18871e184e4b5fcbf5f3784bd3f Mon Sep 17 00:00:00 2001 From: karuo Date: Wed, 18 Feb 2026 00:27:55 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=94=84=20=E5=8D=A1=E8=8B=A5AI=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=202026-02-18=2000:27=20|=20=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=EF=BC=9ACursor=E8=A7=84=E5=88=99=E3=80=81GitHub=20Actions?= =?UTF-8?q?=E3=80=81=E7=81=AB=E7=82=AC=E3=80=81=E7=81=AB=E7=9C=BC=E6=99=BA?= =?UTF-8?q?=E8=83=BD=E7=BA=AA=E8=A6=81=E3=80=81=E6=80=BB=E7=B4=A2=E5=BC=95?= =?UTF-8?q?=E4=B8=8E=E5=85=A5=E5=8F=A3=E3=80=81=E8=BF=90=E8=90=A5=E4=B8=AD?= =?UTF-8?q?=E6=9E=A2=E5=8F=82=E8=80=83=E8=B5=84=E6=96=99=E3=80=81=E8=BF=90?= =?UTF-8?q?=E8=90=A5=E4=B8=AD=E6=9E=A2=E5=B7=A5=E4=BD=9C=E5=8F=B0=20|=20?= =?UTF-8?q?=E6=8E=92=E9=99=A4=20>20MB:=205=20=E4=B8=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .cursor/rules/karuo-ai.mdc | 4 + .github/workflows/sync_github_to_gitea.yml | 39 ------ 04_卡火(火)/火炬_全栈消息/全栈开发/SKILL.md | 82 ++++++++++-- .../火炬_全栈消息/开发文档操控/SKILL.md | 99 ++++++++++++++ .../智能追问/参考资料/卡若AI能力自我追问清单.md | 125 ++++++++++++++++++ BOOTSTRAP.md | 2 + SKILL_REGISTRY.md | 15 ++- 总索引.md | 1 + .../参考资料/卡若AI交互流程与强制执行条件.md | 15 ++- 运营中枢/参考资料/卡若AI异常处理与红线.md | 37 ++++++ 运营中枢/参考资料/卡若复盘格式_固定规则.md | 38 +++--- 运营中枢/工作台/gitea_push_log.md | 1 + 运营中枢/工作台/代码管理.md | 1 + 13 files changed, 375 insertions(+), 84 deletions(-) create mode 100644 04_卡火(火)/火炬_全栈消息/开发文档操控/SKILL.md create mode 100644 04_卡火(火)/火眼_智能追问/智能追问/参考资料/卡若AI能力自我追问清单.md create mode 100644 运营中枢/参考资料/卡若AI异常处理与红线.md diff --git a/.cursor/rules/karuo-ai.mdc b/.cursor/rules/karuo-ai.mdc index 4f517422..c02dc1e6 100644 --- a/.cursor/rules/karuo-ai.mdc +++ b/.cursor/rules/karuo-ai.mdc @@ -14,6 +14,10 @@ alwaysApply: true 2. **读 `SKILL_REGISTRY.md`**(根目录)— 按用户需求查找技能 3. 匹配到技能后读对应 `SKILL.md` 执行 +## 异常处理与红线(强制) + +执行时遵守 `运营中枢/参考资料/卡若AI异常处理与红线.md`:未匹配→推荐 2~3 技能或学习扩展;API 失败→搜索并循环直到成功;多技能→合并不让用户选;复盘遗漏→强制补发。**红线**:不改变卡若AI 整体结构、不导致电脑无法启动、不删除重大文件。 + ## 强制对话流程(每次对话必守) ### 第一步:先思考,简洁输出在对话框 diff --git a/.github/workflows/sync_github_to_gitea.yml b/.github/workflows/sync_github_to_gitea.yml index 60acb2d8..e69de29b 100644 --- a/.github/workflows/sync_github_to_gitea.yml +++ b/.github/workflows/sync_github_to_gitea.yml @@ -1,39 +0,0 @@ -# 将 fnvtk 的 GitHub 仓库同步到 CKB NAS Gitea(open.quwanzhi.com:3000) -# 触发:定时(每6小时)、手动、或任意 push 时可选触发 -# 仓库需配置 Secrets:GITEA_TOKEN(必填)、GITHUB_TOKEN(全量同步必填) -name: Sync GitHub to CKB NAS Gitea - -on: - schedule: - - cron: "0 */6 * * *" - workflow_dispatch: {} - push: - branches: [ main, master ] - paths-ignore: - - "**.md" - - ".github/workflows/sync_github_to_gitea.yml" - -jobs: - sync: - runs-on: ubuntu-latest - steps: - - name: Checkout - uses: actions/checkout@v4 - - # 全量同步 fnvtk 下所有仓库时,请在仓库 Secrets 中配置 GH_PAT(GitHub PAT,repo 权限) - - name: Sync GitHub → Gitea - env: - GITHUB_TOKEN: ${{ secrets.GH_PAT || secrets.GITHUB_TOKEN }} - GITEA_TOKEN: ${{ secrets.GITEA_TOKEN }} - GITEA_BASE_URL: "http://open.quwanzhi.com:3000" - GITHUB_USER: "fnvtk" - GITEA_USER: "fnvtk" - SYNC_WORK_DIR: "${{ runner.temp }}/github_gitea_sync" - run: | - sudo apt-get update -qq && sudo apt-get install -y -qq jq - chmod +x "01_卡资(金)/金仓_存储备份/群晖NAS管理/脚本/sync_github_to_gitea.sh" 2>/dev/null || true - if [ -f "01_卡资(金)/金仓_存储备份/群晖NAS管理/脚本/sync_github_to_gitea.sh" ]; then - bash "01_卡资(金)/金仓_存储备份/群晖NAS管理/脚本/sync_github_to_gitea.sh" - else - echo "未找到同步脚本,跳过(请确认仓库结构)。" - fi diff --git a/04_卡火(火)/火炬_全栈消息/全栈开发/SKILL.md b/04_卡火(火)/火炬_全栈消息/全栈开发/SKILL.md index 0e67af54..c66b3c91 100644 --- a/04_卡火(火)/火炬_全栈消息/全栈开发/SKILL.md +++ b/04_卡火(火)/火炬_全栈消息/全栈开发/SKILL.md @@ -1,20 +1,77 @@ --- name: 全栈开发 -description: 卡若AI 全栈开发(火炬)— 知己及类似项目的核心代码结构、分销机制、管理机制、AI 向量化经验沉淀。开发类似项目时自动激活。 -triggers: 全栈开发/知己项目/分销/存客宝/RAG/向量化/Next.js/知识库 +description: 卡若AI 全栈开发(火炬)— 知己及类似项目经验 + 官网/全站开发与「开发文档 1~10」标准流程。含分销、RAG、向量化;官网/全站类任务时按 1~10 调研→生成→更新,类似事情用本 Skill 做调研与生成。 +triggers: 全栈开发/知己项目/分销/存客宝/RAG/向量化/Next.js/知识库/卡若AI官网/官网开发/全站开发/开发文档/1~10/开发模板/官网全站/v0前端/v0生成/毛玻璃/前端规格 owner: 火炬 group: 火 -version: "1.0" -updated: "2026-02-16" +version: "2.0" +updated: "2026-02-17" --- # 全栈开发(火炬) -> 主责吸收知己项目经验;协同:水泉(项目管理)、金盾(存客宝)、土基(分销)。 +> 主责:知己类项目经验 + **官网/全站开发**与开发文档 1~10 标准流程。协同:水泉(需求拆解)、金盾(存客宝)、木果(开发模板)。 --- -## 一、项目经验库(必读) +## 一、官网/全站开发与开发文档 1~10(优先) + +当用户需求涉及 **官网、全站、新站、开发文档、1~10 目录** 时,按本小节执行。 + +### 1.1 标准结构(开发文档) + +- **根目录**:仅保留一个 **README.md**,作为 1~10 索引入口;**全部文档归入 10 个目录**,不在根目录散落。 +- **1~10 目录**:需求 | 架构 | 原型 | 前端 | 接口 | 后端 | 数据库 | 部署 | 手册 | 项目管理。 +- **入口**:第一次用先读 `1、需求/卡若AI项目使用说明.md`(或该项目等价说明),再读 `10、项目管理/开发文档使用指引(卡若交互式).md`。 +- **手册**:`9、手册/使用手册(带图).md` 为访客/开发者操作手册;配图放 `9、手册/images/`。 +- **复盘**:迭代结尾用 `10、项目管理/迭代复盘模板.md`(卡若复盘格式,含 Human 3.0 反思与总结)。 + +### 1.2 执行流程(调研 → 生成 → 更新) + +1. **调研**:先读目标项目的 `开发文档/README.md` 与 `1、需求` 下项目使用说明;无则按 1~10 自建目录并补 `卡若AI项目使用说明` 级总览。 +2. **生成/更新**:按 1~10 与「开发文档使用指引」:需求/架构/原型/前端/接口/后端/数据库/部署/手册/项目管理 逐项生成或更新;前端按 `4、前端/前端开发流程(卡若式).md` 与组件规格、检查清单执行。 +3. **验收与复盘**:用 `10、项目管理/项目落地执行表` 与 `迭代复盘模板` 更新状态并写复盘;有类似需求时**用本 Skill 做调研再生成**,避免重复造轮。 + +### 1.3 参考项目(标准模板) + +**卡若AI 官网** 开发文档为当前标准参考,路径(按用户环境替换): + +- 开发文档根:`/Users/karuo/Documents/开发/3、自营项目/卡若ai网站/开发文档/` +- 入口:`开发文档/README.md`(1~10 索引)、`1、需求/卡若AI项目使用说明.md` +- 使用指引:`10、项目管理/开发文档使用指引(卡若交互式).md` +- 使用手册(带图):`9、手册/使用手册(带图).md` +- 复盘模板:`10、项目管理/迭代复盘模板.md` + +前端需求与内容以该仓库下 `4、前端/`(规范、页面与路由、组件规格、毛玻璃与自适应、v0 融合、检查清单)及 `3、原型/` 为准;部署以 `8、部署/` 为准。 + +### 1.4 前端(含开发文档 4、前端 与 v0 能力融合) + +官网/全站前端统一按 **开发文档 4、前端** 执行,并融合 **Vercel v0** 生成能力;部署到 Vercel/v0 时与金盾「Vercel与v0部署流水线」协同。 + +**4、前端 必读文档(开发文档内)**: + +| 文档 | 用途 | +|:---|:---| +| `4、前端/前端开发流程(卡若式).md` | 先读再做:做首页/能力页等的顺序与验收 | +| `4、前端/各页面组件规格.md` | 每页组件(GlassCard/GlassNav)、Props、验收 | +| `4、前端/苹果毛玻璃风格与自适应规范.md` | 毛玻璃 token、断点、v0 生成后替换为 glass 类 | +| `4、前端/前端能力与v0融合.md` | v0 出稿 → 套毛玻璃/自适应 → 接数据与路由 | +| `4、前端/v0使用步骤.md` | 用 v0 生成前端的步骤:打开 v0.dev → 粘贴规格 → 生成 | +| `4、前端/v0生成用-卡若AI官网前端规格.md` | 复制「复制起点~复制终点」到 v0 输入框,生成 Next + Tailwind + shadcn + 毛玻璃 | +| `4、前端/前端开发检查清单.md` | 单页与全站验收打勾 | + +**v0 前端工作流(与开发文档一致)**: + +1. **出稿**:在 v0.dev 新建项目,粘贴 `v0生成用-*前端规格.md` 内复制起点~复制终点内容,输入「按此规格生成,Next.js + Tailwind + shadcn/ui,苹果毛玻璃,移动端自适应」;可先首页再分页生成。 +2. **落库**:将 v0 生成代码复制到项目 `site/` 或 `frontend/`,与现有结构对齐。 +3. **套规范**:把 v0 的 Card/Nav 等替换为 `glass-card`、`glass-nav` 或《苹果毛玻璃风格与自适应规范》中的类;补全 `sm:/md:/lg:` 与触达 ≥44px。 +4. **验收**:用《前端开发检查清单》自检;有部署到 Vercel/v0 需求时走金盾「Vercel与v0部署流水线」Skill。 + +**协同**:Word/文档类清洗用火炬「文档清洗」;部署到 v0、同步 GitHub/Vercel 用金盾「Vercel与v0部署流水线」。 + +--- + +## 二、项目经验库(知己类,必读) **参考路径**:`运营中枢/参考资料/项目经验库_知己与类似项目.md` @@ -29,7 +86,7 @@ updated: "2026-02-16" --- -## 二、知己核心代码结构(速查) +## 三、知己核心代码结构(速查) ``` app/ # Next.js App Router @@ -48,7 +105,7 @@ scripts/ --- -## 三、分销机制(知己实现) +## 四、分销机制(知己实现) - **规则**:一级 20%、二级 10%;30 天绑定;7 天后结算;最低提现 10 元。 - **核心**:`lib/distribution/service.ts`、`lib/profit-sharing/service.ts`。 @@ -56,7 +113,7 @@ scripts/ --- -## 四、AI 向量化 / RAG +## 五、AI 向量化 / RAG - **RAG**:`lib/rag.ts`,OpenAI text-embedding-3-small 1536 维。 - **向量化脚本**:`scripts/vectorize-knowledge.mjs`。 @@ -64,15 +121,16 @@ scripts/ --- -## 五、已吸收 reference 一览 +## 六、已吸收 reference 一览 -| 文档 | 用途 | +| 文档/项目 | 用途 | |:---|:---| | 项目经验库_知己与类似项目 | 核心代码、分销、AI 向量化、经验分配 | | 项目开发能力_来自知己 | 10 目录、端口、附件、截图、经验、复盘 | | 项目开发中整合存客宝获客功能 | 获客型项目 + 存客宝 | | 多Agent与板块拆分(水泉) | 业务流程 vs 开发流程、十目录界定 | +| **卡若ai网站 开发文档** | **官网/全站开发标准:1~10 结构、前端需求与内容、使用手册(带图)、提示词与执行流程** | --- -*开发类似项目时:先读 项目经验库_知己与类似项目 → 按需调用协同 Skill。* +*官网/全站类任务:先调研开发文档(1、需求 + 10、项目管理)→ 按 1~10 生成或更新 → 复盘。知己类:先读 项目经验库_知己与类似项目 → 按需调用协同 Skill。* diff --git a/04_卡火(火)/火炬_全栈消息/开发文档操控/SKILL.md b/04_卡火(火)/火炬_全栈消息/开发文档操控/SKILL.md new file mode 100644 index 00000000..aaa3d2af --- /dev/null +++ b/04_卡火(火)/火炬_全栈消息/开发文档操控/SKILL.md @@ -0,0 +1,99 @@ +--- +name: 开发文档操控 +description: 操控采用「1~10 目录」的网站开发文档,实现调研、生成、更新、整合与复盘。每个网站项目可复制本 Skill 一份,将「开发文档路径」改为该项目路径即可按本能力操作该站开发文档。 +triggers: 开发文档操控/开发文档/1~10文档/网站开发文档/文档维护/开发文档维护 +owner: 火炬 +group: 火 +version: "1.0" +updated: "2026-02-17" +--- + +# 开发文档操控(火炬) + +> **用途**:任一采用「开发文档 1~10」结构的网站项目,均可由本 Skill 操控其开发文档的全部工作内容。 +> **用法**:主仓库保留通用版;**每个网站复制本 Skill 一份**到该项目(如放 `开发文档/SKILL_开发文档操控.md`),将下方「开发文档路径」改为该项目的开发文档根路径即可。 + +--- + +## 一、开发文档路径(复制到项目后必改) + +**通用版(主仓库)**:以卡若AI 官网为例,路径为: + +``` +开发文档根 = /Users/karuo/Documents/开发/3、自营项目/卡若ai网站/开发文档/ +``` + +**复制到某网站后**:把「开发文档根」改为该网站仓库内的开发文档目录,例如: + +``` +开发文档根 = <该项目根>/开发文档/ +``` + +所有下列步骤中的 `开发文档/` 均指上述「开发文档根」。 + +--- + +## 二、标准结构(必须遵守) + +- **根目录**:仅保留一个 `README.md`,作为 1~10 索引入口;**全部文档归入 10 个目录**,根目录不散落其他文档。 +- **1~10 目录**:`1、需求` | `2、架构` | `3、原型` | `4、前端` | `5、接口` | `6、后端` | `7、数据库` | `8、部署` | `9、手册` | `10、项目管理`。 +- **入口文档**:`README.md`(1~10 索引)、`1、需求/卡若AI项目使用说明.md` 或该项目等价总览、`10、项目管理/开发文档使用指引(卡若交互式).md`。 +- **手册**:`9、手册/使用手册(带图).md`;配图放 `9、手册/images/`。 +- **复盘**:迭代结尾用 `10、项目管理/迭代复盘模板.md`(卡若复盘格式)。 + +--- + +## 三、工作内容与操作(按本 Skill 执行) + +### 3.1 调研 + +- 先读 `开发文档/README.md` 与 `1、需求` 下项目使用说明(或业务需求、技术需求)。 +- 明确本项目要做什么、给谁用、MVP 边界;无 1~10 则按本结构自建目录并补总览。 + +### 3.2 生成 / 更新 + +按 1~10 与「开发文档使用指引」逐项维护: + +| 目录 | 工作内容 | +|:---|:---| +| 1、需求 | 业务需求、技术需求、成本、功能迭代记录、项目使用说明 | +| 2、架构 | 系统架构、技术选型、模块拆分、数据库概要 | +| 3、原型 | 原型设计规范、页面结构与流程、各页面线框描述 | +| 4、前端 | 前端规范、页面与路由、组件规格、毛玻璃与自适应、v0 融合与使用步骤、检查清单 | +| 5、接口 | 接口定义规范、API 清单、错误码与认证 | +| 6、后端 | 后端开发规范 | +| 7、数据库 | 数据库管理规范、数据设计 | +| 8、部署 | 部署方案与脚本、Next 等自动化部署流程 | +| 9、手册 | 使用手册(带图)、FAQ 详细、手册与落地方案提示词 | +| 10、项目管理 | 项目落地执行表、迭代复盘模板、前端任务细项、开发文档使用指引、前端实施记录等 | + +前端子任务按 `4、前端/前端开发流程(卡若式).md` 与组件规格、检查清单执行;改需求/架构时同步更新接口、前后端、执行表(见使用指引 § 文档联动)。 + +### 3.3 整合与清理 + +- **整合**:重复或可合并的文档并入对应目录(如多份提示词合并为一份),避免根目录散落。 +- **清理**:删除与本站无关、已废弃或已被合并的文件;保持 1~10 内文件与 README 索引一致。 + +### 3.4 验收与复盘 + +- 用 `10、项目管理/项目落地执行表` 更新任务状态。 +- 迭代结束用 `10、项目管理/迭代复盘模板.md` 写复盘(卡若复盘格式);需要时更新 `1、需求/功能迭代记录`。 + +--- + +## 四、执行顺序(卡若式) + +1. **先读**:本 Skill + `开发文档/README.md` + `1、需求` 总览 + 本任务相关目录的「使用本页时」小节。 +2. **再做**:按 §3 工作内容 调研 → 生成/更新 → 整合/清理 → 验收与复盘。 +3. **验证**:结果是否与用户命令/目标一致;不一致则回溯、搜索、再执行直至达成或明确说明无法达成。 + +--- + +## 五、与全栈开发 Skill 的关系 + +- **全栈开发**:负责官网/全站从需求到上线的整体流程,其中「开发文档」的操控规则与本 Skill 一致;全栈开发会引用 1~10 结构与本操控流程。 +- **本 Skill**:专注「开发文档」本身的维护与操作;每个网站复制一份并改路径后,即可确保该站开发文档按本能力被操作,无需每次从全栈开发里拆文档步骤。 + +--- + +*复制到新网站后:仅改「开发文档路径」→ 即可按本 Skill 操控该站开发文档。* diff --git a/04_卡火(火)/火眼_智能追问/智能追问/参考资料/卡若AI能力自我追问清单.md b/04_卡火(火)/火眼_智能追问/智能追问/参考资料/卡若AI能力自我追问清单.md new file mode 100644 index 00000000..718b563c --- /dev/null +++ b/04_卡火(火)/火眼_智能追问/智能追问/参考资料/卡若AI能力自我追问清单.md @@ -0,0 +1,125 @@ +# 卡若AI 能力自我追问清单 + +> 用「智能追问」五轮框架 + CRITIC,对卡若AI 自身全部能力做需求澄清与验收追问。 +> 依据:`SKILL_REGISTRY.md`(54 技能)、`总索引.md`、`智能追问/SKILL.md`。 +> 更新:2026-02-17 + +--- + +## 第一轮:目标澄清(Why + Who + What) + +**对象**:卡若AI 整体(5 负责人、14 成员、54 技能) + +| 序号 | 追问问题 | 选项/说明 | +|:---|:---|:---| +| 1.1 | 卡若AI 要解决的核心问题是什么? | A. 个人数字管家(信息/任务/资产一体化) / B. 多 AI 协同执行(替代单点工具) / C. 可沉淀、可复用的技能体系 / D. 其他(请说明) | +| 1.2 | 主要「用户」是谁? | A. 卡若本人 / B. 卡若 + 团队 / C. 未来对外服务 / D. 其他 | +| 1.3 | 成功的标准是什么? | A. 触发词能稳定路由到对应技能并执行 / B. 对话结束必有复盘、经验可沉淀 / C. 外网 API(kr-ai.quwanzhi.com)可被其他 AI 调用 / D. 以上都要 | +| 1.4 | 有没有对标的参考? | A. 有(请列出) / B. 没有,卡若AI 即范式 | +| 1.5 | 当前阶段? | A. 概念期 / B. 开发中(技能持续补齐) / C. 已上线迭代(日常在用) | + +**CRITIC 式深挖**: +- **C**:你说的「54 技能」具体指「能执行 54 类任务」还是「有 54 份 SKILL 文档」? +- **R**:「金→水→木→火→土」优先级一定在所有场景下成立吗? +- **I**:有数据支持「多数需求能在一轮对话内闭环」吗? + +--- + +## 第二轮:边界定义(Scope + Constraints) + +**对象**:54 技能的范围与约束 + +| 维度 | 追问问题 | 选项/说明 | +|:---|:---|:---| +| **功能边界** | 1.0 版本(当前)必须能稳定交付的能力有哪些? | 按组列:金 18+2 / 水 9 / 木 6 / 火 13 / 土 6;请勾选「必须可用」的技能。 | +| **功能排除** | 哪些能力明确不放在卡若AI 里? | A. 实时音视频 / B. 强合规审计 / C. 其他(请说明) | +| **数据边界** | 输入范围? | A. 仅文本指令 + 本机/工作台文件 / B. 含 API/第三方服务 / C. 含敏感信息(记忆/财务)需脱敏 | +| **性能边界** | 单次对话/单技能执行的预期时长? | A. <1 分钟 / B. <5 分钟 / C. 可异步,无硬性要求 | +| **兼容边界** | 需兼容的环境? | A. Cursor / B. 其他 IDE 或 API 调用方(如 kr-ai.quwanzhi.com)/ C. 仅 Cursor | +| **技术约束** | 技能实现形式? | A. 仅读 SKILL.md + 执行(无代码仓库的纯文档技能) / B. 可调用脚本、API、MCP / C. 两者均可 | + +**漏斗式追问**: +- 「你刚才提到『技能』,具体是指一份 SKILL.md 文档,还是一套可执行脚本+文档?」 +- 「金组 20 个技能里,哪些是 P0(每次对话都可能用到)?」 + +--- + +## 第三轮:异常处理(Error + Fallback) + +**对象**:技能执行失败、路由错误、外部依赖不可用 + +| 异常场景 | 追问问题 | 选项/说明 | +|:---|:---|:---| +| **路由失败** | 用户说的词没匹配到任何技能怎么办? | A. 走「通用」读总索引 / B. 明确提示「未匹配,请换说法或 @成员」 / C. 自动推荐最相关 3 个技能 | +| **SKILL 缺失** | 表里有路径但文件不存在? | A. 报错并提示路径 / B. 降级到总索引 / C. 自动从 Gitea 拉取 | +| **执行超时** | 单步执行超过 N 分钟? | A. 中断并复盘「未完成」 / B. 异步继续,通知用户 / C. 仅记录,不中断 | +| **外部 API 失败** | 如宝塔 API、阿里云 DNS、Gitea 推送失败? | A. 重试 1~3 次后报错 / B. 直接报错并给出手动步骤 / C. 写入待办,稍后重试 | +| **复盘遗漏** | 对话结束没输出复盘块? | A. 规则强制,未输出则补发 / B. 仅提醒 / C. 不强制 | +| **多技能冲突** | 同一句触发多个技能? | A. 严格按金→水→木→火→土取第一个 / B. 列出多个由用户选 / C. 合并执行(若可合并) | + +--- + +## 第四轮:测试用例(验收标准) + +**对象**:按技能或按组做「可验收」的用例 + +| 用例类型 | 场景 | 输入 | 期望输出 | +|:---|:---|:---|:---| +| **正常用例** | 用户说「帮我推送到 Gitea」 | 对话中有文件变更 | 执行自动同步脚本,并看到推送记录 | +| **正常用例** | 用户说「用智能追问帮我澄清需求」 | 任意模糊需求描述 | 按五轮输出追问问题列表或 TDD 方案 | +| **正常用例** | 用户说「外网调用卡若AI」 | POST kr-ai.quwanzhi.com/v1/chat | 返回含 reply、matched_skill、复盘块 | +| **边界用例** | 用户说「整理文件」 | 未指定路径 | 追问「要整理哪个目录?」或按默认路径 | +| **边界用例** | 触发词与多技能匹配 | 如「文档」同时命中 文档清洗、开发文档 | 按优先级只执行一个,或列出由用户选 | +| **异常用例** | 宝塔 API IP 未白名单 | 执行存客宝 API 脚本 | 明确报错「IP校验失败」并提示加白名单 | +| **异常用例** | 阿里云凭证未配置 | 执行 DNS 脚本 | 提示设置环境变量或检查 00_账号与API索引 | + +**按组抽检**: +- 金:Gitea 推送、服务器管理(端口表+部署)、存客宝 API 脚本 至少 1 个可执行闭环。 +- 水:对话归档、记忆、飞书/纪要 至少 1 个可执行闭环。 +- 木:视频切片、项目生成、开发模板 至少 1 个可执行闭环。 +- 火:全栈开发、智能追问、代码修复、本地模型 至少 1 个可执行闭环。 +- 土:商业工具集、财务管理、流量自动化 至少 1 个可执行闭环。 + +--- + +## 第五轮:确认汇总(Confirm + Output) + +**目的**:把上述追问的答案填进下表,形成「卡若AI 需求确认汇总」,便于迭代与审计。 +**来源**:2026-02-17 追问对话(用户逐条确认)。 + +| 维度 | 确认内容 | +|:---|:---| +| **核心目标** | B+C:多 AI 协同、按需调用 + 可沉淀、可复用的技能体系;卡若AI 即范式,不刻意对标。 | +| **主要用户** | 卡若本人。 | +| **成功标准** | A+B+C:触发词稳定路由并执行完;对话有复盘、经验可沉淀;外网 API 可被稳定调用。 | +| **当前阶段** | 已上线迭代,日常在用,以优化和扩展为主。 | +| **必须稳定交付** | 日常用到的 5~10 个技能(具体名单可稍后列)。 | +| **明确不做的能力** | 暂不界定。 | +| **输入边界** | 含文本指令 + 本机文件 + API/第三方服务(宝塔、阿里云、Gitea 等)。 | +| **执行时长** | 可更长或异步,不卡住对话即可。 | +| **兼容环境** | Cursor + 外网 API;设计上预留其它 IDE/机器人/网页等扩展。 | +| **技能实现形式** | 纯文档 与 脚本/接口 均可。 | +| **未匹配到技能** | 推荐 2~3 个相关技能;仍处理不了则从 GitHub/Skill/有记录的网站学习→提取核心→生成能力,可自由扩展增长。 | +| **SKILL 文件缺失** | 降级走总索引/通用流程。 | +| **执行超时** | 尽量不中断,异步继续,有结果再通知或下次补。 | +| **外部 API 失败** | 记待办 + 尽全力搜索资料库与互联网→在框架内吸收技术→循环处理直到成功。 | +| **复盘遗漏** | 规则强制补发复盘。 | +| **多技能冲突** | 尽全力自我学习及合并,不要让用户选。 | +| **验收标准** | A+B+C:每季度五组各 1 技能闭环抽检;日常 5~10 技能稳定;外网 API + 复盘格式正确。 | +| **红线** | ① 不改变卡若AI 整体结构 ② 不导致电脑无法启动 ③ 不删除重大文件。 | + +--- + +## 使用方式 + +1. **自检**:卡若AI 或维护者按五轮逐条回答,填满「确认汇总」表。 +2. **迭代前**:新增大能力或改架构前,先跑一轮第一、二轮追问,再开发。 +3. **对外说明**:把本清单 + 确认汇总 作为「卡若AI 能做什么、不做什么」的边界文档,给合作方或其它 AI 参考。 + +--- + +## 引用 + +- 追问框架来源:`04_卡火(火)/火眼_智能追问/智能追问/SKILL.md` +- 技能全集:`SKILL_REGISTRY.md` +- 架构与规则:`总索引.md`、`BOOTSTRAP.md` diff --git a/BOOTSTRAP.md b/BOOTSTRAP.md index 80e9f802..cea7c31a 100644 --- a/BOOTSTRAP.md +++ b/BOOTSTRAP.md @@ -105,11 +105,13 @@ | Pipeline 执行清单 | `运营中枢/参考资料/Pipeline执行清单.md` | 新项目上线/内容发布/日常运维 步骤与 SKILL 路径 | | 重复技能与归档说明 | `运营中枢/参考资料/重复技能与归档说明.md` | 水溪vs水桥等分工、归档目录仅历史参考 | | 外网化与外部调用 | `运营中枢/参考资料/卡若AI外网化与外部调用方案.md` | 外网/其他 AI 调用卡若AI、执行命令与链接;网关脚本:`运营中枢/scripts/karuo_ai_gateway/` | +| **异常处理与红线** | `运营中枢/参考资料/卡若AI异常处理与红线.md` | 未匹配/API 失败/多技能/复盘/SKILL 缺失 等处理方式;三条红线(结构/电脑启动/重大文件) | --- ## 七、全局规则 +0. **异常处理与红线(强制)**:执行时按 `运营中枢/参考资料/卡若AI异常处理与红线.md`。**红线**:① 不改变卡若AI 整体结构 ② 不导致电脑无法启动 ③ 不删除重大文件。 1. **禁止独立功能目录(强制)**:**不得再新建 `_共享模块` 或任何与五行、运营中枢并列的「功能目录」**。所有共享能力必须融入现有结构:代码/脚本归属到 `01_卡资(金)`~`05_卡土(土)` 对应成员下,参考资料/复盘/流程归属到 `运营中枢/参考资料/`,兼容层在 `运营中枢/` 下(如 `运营中枢/local_llm`、`运营中枢/memory`、`运营中枢/task_router`)。违反即视为结构违规。 2. **大文件**:Skill 目录下禁止 >20MB 文件,统一放 `01_卡资(金)/金仓_存储备份/大文件外置/` 3. **虚拟环境**:`.venv` 不入库,用 `requirements.txt` 重建 diff --git a/SKILL_REGISTRY.md b/SKILL_REGISTRY.md index 03471920..522decd1 100644 --- a/SKILL_REGISTRY.md +++ b/SKILL_REGISTRY.md @@ -67,7 +67,7 @@ | # | 技能 | 成员 | 触发词 | SKILL 路径 | 一句话 | |:--|:---|:---|:---|:---|:---| -| F01 | 全栈开发 | 火炬 | 知己、RAG、分销 | `04_卡火(火)/火炬_全栈消息/全栈开发/SKILL.md` | 全栈项目开发与维护 | +| F01 | 全栈开发 | 火炬 | 知己、RAG、分销、**卡若AI官网、官网开发、全站开发、开发文档、1~10** | `04_卡火(火)/火炬_全栈消息/全栈开发/SKILL.md` | 全栈项目 + 官网/全站与开发文档 1~10 调研→生成→更新 | | F02 | 消息中枢 | 火炬 | WhatsApp、Telegram | `04_卡火(火)/火炬_全栈消息/消息中枢/SKILL.md` | 多平台消息聚合 | | F03 | 读书笔记 | 火炬 | 拆解这本书、五行拆书 | `04_卡火(火)/火炬_全栈消息/读书笔记/SKILL.md` | 五行框架拆书 | | F04 | 文档清洗 | 火炬 | 文档清洗、PDF转MD | `04_卡火(火)/火炬_全栈消息/文档清洗/SKILL.md` | 批量文档格式转换 | @@ -93,10 +93,11 @@ | # | 技能 | 成员 | 触发词 | SKILL 路径 | 一句话 | |:--|:---|:---|:---|:---|:---| -| F09 | 上帝之眼 | 火炬 | 监控、上帝之眼 | `04_卡火(火)/火炬_全栈消息/上帝之眼/SKILL.md` | 全局监控与数据看板 | -| F10 | 量化交易 | 火炬 | 量化、交易 | `04_卡火(火)/火炬_全栈消息/量化交易/SKILL.md` | 量化策略与回测 | -| F11 | 对话归档 | 火炬 | 对话归档 | `04_卡火(火)/火炬_全栈消息/对话归档/SKILL.md` | 技术对话的归档 | -| F12 | 卡若日记写作 | 火种 | 日记、写日记 | `04_卡火(火)/火种_知识模型/卡若日记写作/SKILL.md` | 每日日记自动生成 | +| F09 | 开发文档操控 | 火炬 | **开发文档操控、1~10文档、网站开发文档、文档维护** | `04_卡火(火)/火炬_全栈消息/开发文档操控/SKILL.md` | 按 1~10 操控任意网站开发文档;每站可复制一份 | +| F10 | 上帝之眼 | 火炬 | 监控、上帝之眼 | `04_卡火(火)/火炬_全栈消息/上帝之眼/SKILL.md` | 全局监控与数据看板 | +| F11 | 量化交易 | 火炬 | 量化、交易 | `04_卡火(火)/火炬_全栈消息/量化交易/SKILL.md` | 量化策略与回测 | +| F12 | 对话归档 | 火炬 | 对话归档 | `04_卡火(火)/火炬_全栈消息/对话归档/SKILL.md` | 技术对话的归档 | +| F13 | 卡若日记写作 | 火种 | 日记、写日记 | `04_卡火(火)/火种_知识模型/卡若日记写作/SKILL.md` | 每日日记自动生成 | | G19 | Vercel部署 | 金盾 | Vercel、v0 | `01_卡资(金)/金盾_数据安全/Vercel与v0部署流水线/SKILL.md` | Vercel/v0 一键部署 | | G20 | 个人档案生成器 | 金盾 | 个人档案 | `01_卡资(金)/金盾_数据安全/个人档案生成器/SKILL.md` | 安全视角的个人档案 | | M06 | 前端生成 | 木果 | 前端生成、UI | `03_卡木(木)/木果_项目模板/前端生成/SKILL.md` | 快速生成前端页面 | @@ -110,6 +111,6 @@ | 金 | 卡资 | 2 | 20 | | 水 | 卡人 | 3 | 9 | | 木 | 卡木 | 3 | 6 | -| 火 | 卡火 | 4 | 12 | +| 火 | 卡火 | 4 | 13 | | 土 | 卡土 | 4 | 6 | -| **合计** | **5** | **14** | **53** | +| **合计** | **5** | **14** | **54** | diff --git a/总索引.md b/总索引.md index e50c67fb..b94d3253 100644 --- a/总索引.md +++ b/总索引.md @@ -57,6 +57,7 @@ updated: "2026-02-16" | **对外输出目录(强制)** | 报告/复盘/执行日志/导出/图片 → 只写 `/Users/karuo/Documents/卡若Ai的文件夹/` 下对应子目录;**生成图片** 默认存 `图片/` 且必登记于 `图片/图片索引.md`(来源 Skill、生成者);经验仍写 水溪/经验库。见 `运营中枢/参考资料/输出目录规范.md`。 | | 大文件 | Skill 目录禁止 >20MB,放 `01_卡资(金)/金仓_存储备份/大文件外置/` | | 虚拟环境 | `.venv` 不入库,用 `requirements.txt` 重建 | +| **异常处理与红线** | 见 `运营中枢/参考资料/卡若AI异常处理与红线.md`;未匹配→推荐 2~3 技能或学习扩展;API 失败→搜索并循环直到成功;多技能→合并不让用户选;复盘强制;红线:不改变结构/不导致无法启动/不删重大文件 | | 安全 | 删除前确认,重要数据先备份 | | 复盘 | 每次对话结束输出:目标、结果、达成率、过程、反思、总结、下一步 | | 沉淀 | 有价值的经验写入 `02_卡人(水)/水溪_整理归档/经验库/待沉淀/` | diff --git a/运营中枢/参考资料/卡若AI交互流程与强制执行条件.md b/运营中枢/参考资料/卡若AI交互流程与强制执行条件.md index 68f909c3..d535696d 100644 --- a/运营中枢/参考资料/卡若AI交互流程与强制执行条件.md +++ b/运营中枢/参考资料/卡若AI交互流程与强制执行条件.md @@ -152,16 +152,17 @@ ## 五、复盘格式(固定规则 · 每次对话结束必用) -**本条为固定规则,不再更改。** 每次对话/任务结束后,必须按以下格式做复盘: +**本条为固定规则。** 每次对话/任务结束后,必须按以下格式做复盘: -- **🎯 目标·结果·达成率**:一句简洁话;多任务时 1 2 3 列清,最多三条。 -- **📌 过程**:1 2 3 一行一条,每句简短、分行。 -- **💡 反思**:做得好的 / 可改进的,每句简短、分行。 -- **📝 总结**:结论或可复用经验,一两句、分行。 -- **▶ 下一步执行**:后续动作;若无则写「无」。 +- **日期时间**:**YYYY-MM-DD HH:mm**(年月日 + 时间)。 +- **🎯 目标·结果·达成率**:**一行**,极简;多任务仍压缩为一行或极简三行。 +- **📌 过程**:1 2 3 一行一条,每句简短;**可与 💡 反思 之间插入流程图、示意图**。 +- **💡 反思**:做得好的 / 可改进的,每句简短;**可与 📝 总结 之间插入图表/图片**。 +- **📝 总结**:结论或可复用经验,一两句。 +- **▶ 下一步执行**:**具体、有建设性的动作**;并列出本对话**未完成或待跟进的文档/任务**;无则写「无」。 - **📡 扫描**(仅涉及扫描任务时):一句摘要。 -每块带图标,每句不要太长,简洁分行。**唯一标准**:`运营中枢/参考资料/卡若复盘格式_固定规则.md`。 +每块带图标。**唯一标准**:`运营中枢/参考资料/卡若复盘格式_固定规则.md`。 --- diff --git a/运营中枢/参考资料/卡若AI异常处理与红线.md b/运营中枢/参考资料/卡若AI异常处理与红线.md new file mode 100644 index 00000000..8369eba0 --- /dev/null +++ b/运营中枢/参考资料/卡若AI异常处理与红线.md @@ -0,0 +1,37 @@ +# 卡若AI 异常处理与红线 + +> 基于 2026-02-17 追问对话确认。所有 AI 执行时必须遵守;与 `BOOTSTRAP.md`、`总索引.md` 同等强制。 + +--- + +## 一、异常处理规则(执行时必守) + +| 场景 | 处理方式 | +|:---|:---| +| **未匹配到任何技能** | 先自动推荐最相关 2~3 个技能;若仍处理不了,则从 **GitHub、现有 Skill、有记录的互联网站点** 学习 → **提取核心思路/代码** → **在卡若AI 框架合理范围内生成能力或流程** 处理问题;系统可自由扩展与增长。 | +| **SKILL 表有路径但文件不存在** | 降级:当作无该技能,改走总索引/通用流程。 | +| **单步执行超时** | 尽量不中断;允许异步继续,有结果再通知或下次对话补上。 | +| **外部 API 失败**(宝塔、阿里云、Gitea 等) | 记入待办/失败队列;**尽全力自动搜索** 资料库与互联网上的解决方案 → 在**卡若AI 框架合理范围内**吸收技术 → **循环处理直到成功**。 | +| **对话结束漏了复盘** | **规则强制**:发现未输出复盘块则补发,格式见 `卡若复盘格式_固定规则.md`。 | +| **同一句触发多个技能** | **尽全力自我学习及合并** 多技能能力,**不要让用户选**;由系统在框架内自动合并或选优执行。 | + +--- + +## 二、红线(禁止,违反即不达标) + +1. **不改变卡若AI 整体结构** + 禁止改动与 01~05、运营中枢、BOOTSTRAP、总索引 等一致的目录与架构;禁止新建与五行并列的独立功能目录(如 `_共享模块`)。 + +2. **不导致电脑无法启动** + 禁止执行会破坏系统启动、图形环境、关键系统配置的操作。 + +3. **不删除重大文件** + 禁止在未明确确认的情况下删除重要文档、配置、数据文件;删除前必须确认,重要数据先备份。 + +--- + +## 三、引用与溯源 + +- **需求确认汇总全文**:`04_卡火(火)/火眼_智能追问/智能追问/参考资料/卡若AI能力自我追问清单.md` 第五轮表。 +- **追问框架**:`04_卡火(火)/火眼_智能追问/智能追问/SKILL.md`。 +- **复盘格式**:`运营中枢/参考资料/卡若复盘格式_固定规则.md`。 diff --git a/运营中枢/参考资料/卡若复盘格式_固定规则.md b/运营中枢/参考资料/卡若复盘格式_固定规则.md index c8ce1f88..024b49d4 100644 --- a/运营中枢/参考资料/卡若复盘格式_固定规则.md +++ b/运营中枢/参考资料/卡若复盘格式_固定规则.md @@ -4,34 +4,33 @@ --- -## 格式(必填 · 纯文本 · 带图标 · 简洁分行) +## 格式(必填 · 带图标 · 简洁) -每块**一个图标 + 小标题**,内容**简洁、分行**,每句不要太长。 +每块**一个图标 + 小标题**;**目标·结果·达成率**仅一行;过程/反思之间可插入流程图或图片。 ``` -[卡若复盘](日期) +[卡若复盘](YYYY-MM-DD HH:mm) -🎯 目标 · 结果 · 达成率 -一句说完:本对话目标是什么、实际结果是什么、达成率 XX%。 -(若有多个任务,用 1 2 3 列,最多三条,每条一句。) +🎯 目标·结果·达成率 +一行说完:目标是什么、结果是什么、达成率 XX%。(多任务可 1 2 3 各一句,仍控制在一行内或极简三行。) 📌 过程 1. 第一步做了什么。(一句) 2. 第二步做了什么。(一句) 3. 第三步做了什么。(一句) -(每条简短,分行。) +(可在此块与 💡 反思 之间插入流程图、示意图等,便于看清步骤关系。) 💡 反思 -1. 第一点:做得好的或可复用的。(一句) -2. 第二点:可改进的或下次注意的。(一句) -3. 第三点:可选,结论或边界条件。(一句) -(共 1~3 点,根据本对话实际有几条写几条,**不超过 3 点**;每点简洁、可执行、不空泛。) +1. 做得好的或可复用的。(一句) +2. 可改进的或下次注意的。(一句) +3. 可选:结论或边界。(一句) +(可在此块与 📝 总结 之间插入图表/图片辅助说明。) 📝 总结 -结论或可复用经验。(一两句,分行。) +结论或可复用经验。(一两句。) ▶ 下一步执行 -后续要做的具体动作;若无则写「无」。 +具体、有建设性的后续动作;并列出本对话中**未完成或待跟进的文档/任务**;若无则写「无」。 ``` **可选(仅当本对话涉及扫描任务时写):** @@ -47,18 +46,19 @@ | 要求 | 说明 | |:---|:---| +| **日期时间** | **YYYY-MM-DD HH:mm**(年月日 + 时间,如 2026-02-17 14:30) | | **每块有图标** | 🎯 目标结果达成率 · 📌 过程 · 💡 反思 · 📝 总结 · ▶ 下一步 | -| **目标结果达成率** | 一句简洁话;多任务时 1 2 3 列清,**最多三条**。 | -| **过程** | 1 2 3 一行一条,每句简短,分行。 | -| **反思** | **1~3 点**,每点一句;做得好的 / 可改进的 / 边界或结论;简洁、可执行、不空泛;有几条写几条,不超过 3 条。 | -| **总结 / 下一步** | 每句不要太长,分行写清。 | -| **禁止** | 不用表格、不省略复盘、不写「见上文」。 | +| **目标·结果·达成率** | **一行**,极简;多任务仍压缩为一行或极简三行。 | +| **过程 / 反思** | 1 2 3 简短分行;**中间可加流程图、示意图、图片**,帮助呈现步骤或反思维度。 | +| **反思** | 1~3 点,每点一句;简洁、可执行、不空泛。 | +| **下一步执行** | **具体、有建设性**;必须包含**本对话未完成或待跟进的文档/任务**(若有);无则写「无」。 | +| **禁止** | 不省略复盘、不写「见上文」。 | --- ## 强制执行 -- **所有对话**:回复**末尾**必须带「[卡若复盘]」块,按本格式、带图标、简洁分行。 +- **所有对话**:回复**末尾**必须带「[卡若复盘]」块,按本格式、带图标;日期含**时间**(YYYY-MM-DD HH:mm);目标·结果·达成率**一行**;下一步写**具体建设性动作 + 未完成/待跟进文档或任务**。 - **唯一标准**:本文件;规则与交互流程均引用本文件。 --- diff --git a/运营中枢/工作台/gitea_push_log.md b/运营中枢/工作台/gitea_push_log.md index 815c30de..28318c19 100644 --- a/运营中枢/工作台/gitea_push_log.md +++ b/运营中枢/工作台/gitea_push_log.md @@ -20,3 +20,4 @@ | 2026-02-16 13:42:04 | 🔄 卡若AI 同步 2026-02-16 13:40 | 变更 1362 个文件 | 排除 >20MB: 4 个 | | 2026-02-17 15:53:01 | 🔄 卡若AI 同步 2026-02-17 15:40 | 变更 17 个文件 | 排除 >20MB: 4 个 | | 2026-02-17 18:35:41 | 🔄 卡若AI 同步 2026-02-17 18:35 | 变更 8 个文件 | 排除 >20MB: 4 个 | +| 2026-02-17 23:20:32 | 🔄 卡若AI 同步 2026-02-17 23:19 | 更新:Cursor规则、GitHub Actions、总索引与入口、金仓Gitea脚本与配置、金仓、水桥平台对接、水溪整理归档、卡木、火炬、水泉规划拆解等 | 排除 >20MB: 5 个 | diff --git a/运营中枢/工作台/代码管理.md b/运营中枢/工作台/代码管理.md index 8478981b..8c94f16e 100644 --- a/运营中枢/工作台/代码管理.md +++ b/运营中枢/工作台/代码管理.md @@ -23,3 +23,4 @@ | 2026-02-16 13:42:04 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-16 13:40 | 变更 1362 个文件 | 排除 >20MB: 4 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-02-17 15:53:01 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-17 15:40 | 变更 17 个文件 | 排除 >20MB: 4 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | | 2026-02-17 18:35:41 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-17 18:35 | 变更 8 个文件 | 排除 >20MB: 4 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) | +| 2026-02-17 23:20:32 | 成功 | 成功 | 🔄 卡若AI 同步 2026-02-17 23:19 | 更新:Cursor规则、GitHub Actions、总索引与入口、金仓Gitea脚本与配置、金仓、水桥平台对接、水溪整理归档、卡木、火炬、水泉规划拆解等 | 排除 >20MB: 5 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |