2026-08-20 · pawchibi-foundation 底座详细蓝图 · 施工前设计稿 · 待 Austin 拍板

🧰 PawChibi · 底座 Foundation 详细蓝图

底座 = pawchibi-foundation 这一个 Plugin(5 个 Skill + 中央知识库 + 经验池管道 + 给后续所有插件的公共标准件)。它不直接干业务,它让「干业务的一切」有规则可依、有经验可攒、坏了能自修。本蓝图基于领途/J&J 两套底座的真实源码逐条对照写成,每个设计都有实物依据。

SECTION 1

底座是什么 —— 一张图说清位置

🧰 底座 foundation规则怎么到每个人 · 经验怎么流回来 · 环境坏了怎么修
➜ 托着 ➜
🏪 store独立站+SEO
📦 orders订单+客服+邮箱
📣 social社媒+社群
🗂 lark / 📈 insight / 🔁 evolve后续各期
5Skill
5知识分区(P1 先建 4 个)
1新建 Lark 表(经验池)
12硬性限制条款
2P1 使用者(你+陈超)
一句人话:底座装好之后,团队任何一台电脑上的 Claude 都变成「懂 PawChibi 规矩的 Claude」——说一句口令完成配置,开工自动用最新规则,踩了坑自动变成经验卡流回你手里,出了错自己会体检自己修。后面每一个业务插件(订单、改站、社媒)都站在它上面,不用各自重复造这些机制。

SECTION 2

底座解决的五个真问题 —— 每个都对着一个已经发生过的痛

1规则散在四处,没有唯一权威

现状:品牌红线、商业口径、SOP 分散在项目 CLAUDE.md、55 条记忆、9 份手册、基础设施台账四处,互相之间已出现过矛盾(AI 口径新旧两版并存过)。底座的解法:中央知识库(5 个分区文件 + 版本号),所有 Skill 运行时只认它,「不得凭记忆编规则」写进标准件。

2上一轮插件的死因:复制件不同步

现状:插件仓 README 里白纸黑字记着上轮教训——插件里复制了一份规则文档,与权威源不同步,全部过期作废。底座的解法:不是「插件不带知识」,而是把权威源本身迁进插件仓——知识库只有一份,就在插件里,项目 CLAUDE.md 瘦身成指针。改一处,git 推送,全队自动更新。这正是 J&J 跑了一年的模式(规则源=仓库中央知识库)。

3经验散落各会话,没有管道

现状:你现在多个对话框并行干活(视频文案、素材上传……),每个会话踩的坑、磨出的套路都散在各自的记忆里,没有统一收集口。底座的解法:「经验记一笔」常驻规则 + Lark 经验池表 + 你周审烘焙。这就是「先攒经验再搭 Skill」策略的容器本体——底座先立,后面每块业务手工跑的经验都能沉淀成料。

4成员环境没人管,配置靠口口相传

现状:陈超上手要配什么、凭证放哪、坏了找谁——目前全靠问你。底座的解法:一键配置(幂等可重跑)+ 环境体检(七项自检,报「哪坏了+怎么修」)+ 上手罗盘(暗号表)。成员报错先跑体检,不再堵在你这。

5插件系统本身也会坏,坏了还是静默的

现状(J&J 真实事故):插件缓存目录被手工改名 → 索引失效 → 插件连同全部 Skill 从界面上无声消失,六项常规检查没有一项能发现。底座的解法:照抄 J&J 事故后写的防呆脚本(目录名一律从索引文件读出、代码里不存在「决定目录名」这个动作)+ 体检里加「插件加载完整性」专项。别人用血换的补丁,我们第一天就带上。

SECTION 3

架构与文件结构

运行时链路:一次会话里发生什么

成员说口令「PawChibi 开工 / 同步 / 体检…」
版本自查插件版 vs 运行时版对一眼,落后先提示同步
读知识库干活规则只认 knowledge/ 分区文件,不凭记忆编
经验捕捉纠偏/踩坑/好范例 → 攒成卡,成员过目后入池
为什么要「运行时固定路径」这个设计(关键机制):Claude 的插件装在一个随版本号变化的缓存目录里,直接在那里面读写,插件一更新路径就变、东西就丢。所以照抄 J&J:装配置时把知识库/脚本/模板整体拷到一个固定不变的目录~/.config/pawchibi/),日常一切读写都对着固定路径;插件更新后说一句「同步」就把新内容刷进去。凭证也放这里——永不放进插件、永不进 git

插件仓文件结构(pawchibi-plugins 私有仓,已建好的空市场)

pawchibi-plugins/
├── .claude-plugin/marketplace.json     ← 市场清单(把 pawchibi-foundation 登记进去)
└── pawchibi-foundation/
    ├── .claude-plugin/plugin.json      ← 插件名 + 版本号(每次烘焙 +1)
    ├── knowledge/                      ← ⭐ 中央知识库(全体系的规则唯一源)
    │   ├── version.json                ← 总版本 + 各分区版本 + 每次改动写清改了什么
    │   ├── 01-品牌红线.md               ← 红线与措辞(只有 Austin 下令才能改)
    │   ├── 02-商业口径.md               ← 价格/运费/交期/退款/折扣,全部数字在这
    │   ├── 03-订单SOP.md               ← 审照标准/T链时序/售后四类判定
    │   ├── 04-通道地图.md               ← 哪件事走哪条路 + 验证铁律 + 已踩的坑
    │   └── 05-经验池·本机兜底.md         ← Lark 不通时经验卡的临时落点
    ├── skills/
    │   ├── 01-setup-配置/SKILL.md
    │   ├── 02-sync-同步/SKILL.md
    │   ├── 03-health-体检/SKILL.md
    │   ├── 04-log-记一笔/SKILL.md
    │   └── 05-start-上手罗盘/SKILL.md
    ├── scripts/
    │   └── pc-sync-cache.sh            ← 插件缓存防呆脚本(照抄 J&J 事故补丁)
    └── templates/
        ├── skill-standard-blocks.md    ← 标准件:后续所有 pawchibi-* Skill 末尾附带的公共规则
        └── report-shell.html           ← 报告统一外壳(品牌色 + 手机适配)

社媒规范分区(原蓝图里的第五份 social-guide)P3 做社媒插件时再建——空分区不建,遵守 MVP 规矩。

SECTION 4

五个 Skill 详解

01-setup 一键配置 全员

口令
「PawChibi 配置 / PawChibi 初始化」
做什么
装好插件后的第一步:①把知识库/脚本/模板落到固定目录 ②凭证单机注入(见下)③把默认行为写进本机记忆(中文回复、报告规范、红线常开、经验自动捕捉)④冒烟自检报版本号
凭证机制
凭证永不随插件走。你的机器:现有三份凭证原样不动,配置只确认它们在。成员机器:缺什么凭证 → 提示「找 Austin 通过 Lark 私聊要」→ AI 负责写入固定目录并收紧权限。成员侧 P1 需要哪些凭证是待拍板题(见 §11 Q2,有一个我们原来没想到的安全问题)
防呆
全程幂等(重跑=刷新为最新,不会重复不会坏);护卡——覆盖知识库前先把本机没上报的经验卡抽出来保住,刷完再放回去;禁止编造成功,失败如实报

02-sync 知识库同步 全员

口令
「PawChibi 同步」(开工前习惯性说一句,10 秒级)
做什么
把市场自动更新到本机的最新插件内容刷进固定目录,报告版本变化(哪个分区变了、改了什么)
三道防呆
内容校验不只看版本号——版本相同也逐文件比对内容,「01-品牌红线」内容不一致=红色阻塞,先修再干活(红线是唯一错一次就出事故的分区)②护卡同上 ③缓存自检——跑防呆脚本查插件索引是否脱链,脱链=插件会无声消失,当场报修
铁律
🔴 禁手工模仿同步链:任何「刷新本机插件」的需求必须走本技能,禁止用手工命令自己拼一条——手工模仿=绕过全部防呆(J&J 真实事故:手工改缓存目录名,一个插件连同技能全部消失)

03-health 环境体检 全员

口令
「PawChibi 体检」(成员遇到任何报错,先跑它,不用来问你)
检查七项
①知识库版本+内容完整性 ②凭证存在与权限(绝不回显内容)③Lark 通道(真实调用验证,不只看配置)④Shopify 通道(你的机器:换令牌冒烟;成员机器:跳过并标注「写站走移交卡」)⑤经验池表可达 ⑥插件加载完整性(防无声消失)⑦本机残卡盘点(有没有没传上去的经验卡)
输出
逐项 ✅/⚠️/✗,任何 ✗ 必配一句具体修复动作;总判三档:🟢 全绿可开工 / 🟡 可开工但注意 / 🔴 先修再开工
性质
只读不改,随时可跑

04-log 经验记一笔 全员 · 常驻行为规则

性质
不是要主动喊的命令,是一条一直开着的行为规则——AI 在所有 PawChibi 会话里持续留意,该记的自动攒卡;成员也可以主动说「记一笔」
记什么·三类
纠偏类:「以后都要…/别再…/这个规则该改成…」这种对以后所有同类情况的纠偏 ② 踩坑类:报错折腾几个来回才解决、换个人大概率还踩、不查记录想不起来的 ③ 范例类:被明确验证「这样做特别好」的产出——落成金标准样板,不只从失败学(J&J 2026-08-20 新增,我们第一天就带上)
不记什么
一次性调整、个人偏好、闲聊、显而易见的小错、仅本机的环境问题。拿不准就问一句:「这条是以后都这样,还是只这一次?」
流程
攒卡 → 先给当事人过目(留/改/删) → 认可后写入 Lark 经验池表(状态=待审)→ Lark 不通才落本机兜底文件、下次同步时补传 → 会话末一句话「已记 N 条提案」
两条铁律
🔴 上报绝不直接改规则——只有你周审烘焙后才落地;🔴 先查再踩——反过来,遇到报错先查经验池有没有同款,有就用旧解法,不重新趟一遍

05-start 上手罗盘 全员

口令
「PawChibi 上手 / 从哪开始 / PawChibi 怎么用」
做什么
一页暗号表:想干什么 → 说哪句口令 → 哪个 Skill 接 → 前提是什么;新人装机顺序(配置→体检→开工);卡住了找谁。只指路不干活
维护负担
技能名/口令写死在这份文件里,后续每期新插件上线都要回来同步它——这条写进每期施工的收尾清单(领途的罗盘文件里就带着这条维护提醒,照抄)

SECTION 5

中央知识库设计 —— 底座里最重要的东西

核心设计决策(需要你点头,这是本蓝图最大的一个动作):把「规则的唯一权威」从项目 CLAUDE.md 迁进插件仓的 knowledge/。迁移后项目 CLAUDE.md 瘦身为:指向知识库的指针 + 只属于你我协作的内容(会话流程、你的沟通偏好、凭证位置)。为什么必须迁:上轮插件死因就是「权威在外面、插件里放复制件」——两处必然漂移。成员机器上只有插件、没有你的项目文件,所以权威必须住在插件里,才能做到「改一处全队生效」。J&J 一年、十六次周审烘焙验证了这个模式。

五个分区 + 内容从哪迁来

分区装什么内容来源(迁移对照)改动权限
01-品牌红线四条品牌红线(只做宠物/产地不提/不露脸/Q版神似)、措辞规则(artisans/we/手工词降级)、尺寸纯英寸、AI 坦诚口径、红线词表(出稿即扫的机器检查清单)项目 CLAUDE.md「品牌红线」段 + 手册 05 品牌全案 + 记忆 pawchibi-brand-tone-final🔴 只有你下令才能改,经验卡提案也不行——写死在周审规则里
02-商业口径价格/变体、运费 $19.99、交期口径(制作 2 周+运输 15 天=到手约 4 周)、退款重做规则、照片 3 必传、折扣四套、社群口径、效果图 3+3 超时规则项目 CLAUDE.md「商业口径」段 + 手册 02/03/06你拍板改;改完触发「全站口径同步」提醒
03-订单SOP订单 7 步、审照标准、T1–T7 每封谁发/何时发/模板要点、售后四类判定、邮箱标签接力体系(C7 搭好的那套)手册 01/03 + C7 试单实录 + 记忆 pawchibi-email-template-format你拍板改(周审是主要入口)
04-通道地图哪件事走哪条路(API 优先/浏览器只补空白)、验证铁律(禁 curl 验前台/禁 curl 判像素/写后 sleep 8 再读回)、Lark 写中文禁转义、主题改动先备份、草稿主题纪律、已踩坑速查表项目 CLAUDE.md「硬经验」段 + 手册 09 AI 施工手册 + 各 playbook 记忆你拍板改(踩坑类经验卡的主要落点)
05-社媒规范P3 再建各平台调性/规格、纪念内容分寸感、发布包格式记忆 pawchibi-social-copy-format + 增长方案总纲同上

版本机制(照抄 J&J,逐字有实物)

version.json

总版本号 + 每个分区各自的版本号 + notes 字段写清这一版改了什么、依据哪张经验卡。J&J 的这个文件已经记到 v1.20.0、十六次周审,每一版都能查到为什么改——这就是规则的「病历本」。

改动只有一条路

你拍板(周审或直令)→ 改 knowledge 分区文件 → version.json 版本+1 并写 notes → git 提交推送 → 团队市场自动更新 → 成员说「同步」刷进本机。没有第二条改规则的路。

与 9 份手册、与记忆库的关系

手册=给人看的版本,knowledge 变更后按对照表同步改(P4 起改为自动生成,「改两处」彻底消灭;在那之前靠周审收尾清单硬提醒)。记忆库=AI 的私人笔记本(会话历史、项目状态),规则一律不再往记忆里写——已在记忆里的规则条目,迁移时并进 knowledge 后在原记忆上标注「已迁」。

SECTION 6

经验池管道 —— 系统怎么越用越聪明

闭环全图

① 干活中任何会话里踩坑/纠偏/好范例
② 攒卡AI 总结成卡,当事人留/改/删
③ 入池写 Lark 经验池表,状态=待审
④ 周审你按根因聚类逐条裁决(evolve P4 上线前:你说一声「盘经验」我人工跑同流程)
⑤ 落地采纳的改 knowledge,版本+1,git 推送
⑥ 回流市场自动更新→成员「同步」→全队用新规则
关键性质:③→④ 之间有闸——入池不等于改规则,池子只进提案,落地只经你手。红线分区(01)连提案都改不动。这保证系统「越用越像你」而不是「越用越野」。

Lark 经验池表(本蓝图唯一新建的表,建在现有中台 Base)

字段类型说明
卡片标题主字段·文本一句话说清这条经验
类型单选纠偏 / 踩坑 / 范例
现象文本当时看到什么(报错原文/被纠正的原话/好在哪的实证)
根因文本真正原因,不是表象
建议规则文本「下次先做什么就能绕开」或「以后同类都可以这样做」的样板句
提出人 / 日期单选 / 日期提出人用单选(Austin/陈超/Aria/Sophia)——刻意不用人员字段,绕开「Bot 通讯录看不到成员」的已知坑
状态单选待审 → 已采纳 / 驳回 / 搁置
裁决日期 / 落点日期 / 文本采纳后落进了哪个分区哪一段,可回溯

回答「新表必须指定哪道工序被迫读它」(J&J 周审立的规矩,防表建了没人读烂掉):读它的工序有两道——①04-log 的「先查再踩」每次遇报错先查它 ②你的周审逐卡读它。写它的是 04-log。闭环成立,表才准建。

SECTION 7

硬性限制与条件清单 —— 12 条,每条都有出处

#限制出处(哪个教训)
1凭证永不进插件、永不进 git、永不进对话记录以外的文件;成员机凭证=单机注入(Lark 私聊找你要,AI 负责写入本机并收紧权限)J&J 旧模式曾把明文钥匙随插件分发并留进 git 历史,2026-08-16 废止重立
2口令一律带「PawChibi」前缀(PawChibi 配置/同步/体检);纯说「体检/同步」且上下文是领途或 J&J 的,不抢三套插件体系同装在你和成员机器上,触发词撞车是现实问题;领途/J&J 的技能描述里都写了防抢条款
3教操作一律用桌面版图形界面路径;不出现终端命令式指引(除非明确标注给会用终端的人)全员用桌面版 Claude,2026-08-17 你两次纠正后立的全局约定
4禁手工模仿同步链;插件缓存目录名不可手改(目录名只从索引文件读)J&J 2026-07-24 事故:手改目录名,插件无声消失
5写 Lark 中文字段直接输实际汉字,禁转义手打;写后逐字读回核对J&J 同根因复发八次、错字全是合法汉字不报错,最后上了机械闸——我们的 Lark 通道从第一天就带这条
6新建任何 Lark 表/字段,必须同时答出「哪道工序开工时被迫读它」,答不上不建J&J 三张表同病实证:有人写没人读的表一定烂掉,且失效是静默的
7经验卡先经当事人审核再入池;入池绝不直接改规则;红线分区只有你下令才能动J&J/领途周审制度核心;防系统「越用越野」
8AI 四不做:不代发(邮件/消息/帖子)、不代记账、不擅自改线上、不碰广告的钱Lark 自动化记账翻车实证 + 全蓝图既定红线
9危险命令护栏:不可逆删除/改写历史/批量删数据/一次改写 10+ 文件,先摆影响范围等点头;判据从宽全局既定 + J&J 横切护栏四条之一
10版本卫生:改规则/文档直接覆盖成干净最终版,不留 v1/v2/_old;同链接覆盖重发全局既定铁律
11诚实汇报:失败/跳过如实说,禁编造成功;工具报错先怀疑本机运行时旧,再怀疑源码有 bug——先「同步」再试,能省一张废卡J&J 实证:报错被当成源码 bug 记卡,查明纯因本机脚本落后
12检查类脚本必须双向验证才算交付(真实正例防误报 + 人造负例验真能抓到);「扫到 0 个」默认报错不静默放行J&J 实证:检查脚本坏了不报错、只给假保证,比没有更危险

SECTION 8

标准件 —— 底座交付物里最容易被低估的一个

一份 skill-standard-blocks.md从 P2 起,每个新写的 pawchibi-* Skill 末尾都附带这段公共规则,保证横切纪律不用在每个技能里重新发明、也不会哪个技能漏掉。内容九条:

运行纪律(4 条)

① 版本自查开工先行 ② 规则源唯一=knowledge/,不凭记忆编规则;与成员当场定的输出格式规则冲突时,以成员规则为准并记一笔上报 ③ 中文交互;英文产出配中文语境参考 ④ 链接=裸网址独立成行(Markdown 链接部分客户端不渲染、紧跟标点会吞字符——J&J 实证后统一)

安全纪律(3 条)

⑤ 危险命令护栏 ⑥ AI 四不做(不代发/不代记账/不擅改线上/不碰广告钱)⑦ 改站四闸:备份→摆改前改后等批准→改后配图→追问动了哪份手册(PawChibi 特有,写死在标准件里让后续 store/orders 插件天然继承)

闭环纪律(2 条)

⑧ 经验自动捕捉常开,会话末报「已记 N 条」 ⑨ 诚实汇报 + 报错先怀疑环境 + 提示成员可跑「PawChibi 体检」

SECTION 9

原来没想到、这轮梳理出来的部分

⚠️ 成员的 Lark 凭证会连带打开凭证表(安全问题,必须你拍板)

成员要写经验池,就要 Lark Bot 的钥匙。但 Bot 的权限是整个 Base 级的——拿到钥匙就能读中台 16 张表的全部,包括「账号与凭证」「API Key」两张明文密码表(你 8-11 拍板凭证维持明文)。也就是说:给陈超发 Lark 凭证 ≈ 陈超机器上的 AI 能读到全部密码。三个选项见 §11 Q2——这是我对照 J&J 才发现的差异:J&J 的 Base 里没有凭证表,所以他们发钥匙没这个问题,我们有。

成员沙箱的坑其实分两种(修正主蓝图的一句话)

主蓝图写过「成员插件一律走远程通道」——对照实物后要修正:那条教训针对的是网页版云沙箱(禁出网,本地组件必死)。我们团队全用桌面版,桌面版本地组件能正常联网(J&J/领途成员一直这么跑)。所以 P1 成员走 J&J 同款「本地组件+单机凭证」即可;远程保险箱仍然是 P5「成员写 Shopify」的方案,不用提前。

Windows 成员适配

J&J 真机验证过:Windows 上权限收紧命令是另一套、桌面版没有命令行工具要直写配置文件、写文件要防编码坑。这些分支 J&J 的 SKILL.md 里全写好了,照抄零成本。待确认:陈超/Aria/Sophia 用的是 Mac 还是 Windows——是 Windows 就把分支带上,全 Mac 就砍掉少维护。

「盘经验”在 evolve 上线前的过渡方案

底座 P1 就开始收经验卡,但周审烘焙技能在 P4。空窗期不能让池子只进不出:过渡=你随时说一声「盘一下经验」,我人工跑同一套流程(聚类呈审→你裁决→我改 knowledge→推送)。流程先跑人肉版,P4 只是把它固化成技能。

发布口令与仓库表

你现有的「一键发布插件」技能管着几个插件源码仓的发版。pawchibi-plugins 仓要不要纳入它的仓库表、发布口令叫什么(建议:「发布 PawChibi」)——P1 建仓时顺手登记,别忘。

知识迁移时的「旧址清理」

把规则从 CLAUDE.md/记忆迁进 knowledge 后,旧址必须当场处理(CLAUDE.md 对应段落改成指针、记忆条目标注已迁)——否则新旧两份并存,第一天就复刻上轮死因。迁移清单做成表格逐项勾,不凭印象。

SECTION 10

验收标准 —— 什么叫「底座建成了」

#验收项怎么验
1插件可装可见组织市场里能看到 pawchibi-foundation;你和陈超的桌面版里 5 个 Skill 全部出现
2一键配置真跑通陈超机器上说「PawChibi 配置」→ 全程不需要你远程指导 → 结尾报版本号
3体检全绿两台机器各跑「PawChibi 体检」→ 🟢;再人为弄坏一项(如临时改名一个知识文件)→ 体检能抓到并给出正确修复动作(检查项双向验证,限制 #12)
4知识闭环走一遍真的你改一条口径 → 版本+1 → 推送 → 陈超机器「同步」→ 他那边 AI 引用的是新口径
5经验闭环走一遍真的陈超会话里造一条纠偏 → 卡入池待审 → 你裁决采纳 → knowledge 落地 → 回写状态
6规则唯一源成立CLAUDE.md 已瘦身成指针;迁移清单逐项勾完,旧址零残留
7防抢不误伤同一台机器上说「JJ 体检」「领途体检」各自正确触发,说「PawChibi 体检」触发我们的——三套共存无串扰

SECTION 11

施工顺序(半天粒度)与拍板题

做什么
1知识迁移:按 §5 对照表把四处的规则合并成 4 个分区文件 + version.json;旧址清理清单逐项勾 → 给你过目一轮(知识库内容=规则本身,必须你验收)约 1 天,最重的一步
2五个 SKILL.md + 标准件 + 防呆脚本(以 J&J 为模板改写)半天
3Lark 经验池表建表 + 04-log 打通写入读回半天
4市场登记 + 你的机器装机验收 → 陈超装机验收(§10 逐项过)半天 + 等陈超时间

待你拍板的 4 题

Q1 · 权威源迁移

认不认「规则唯一权威从 CLAUDE.md 迁进插件 knowledge/、CLAUDE.md 瘦身为指针」这个核心决策?(§5 红色框,全蓝图最大的一个动作)

Q2 · 成员 Lark 凭证怎么给(安全题)

三选一:A 直接发现有 Bot 钥匙(最简单;代价=成员 AI 能读中台里两张明文密码表);B 先把凭证两表搬出中台 Base 再发钥匙(多半天活,根治);C P1 成员先零 Lark 凭证——经验卡落他本机兜底,你端同步时代为入池(最稳but多一道手工)。我的建议:C 起步,P2 做邮箱管家(反正要动 Lark 权限)时一并升到 B

Q3 · 陈超的机器

Mac 还是 Windows?什么时候方便装机验收?(决定要不要带 Windows 分支、步骤 4 的排期)

Q4 · 口令确认

「PawChibi 配置 / 同步 / 体检 / 上手」这套口令顺不顺口?要不要换个更好念的前缀(比如「爪爪」)?口令定了就进罗盘,后面全团队都用它。


依据:jj-foundation 五个 SKILL.md 与防呆脚本逐条对照(v1.9.0 / 知识库 v1.20.0,十六次周审沉淀)· leadpath-foundation 结构与上手罗盘 · pawchibi-plugins 仓 README 的上轮死因记录 · 8-13 配置基线 · Lark 中台 16 表现状(凭证表风险由此查出)。本报告同链接覆盖更新。