JavaScript | MDN

TypeScript | JavaScript With Syntax For Types

课程说明 本文是 《Vue3.5 + Electron + 大模型跨平台实战》 的课程学习笔记，用于记录学习进度、核心知识点、错题与阶段复盘。

课程说明 本文是 《2 周刷完 100 道前端优质面试真题》 的课程学习笔记，用于记录学习进度、核心知识点、错题与阶段复盘。

合并 PR 时本想选 Squash，却误点了 Merge，主分支上多出一个合并提交和一串零碎的中间提交。本文记录如何把这次 merge 改造成 squash 效果。

@vaultkit/vitepress-plugin-plausible 为 VitePress 注入隐私优先的 Plausible 统计脚本。与姊妹包 @vaultkit/vitepress-plugin-umami 同款机制：纯构建期函数，把配置转换成一条 head 内联脚本条目，塞进 head 数组即可。

@vaultkit/vitepress-plugin-umami 为 VitePress 注入隐私优先的 Umami 统计脚本。它不是运行时组件，而是一个纯构建期函数：把 Umami 配置转换成一条 head 内联脚本条目，塞进 VitePress 的 head 数组即可。

@vaultkit/vitepress-plugin-og-image 在 VitePress buildEnd 钩子里为每个页面生成一张 Open Graph 分享图（1200 × 630 PNG）。管线是 satori（元素树 → SVG，纯计算）+ resvg（SVG → PNG），全程无浏览器——CI 里不需要…

本文逐项测试 Obsidian Callouts 的全部语法形态，与 Obsidian 官方帮助页对齐。

本文包含本站支持的全部书写语法：标准 Markdown、VitePress 扩展、Obsidian 专属语法，可作为写作速查（本文自身的 frontmatter 也演示了上方的属性面板）。

@vaultkit/vitepress-plugin-robots 是一个零配置的 robots.txt 生成器，在 VitePress buildEnd 钩子里调用：hostname 自动取自内置 sitemap 配置，缺省产出「全放行 + Sitemap: 指令」，需要时再用 rules 精细控制各家爬虫——包括屏…

@vaultkit/vitepress-plugin-llms 是一个在 VitePress buildEnd 钩子里调用的 llms.txt / llms-full.txt 生成器，遵循 llmstxt.org 约定：前者是给 LLM 看的站点索引（标题 + 摘要 + 链接），后者是全文汇编，AI 助手一次抓取就能把…

@vaultkit/vitepress-plugin-feed 是一个在 VitePress buildEnd 钩子里调用的 RSS + JSON Feed 生成器：一次调用同时产出 feed.xml（RSS 2.0）与 feed.json（JSON Feed 1.1），频道元数据全部从 site 配置与 sitema…

@vaultkit/repo-platform-kit 是代码托管平台（GitHub / CNB）的统一取数内核：URL 解析、raw 内容与仓库元数据的请求构造、认证策略、带韧性的 TTL 磁盘缓存、平台徽标常量，全部收敛在一个零依赖的 Node 库里。它本身不依赖 VitePress，是 repo-card、rem…

@vaultkit/vitepress-plugin-remote-file 提供 ::: remote-file 容器：构建期抓取 GitHub / CNB 仓库中的文件内容直接嵌入文章，免复制粘贴，随每次部署自动同步。嵌入产物带出处 chrome（平台徽标 + 可点路径链接 + ref / 行号徽标），代码本体走站…

@vaultkit/vitepress-plugin-npm-card 提供 ::: npm-card 容器：写包介绍、教程文章时一行嵌入 npm 包信息卡——版本、描述、周下载、解包体积、运行时依赖数、license、TS 类型徽标、keywords 一卡集齐。构建期从 npm registry 抓取元数据渲染为静态…

@vaultkit/vitepress-plugin-repo-card 提供 ::: repo-card 容器：构建期抓取 GitHub / CNB 仓库元数据（名称、描述、语言、星叉、topics），渲染为静态卡片，零客户端 JS。动画全部 CSS——悬停浮起 + 品牌描边，lg 档另有光泽扫过，prefers-r…

@vaultkit/vitepress-plugin-code-playground 一个包提供两个容器：::: codepen 与 ::: stackblitz，分别对齐 CodePen Embed Builder 与 StackBlitz Embed URL options 官方文档，在 Markdown 里一行嵌…

@vaultkit/vitepress-plugin-web-frame 为 VitePress / markdown-it 提供 ::: web-frame 容器，把任意网页（或任意 Markdown 内容）装进一个「浏览器窗口」视觉里：三色圆点栏 + 圆角边框 + 柔和阴影，颜色取 VitePress --vp-c…

@vaultkit/vitepress-plugin-bilibili 为 VitePress / markdown-it 提供 ::: bilibili 容器，一行 Markdown 嵌入哔哩哔哩官方外链播放器（player.bilibili.com）。它基于 markdown-it-container 在构建期直接…

@vaultkit/vitepress-plugin-donate 是文章尾部赞赏卡 Vue 组件：支付宝 / 微信收款码页签切换 + PayPal 外链，三渠道按配置门控——配了什么就显示什么，全缺时整卡消失，宿主连 v-if 都不用包。交互是居中的「赞赏」按钮点击展开面板（非模态），SSR 首帧收起态一致、无水合差…

@vaultkit/vitepress-plugin-copyright 是文章版权声明卡 Vue 组件，挂在正文之后——那是「转载须知」的标准位。卡片三行信息一目了然：文章标题 + 规范链接（带一键复制）、作者（可链到关于页）、许可协议（可链到协议原文），另可选一句转载须知整句。滚到本页末尾就能看到它的现场效果——本…

@vaultkit/vitepress-plugin-giscus 是 giscus（基于 GitHub Discussions 的评论系统）的轻量 Vue 集成。它不引官方的 @giscus/vue——那层 web component 封装对这里的场景是纯开销——而是直接注入 giscus 官方 client.js，…

@vaultkit/vitepress-plugin-reading-time 为 VitePress 提供阅读时长统计，架构是「一包两半」：构建期的 markdown-it 插件负责计数并写入 frontmatter，/client 子路径的可选 Vue 组件负责展示。核心卖点是中英分轨计数——中文语料按空格分词会把…

@vaultkit/vitepress-plugin-scroll-navigator 是右下角「回顶部 / 到底部」浮钮组 Vue 组件。它解决的是长文导航的两个高频动作：读完想回顶部看目录、想直接跳到文末的评论区。往下滚动本页，右下角出现的那对圆形浮钮就是它的现场演示——本站开箱内置。

@vaultkit/vitepress-plugin-reading-progress 是一个页面顶部阅读进度条 Vue 组件：随滚动从左到右填充，让读者对「还剩多少」有直觉感知。零依赖、零配置即可用——现在就往下滚动本页，注意浏览器窗口最顶端那条与主题品牌色同色的细线，它就是本组件的现场演示。

@vaultkit/vitepress-plugin-image-preview 是一个零运行时依赖的 VitePress 全屏图片查看器：点击正文图片即打开灯箱，支持滚轮缩放、1:1 复位、旋转、拖拽平移、同页画廊切换与下载，交互语义对齐 Element Plus Image Viewer。你现在就可以点击本站任意文…

GitHub 个人主页那张绿格子贡献图，大概是开发者世界里最有辨识度的信息图。把同款语义搬到博客归档页——每个格子是一天，颜色深浅是当天发文量——写作节奏一眼可见。@vaultkit/vitepress-plugin-contribution-graph 就是这么一个组件：零依赖、纯 CSS Grid、SSR 安全，数…

词云是标签页与归档页的经典一图流：词频权重一眼可读，还顺手当导航用。但大多数词云组件有个恼人的通病——每次刷新都洗牌，昨天在左上角的标签今天跑到右下角。@vaultkit/vitepress-plugin-word-cloud 用一个种子随机数生成器根治了这个问题：同一份词集，布局永远恒定。本站首页侧栏的「标签」词云就…

VitePress 默认的右侧大纲够用但寡淡：一根竖线加一段高亮。Nuxt UI 的 ContentToc 有个漂亮得多的 highlightVariant: circuit 变体——目录左侧是一条随缩进弯折的「电路板走线」，高亮段像电流一样随滚动在走线上流动。@vaultkit/vitepress-plugin-co…

双链笔记发布成网站后，最让人怀念的往往是 Obsidian 那张关系图谱。@vaultkit/vitepress-plugin-local-graph 把 Obsidian Publish 风格的 Interactive Graph 带进 VitePress：d3-force 力导向布局 + SVG 自渲染，节点半径随…

长文章的结构，目录列表看得见层级、看不见形状。@vaultkit/vitepress-plugin-mindmap 把 VitePress 已渲染文章的标题层级一键变成可交互的思维导图：横向树状铺开、分支按深度着色、圆点折叠展开、点标题跳回正文——本站每篇文章侧栏的「思维导图」页签就是它，现场即可体验。

在 Obsidian 里画的白板（.canvas 文件，即开放格式 JSON Canvas），能不能像一张图片一样直接嵌进已发布的文章里？@vaultkit/vitepress-plugin-obsidian-canvas 的答案是：能，而且是构建期一次成型、客户端零运行时的静态嵌入——节点、连线、箭头、标签、颜色全部…

技术博客写多了就会发现，光有正文和代码块不够用：推荐阅读要卡片、重点提示要色块、安装教程要步骤列表、长配置文件要能折叠。Nuxt 官方文档的 Prose 组件把这套排版语言打磨得很成熟，@vaultkit/vitepress-plugin-nuxt-typography 把它带进 VitePress：五种容器（card…

Callouts 是 Obsidian 里最常用的排版元素——一个 > 就能把提示、警告、示例从正文里凸显出来。但把笔记发布上网时，通用 Markdown 渲染器只会把它当成普通引用块。@vaultkit/markdown-it-obsidian-callouts 在任何 markdown-it ≥ 14 环境里补齐这…

用 Obsidian 写作的人迟早会遇到同一个问题：笔记想发布成博客，但 vault 里的 双链、callouts、 嵌入这些方言语法，任何通用静态站点生成器都不认识；而且 vault 里混着日记、草稿、模板，绝不能整库上网。@vaultkit/vitepress-theme-vault 就是为这条链路而生的 Vite…

一句话 Addy Osmani 的 25 个工程技能，按 define、plan、build、verify、review、ship 生命周期覆盖 AI 编码全流程；全部模型调用，靠 description 自动激活。

一句话 设计能长期稳定的 API 和模块边界：契约先行、错误语义统一、演进只加不改，覆盖 REST 和 TypeScript 两套写法。

一句话 跨函数边界的代码先把调用方用法、类型签名和模块边界画成草图，用 arena 出多个候选设计综合后再填实现；实现证明设计错了就推翻重来。

一句话 N 个子代理对同一份简报各出一个候选，一个只读 judge 按 rubric 打分，主代理通读后选一个基底再把落选者的优点嫁接进来。

一句话 本仓库技能的路由器：说出你的处境，它告诉你该用哪个技能或技能序列，以及流程里的人工决策点在哪。

一句话 从你的真实聊天记录里挖掘反复出现的工作习惯，草拟一个 <你的名字>-mode 技能，让以后的 agent 按你的方式工作。

一句话 在报告或依据一个性能数字之前，用七问核对它：瓶颈、调参、物理上限、错误、可复现、端到端意义、工作是否真的发生。

一句话 一组休眠的 Cursor automation 源码：在 Slack 问题频道里，一个 automation 给每条新报告分类回帖，另一个等分类标记后通过真实 UI 复现确认的 bug，并可开出有前后证据的 draft PR。

一句话 在改动合并前找出它会波及 diff 之外的什么地方：找到「它安全是因为哪一条事实」，用真实跑代码证明那条事实，而不是交一份听起来有理的 writeup。

一句话 把 agent 上一条消息去掉黑话，用人和人说话的方式更简单地复述一遍。

一句话 通过 Chrome DevTools MCP 在真实浏览器里调试和验证：看 DOM、抓 console、分析网络、跑性能 trace、截图取证。

一句话 跑仓库自己的编译和类型检查命令，把报错按文件和类别汇总，先修把握最大的，循环到干净或卡住。

一句话 单会话追一个长期目标：你当 DRI，战术和战略双轨并行，所有活派子代理，记忆写进跨会话的 wiki。

一句话 给每次变更配一条不可跳过的质量门禁流水线，并把 CI 失败反馈回 agent；附带部署策略与周边自动化。

一句话 把当前会话交接给一个立刻开工的后台 agent：写 handoff summary 到临时文件，再用 claude --bg 以它播种新 agent。

一句话 合并前的五轴评审：correctness、readability、architecture、security、performance；发现按 Critical/Required/Optional/Nit/FYI 分级。

一句话 对 HEAD 到你指定固定点的 diff 做双轴评审：Standards（是否遵守本仓库规范）和 Spec（是否忠实实现 issue/spec），两个子代理并行出报告，分开报不混名次。

一句话 在行为完全不变的前提下把能跑的代码改得更清楚，只动本次范围内，边改边验证。

一句话 设计深模块的共享词汇与原则：module、interface、depth、seam、adapter、leverage、locality，是参考不是流程，不给产物。

一句话 把项目质量底线写成 CONSTRAINTS.md 契约，并盯住 diff 防止 agent 悄悄降标：新增 @ts-ignore、跳测试、删断言、下调阈值都算违规。

一句话 给 agent 配正确的上下文：五层 hierarchy、三种打包策略，超预算时知道先砍什么、护什么。

一句话 给交互式 CLI/TUI 搭一个本地可重复的驱动环境，用确定性输入复现 bug、验证键盘流程、录制前后对照的终端 transcript。

一句话 用本地浏览器/CDP 环境驱动 web、IDE 或 Electron 界面，拿截图、accessibility 快照、console/网络日志和 profile 当证据。

一句话 挖出 agent 在这个仓库反复犯的同类错误，在结构、类型、lint、测试里挑最高的一级把每类错变成不可能，文档只兜底。

一句话 在 bug 代价最高、测试最够不到的地方选一条性质，用合适的工具（默认 TLA+ 模型检查）形式化验证它，并留下一个项目本地技能让以后的 agent 一键复查。

一句话 采访仓库而不是采访你，生成一个 .cursor/skills/verify-<app>/ 项目本地技能，让 agent 能像用户一样驱动真实应用并留下行为证据。

一句话 一套面向 Cursor 的插件：18 个技能加 2 个 agent 加 2 条规则，覆盖 CI、评审、交付和测试可靠性的内部风格工作流。

一句话 系统化的根因调试：复现、定位、最小化、修根因、防复发、端到端验证；挂了就停线，不猜。

一句话 安全退役旧系统并把用户迁过去：先建替代品、发通告写迁移指南、渐进迁移、最后才删；数据库走 expand/contract。

一句话 对着分支与 main 的 diff，清掉 AI 生成代码常见的赘余：多余注释、异常防御性检查、为绕类型加的 any、该早退的深嵌套。

一句话 针对难缠 bug 和性能回退的六阶段纪律：先造一条能对「这个 bug」变红的紧密反馈环，再最小化、排假设、插桩、修复加回归测试、清理。

一句话 把决策的「为什么」留下来：ADR 记录架构决策，内联注释只写读者猜不到的，API 文档贴着类型走。

一句话 主动打磨项目的领域模型：挑战术语、用具体场景压测边界，词一敲定当场写进 GLOSSARY.md，够格的决策才记 ADR。

一句话 每个非平凡决定都过一次全新上下文的对抗性评审才准站稳：CLAIM、EXTRACT、DOUBT、RECONCILE、STOP。

一句话 没有现成剧本时先设计一个：把任务拆成可独立落地的单元，按假设-验证循环执行，全程留可审计的决策日志。

一句话 定位 PR 上失败的检查，从日志里抠出第一个可行动的错误，上最小修复，推送后重复直到全绿。

一句话 非交互地解掉合并冲突，以正确性优先做最小修改，跑通编译和测试后总结关键取舍。

一句话 写生产级 UI：组件结构、状态归属、设计系统对齐、躲开「一眼 AI」的观感，无障碍做到 WCAG 2.1 AA。

一句话 拉取当前 PR 的评审评论和讨论，按严重程度和可行动性分组，输出一份按优先级排的行动清单。

一句话 给 Claude Code 装 PreToolUse 钩子，在执行前拦下危险 git 命令：push、reset --hard、clean、branch -D、checkout/restore 全量还原。

一句话 把变更组织成干净历史：原子提交、意图型 message、关注点分离、worktree 并行、semver 发版。

一句话 不在工作目录时用的访谈：把模糊的想法一轮轮问到你能承诺为止；stateless，不落任何文件。

一句话 围绕代码库的访谈：和 grill-me 同一套连环追问，但顺手把定下的术语写进 GLOSSARY.md、把够格的决策记成 ADR，留下书面记录。

一句话 访谈原语：把计划、决定或想法当设计树，按轮次问完整个 frontier；事实由 agent 去查，决定永远归用户。

一句话 把当前会话压成一个可携带的 handoff 文档，写到系统临时目录而不是工作区，让另一个 agent 能接手。

一句话 回答「X 是怎么工作的」：探索代码库后给出 senior 工程师带新人级别的架构讲解，够建心智模型，不堆注释版源码。

一句话 把模糊想法炼成一页可执行的概念：先发散扩选项，再收敛做压力测试，产出一页 markdown。

一句话 一口气实现整份 spec：把 tickets 当任务图，在 ready frontier 上并行跑 implementer 子代理，全部落到一条 integration branch，最后过一次 code-review。

一句话 把已决定的活变成 commit：指向一张票、一份 spec 或刚谈妥的方案，调 tdd 在约定 seam 上红绿循环，收尾调 code-review。

一句话 扫描代码库找 deepening 机会，出一份可视化 HTML 报告，挑一个候选再用 grilling 问透；只勘察不改代码，重构另开会话走正常 build 流程。

一句话 让 agent 用自己的话复述它理解到的你的目标和要解决的问题，误解在动手前暴露。

一句话 把改动切成薄而可验证的竖切片一片片交付，全程可编译、可回滚；/build 一次一片，/build auto 一次批准跑到底。

一句话 把同一份 diff、意图和 rubric 发给不同模型家族的评审员，靠模型多样性找盲区；主代理做 lead 判断，把发现分四桶，不自动改代码。

一句话 一次一个问题地访谈，挖出用户真正想要的而不是「觉得应该要」的，问到约 95% 把握就停。

一句话 和 pstack-ketchup 一样的补课，但「发生了什么」改成一段无声幻灯片视频，待决事项仍以文字列在视频下。

一句话 用大白话补全你上一条消息之后这个 chat 里发生的一切，再把每件等你拍板的事列成带来建议、证据和风险的清单，让你只看回复就能决定。

一句话 在当前目录跨会话访谈，把你想自动化的工作流问成「实现者拿起来就能做」的 workflow spec，工作区文件持续沉淀。

一句话 盯着一个 PR 的全部挂载检查，失败就修、推送再查，循环到所有必过检查变绿。

一句话 代码改了而形式化验证没跟上时把它拉回一致：读 sync commit 之后的每个变更，更新模型和性质，重跑，并分辩每个失败是验证漂移还是代码真 bug。

一句话 给 /create-verification-skill 生成的验证技能和 feature map 做巡检：每个功能一个只读子代理对源码，再跑一次真机全功能驱动，最多产出一个已验证修正的 PR。

一句话 做一个按钮页面，点击后由本机服务器 POST JSON 到 webhook routine 唤醒 Grok Bot；sender key 只留在服务器，不进浏览器、不进聊天。

一句话 在不改行为的前提下把 PR 收拾得好评：清理嘈杂历史、补齐描述、给评审者标注入口和风险。

一句话 Matt Pocock 日常自用的 agent 技能集：小而可组合、不接管流程，主线是 grill-with-docs 到 spec 到 tickets 到 implement 到 PR，靠上下文卫生（智能区约 150k）和阶段边界五选项把多会话工程串起来。

一句话 把测试文件里的 as 断言迁到 @total-typescript/shoehorn：fromPartial() 传部分数据、fromAny() 传故意错的数据。

一句话 从最新 main 拉一个语义清晰的分支，做完实现和测试，提交聚焦的 commit 并开出带验证说明的 PR。

一句话 评审前把注释交给没写过它们的 Comment Sicko 子代理屠杀一遍，接受的发现按根因修掉，声称有约束的注释提议编码成类型、测试或 lint。

一句话 让生产行为可见可诊断：先定义「正常工作」长什么样，再上结构化日志、RED/USE 指标、trace 和按症状的告警。

一句话 先测量再优化的性能流程：定位一个瓶颈、只修那一个、用数据决定去留，再立护栏防回退。

一句话 把 spec 拆成带验收标准的有序任务：先画依赖图，竖切片写任务，排好 checkpoint，产物落 tasks/。

一句话 pstack 的内置问答：回答你关于安装、/poteto-mode、选技能、排错、个性化的问题，递一条可发送的提示词和来源链接，不替你把活干了。

一句话 pstack 的总入口：读你的任务匹配 23 个剧本之一，把剧本步骤抄进 todo，按需要调用其他技能，全程引用原则、管子代理、写 unslop 过的回复。

一句话 贴一个 GitHub PR 链接，生成一份可交互的 HTML 走查页：核心文件展开、机械文件折叠、带批注和移动代码识别的 diff。

一句话 规定 PR body 的形状：Summary 用最小可视化讲清改动、Evidence 给 before/after 证据、Merge Danger 判合并风险。

一句话 写一次性代码回答一个设计问题：状态/逻辑问题产出一个可分享的 HTML 试玩页，UI 问题产出同一路由下多个可切换变体；答完折回真代码，原型留在 prototype 分支当证据。

一句话 poteto（React core team，Cursor）开源的 Cursor 技能库：一个 /poteto-mode 主路由器加 23 个剧本、34 个技能、24 条原则，目标是用严谨换质量而不是堆代码量。

一句话 开工或复工前，从你自己的聊天记录加共享记录（工单、PR、报错）重建近期工作上下文，交一份紧凑的当前状态简报。

一句话 把刚结束这段对话的 transcript 交给三个不同视角的评审子代理挖掘经验，综合后逐条路由成对现有技能的具体修改，等你批准才动手。

一句话 派一个后台 agent 对着一手来源（官方文档、源码、spec、一方 API）查问题，把带引用的发现写成仓库里的一份 Markdown 文件，你的主线不等人。

一句话 复盘一次 coding 会话，按严重程度给出对 agent 环境的改进候选：导航指针、自动化检查、coding 标准、steering 文件、工具经济性；只提议，选中才改。

一句话 交付前对当前分支做一轮结构化评审：查 bug、意图贴合度和测试覆盖，修掉关键问题，提交并开出或更新 PR。

一句话 跑 Playwright 冒烟测试，失败就看 trace 和日志定位根因，上最小修复后重跑到稳定。

一句话 按课程规范批量脚手架练习目录：exercises/XX-section/XX.YY-exercise/ 下放 problem/solution/explainer 子目录，每个带非空 readme，跑 lint 到过。

一句话 先做 STRIDE 威胁建模再上加固：三层边界定哪些必做、先问、禁做，覆盖注入、会话、SSRF、密钥、供应链到 LLM 特性。

一句话 每个 repo 跑一次的初始化：配好 issue tracker、triage 五标签词汇、领域文档布局，写进 CLAUDE.md/AGENTS.md 的 ## Agent skills 块和 docs/agents/ 三个文件。

一句话 给 Node repo 装 Husky pre-commit：lint-staged 先跑 Prettier，再跑 typecheck 和 test，提交自动把关。

一句话 探测你可用的模型，按推理预算给 pstack 每个角色配一个模型，写成 always-apply 的 pstack-models 规则；pstack 里唯一会自己加载的技能。

一句话 给 TypeScript repo 接 dependency-cruiser，把每个 package 逼成深模块：子目录全私有、只能从包根 entry point 进、测试也只能走 entry point，最后实测规则真的咬人。

一句话 把你的提示词改得更深而不是更大：先答四个问题，再按答案重写提示词，不替你执行任务。

一句话 上线前的检查单加发布策略：六类预检、feature flag、带量化门槛的分阶段放量、监控兜底、回滚方案先写好。

一句话 长跑或无人值守任务里维护一份 TSV 决策日志：一行一个决定（做了什么、为什么、证据指针、结果），回来的人按日志加 transcript 审计。

一句话 每个实现决定先对官方文档验证：探测栈和版本、抓一手文档、按文档写、在代码里引出处。

一句话 写代码前先写 spec：SPECIFY、PLAN、TASKS、IMPLEMENT 四道人工门禁，跨能力的大需求先画 capability map。

一句话 把「用户看到的行为」画成从 TLA+ 模型生成的 Mermaid 状态图：每个 bug 是一条编了号、通向违规状态的路径，用读者的话命名状态和步骤。

一句话 一条消息起 N 个并行 worker 分片或赛跑，等他们全部回来后交一份 PASS/ISSUES/BLOCKED 汇总报告。

一句话 红到绿的竖切片循环：在事先约定的 seam 上写一个会失败的测试，再写刚好让它通过的代码；重构不在循环里，留给评审。

一句话 修 bug 且有便宜的本地测试路径时，先把坏行为写成会失败的回归测试，再改实现让它过；测试路径不切实际就不硬写。

一句话 把当前目录变成有状态的教学工作区，跨多会话教你一个主题：短小的自包含 HTML 课 + 参考卡 + 学习记录，不信任模型的参数知识。

一句话 把 pstack-how 和 pstack-why 的发现织成一段大白话讲解，一张图一张图把系统拼给你看，目标是真懂不是摘要。

一句话 四层写作标准：Diátaxis 选文档模式，Google developer style 管句子，STE 管指令，Global English 管歧义；目标是疲惫的工程师一遍读懂。

一句话 红绿重构循环驱动开发：先写会失败的测试再写刚好过它的实现；修 bug 走 Prove-It 模式先复现。

一句话 异常严格的可维护性评审：专找能用「code judo」整体删掉的复杂度，而不是挑表面毛病。

一句话 把「答案在别人脑子里」的决定变成一份 Markdown 问卷：访谈只问寄送（给谁、要回什么），问卷里的问题瞄准两边的认知差。

一句话 把当前会话综合成一份 spec 发到 issue tracker：不访谈只记录已定决定，并在写码前先约定测试 seam。

一句话 把计划、spec 或当前会话拆成一组 tracer-bullet 票：每张纵切全层、能独立演示、声明 blocking edges，按 tracker 能力发布为文件或原生 blocking 关系。

一句话 把 tracker 上别人提的 issue 和外部 PR 过一台小型状态机：一个 category 角色加一个 state 角色，核实、必要时访谈，终点是 agent-ready 的 brief、给报告人的具体问题、或带理由的关闭。

一句话 一张 16 条的 TypeScript 规则表，把 pstack-原则集#Type System Discipline 落成具体语法：判别联合、brand、unknown、schema 先行、不 as。

一句话 按一张编了号的模式清单清扫文本里的 AI 痕迹：AI 词汇、凑三个、假排比、破折号滥用、谄媚开场、填充句、隐喻名词。

一句话 全库的路由元技能：按任务类型选该激活哪个技能，并规定六条通用工作守则。

一句话 一个虚构但结构完整的项目级验证技能样例：SKILL.md 负责 launch / doctor / drive / prove / cleanup，references/features/ 存行为级 feature map。

一句话 把一句断言改写成可证伪的形式，同环境各抓一份 baseline 和 treatment 原始产物对比，只回 VERIFIED、NOT VERIFIED 或 INCONCLUSIVE 三种结论。

一句话 半天以内的小修：先复现并写一个会失败的回归测试，修到变绿，自审后开 PR。全程一个窗口，不换上下文。

一句话 半天到两天、一个窗口装得下的功能：先被访谈问到能承诺，再 implement 走 TDD 加评审，开 PR 收尾，可选复盘。

一句话 几天到两周、要拆票做的功能：一个窗口里把需求问成 spec 再拆成票，之后每张票换窗口实现，串行或并行，最后评审、开 PR、上线。

一句话 方向还没定的数周工程：先在 issue tracker 上画一张决策地图，每个会话只解一张票拿决定，地图清空后移交 to-spec 进入 W3。

一句话 面对陌生代码库先摸底不动手：配好上下文、查一手资料、读懂架构、立质量底线、给要改的区域补特征测试，产出交给 W2 或 W3。

一句话 不单独走的一层加固：宿主工作流命中鉴权、支付、迁移、公开 API、不可逆操作时打开，在评审和上线段插入威胁建模、对抗评审和爆炸半径验证。

一句话 PR 开出之后的常驻循环：盯绿 CI、处理评审评论、解冲突、合并，然后把重复检查自动化、定期汇报、把反复犯的错固化成结构。

一句话 一句话纠偏：上一条消息没看懂就敲它，agent 补上你缺的上下文，用简明技术英语和 GLOSSARY.md 词汇把刚才说的重讲一遍。

一句话 给一个会话装不下的大工程画共享地图：在 issue tracker 上建 map issue 和一组 decision tickets，一次会话解一张票，产出决定不是交付物，直到通往 destination 的路清晰再移交 to-spec。

一句话 汇总最近 7 到 10 天自己署名的 commit，产出 2 到 5 条要点加一段 bugfix / 技术债 / 新功能分类说明的周报。

一句话 按用户给的时间窗口（昨天、近 3 天、上周）汇总自己署名的 commit，输出一段高信息密度的进展说明并注明真实日期范围。

一句话 考据代码为什么长成这样：git 锚点打底，按可用 MCP 并行派七类证据 investigator，synthesizer 汇成带置信分级和来源清单的报告。

一句话 生成一个交互式 bash 向导脚本，带人走完只有人能做的步骤：开服务、配密钥、点陌生 dashboard、一次性迁移或切换。

一句话 从最近的 Cursor 聊天里提炼稳定的工作偏好，按置信度分级后落成 skill、rule 或 workflow 文档，而不是做聊天摘要。

一句话 写作 exploit 路线之一：把素材组织成一趟 beat 之旅，选起始 beat、一次只写一节，每个概念先 grounded 才能被后面的 beat 引用。

一句话 写给 agent 看的文档的参考规范：context pointer、两种 load、信息层级、完成判据、leading word、删减原则；默认修法是删不是解释。

一句话 写作 explore 路线：把你脑子里可能进成文的碎片（金句、场景、半想法、leading word）静默追加到一个文档里攒素材，不谈结构。

一句话 写作 exploit 路线之二：把一个素材文件逐段塑形成文章，先定 opening 再一段段长，每步都为格式选择争论，素材文件只读不动。

一句话 addy 管全流程把关，matt 管需求对齐和上下文，ctk 管 PR 和 CI 收尾，pstack 管严谨和验证，poteto 样例示范验证技能长什么样。

一句话 24 个一行一条的原则技能，是 pstack-poteto-mode 的决策词汇表：agent 开工先读索引，回复里点名用了哪条、它改变了哪个决定。

一句话 五个仓库一页速查：入口、主线流程、技能分组和上下文原则，细节去各仓库概览。

一句话 按任务规模和风险挑工作流：小修进 W1，功能按会话数选 W2 或 W3，方向模糊先 W4 收敛，陌生代码先 W5，高风险叠 W6，PR 之后进 W7。

一句话 5 个知名 skills 仓库的 118 篇技能笔记、4 篇仓库概览和 7 个工作流。先按任务挑工作流，再查具体技能。

一句话 本系列统一使用的说法。笔记里遇到这些词，都按这里的定义理解。

结论先行：Claude Code 目前最稳的 skill 使用方式分成两类： 直接放入约定目录：项目级 .claude/skills/，全局级 ~/.claude/skills/ 通过第三方工具或 plugin 做分发与安装 vercel-labs/skills 属于 社区 CLI 安装器，不是 Claude Code…

这份笔记的目标不是立即改写 .claude 体系，而是先回答一个更基础的问题：哪些内容应该继续留在 standards/ 或 commands/，哪些内容才适合抽到 skills/。

.claude/settings.json 没有 autoCompact 顶层键；自动压缩通过 env 中的环境变量配置。若公司将上下文上限控制为 200k，建议显式设置 CLAUDECODEAUTOCOMPACTWINDOW=200000。

Claude Code 目前安装 skills 的主线只有两种： 裸 skill：放进 ~/.claude/skills/ 或 <repo>/.claude/skills/ 可安装分发：把 skill 做进 plugin，再通过 plugin marketplace 安装 目前没有官方一等公民的 raw skill 安…

这篇文档只讲一件事：在 CNB 流水线里，怎么把前一个 stage 的结果传给后一个 stage。

本文档不是简单的变更摘要，而是一份偏设计说明性质的记录，目标是把这次 cnb-rs auth 改造讲清楚，方便您后续从下面几个角度审视：

MkDocs + Material 适合追求“高写作效率 + 低维护成本 + 稳定阅读体验”的技术文档项目，是多数个人知识库和中小团队文档站的稳妥基线。

Docusaurus 是面向“产品级文档门户”的 React 方案，强项是版本化、国际化、组件化扩展和生态完整度。

VitePress 是面向技术文档与知识博客的轻量框架，核心优势是“Vite 速度 + Markdown 友好 + 足够灵活的主题扩展”。

Starlight 是 Astro 生态中的文档框架，优势在于现代内容体验、静态性能和与 Astro 内容平台能力的自然融合。

mdBook 是 Rust 生态最成熟的书籍式文档工具，适合“按章节线性学习”的教程、课程和手册型内容。

Zola 是 Rust 编写的通用静态站生成器，适合希望同时承载文档、博客、专题页面并追求高可塑性的内容平台。

更新时间：2026-03-11 用途：作为公开博客系列的主索引与选型手册。 阅读方式：先看本页第 3、4、5 章建立整体框架，再按需要进入单框架深度笔记。

.gitignore 控制哪些文件不被 Git 跟踪，.gitattributes 控制 Git 如何处理文件（换行符、diff、merge 策略等）。这两个文件是项目级配置的基础，跟随代码提交，确保团队一致。

git bisect 是 Git 内置的二分查找工具，用于在提交历史中快速定位引入 bug 的那个提交。它通过不断将搜索范围缩小一半，在 O(log n) 的时间复杂度内找到问题提交——1000 个提交只需约 10 次测试。

分支是 Git 最核心的功能之一。git branch、git switch、git checkout 三个命令构成了分支管理的完整工具集。Git 2.23 之后，官方推荐使用 switch 切换分支、restore 恢复文件，替代万能但容易混淆的 checkout。

git cherry-pick 是 Git 中用于将指定提交应用到当前分支的命令。它会复制一个提交的修改内容，在当前分支上创建一个新的提交。与 merge 和 rebase 不同，cherry-pick 只选取特定的提交，而非整个分支的所有提交。

git clean 用于删除工作区中未跟踪的文件；git gc/git maintenance 用于仓库的垃圾回收和性能优化。前者清理工作区，后者清理 .git 目录。

git config 是 Git 的配置管理命令，控制着 Git 的几乎所有行为——从用户身份、编辑器选择到合并策略、性能优化。掌握配置是高效使用 Git 的基础。

git filter-branch 是 Git 提供的一个强大命令，用于批量重写仓库的提交历史。它可以修改提交中的文件内容、提交信息、作者信息等，常用于从历史记录中彻底删除敏感文件、修正提交者身份、拆分子目录为独立仓库等场景。

git filter-repo 是 Git 官方推荐的历史重写工具，用于替代已弃用的 git filter-branch 和 BFG Repo Cleaner。它基于 git fast-export / git fast-import 管道工作，速度极快，且在设计上规避了 filter-branch 的众多陷阱。

git filter-repo 是 Git 官方推荐的历史重写工具，用于替代已弃用的 git filter-branch 和 BFG Repo Cleaner。它基于 git fast-export / git fast-import 管道工作，速度极快，且在设计上规避了 filter-branch 的众多陷阱。

Git hooks 是在特定 Git 事件发生时自动执行的脚本。它们是 Git 内置的自动化机制，可以在提交、推送、合并等操作前后触发自定义逻辑，用于代码质量检查、规范强制、自动化测试等。

Git 原生设计不适合管理大文件——每次 clone 都要下载完整历史中的每个版本。Git LFS（Large File Storage）通过将大文件存储在独立服务器来解决这个问题。sparse-checkout 和 partial clone 则从另一个角度优化——只下载需要的部分。

git log 和 git diff 是 Git 中最常用的查看和分析命令。log 用于浏览提交历史，diff 用于对比代码差异。熟练掌握这两个命令的各种参数，可以极大提高代码审查和调试效率。

git merge 是 Git 中用于将一个分支的修改合并到另一个分支的核心命令。它是团队协作中最基本的操作之一，理解不同的合并策略和冲突解决方法是高效使用 Git 的关键。

git rebase 是 Git 中用于重新排列提交历史的强大命令。它的核心功能是将一系列提交「搬移」到另一个基础提交之上，从而产生一条线性的、更整洁的提交历史。它也可以用于交互式编辑提交（squash、reword、拆分等）。

git remote、git fetch、git pull、git push 是 Git 分布式协作的核心命令。理解它们之间的关系和各自的行为，是团队协作开发的基础。

git reset 是 Git 中最常用的撤销操作命令，用于移动 HEAD 指针和当前分支引用，从而实现取消暂存、撤销提交、重置工作区等操作。它是理解 Git 内部工作原理的关键命令之一。

git revert 是 Git 中最安全的撤销提交命令，它通过创建一个新的「反向提交」来抵消指定提交的修改，而不是删除提交历史。这使得它成为撤销已推送到远程的提交的首选方式。

git stash 是 Git 中用于临时保存未提交修改的命令。它会将工作区和暂存区的修改保存到一个栈结构中，让工作区恢复到干净状态，方便你切换分支、拉取更新或处理紧急任务。之后可以随时恢复这些修改。

git submodule 和 git subtree 是 Git 中管理子项目依赖的两种方案。它们解决同一个问题：如何在一个仓库中引用另一个仓库的代码，但设计理念和使用方式截然不同。

git tag 是 Git 中用于为特定提交打上永久标记的命令。标签通常用于标记发布版本（如 v1.0.0、v2.3.1），是版本管理和发布流程的核心工具。

git worktree 是 Git 提供的多工作目录管理工具，允许你从同一个仓库中同时检出多个分支到不同的目录。每个 worktree 都是一个独立的工作区，共享同一个 .git 对象数据库，但拥有独立的 HEAD、暂存区和工作文件。

本文是 Git 系列笔记的知识地图（MOC），按主题分类汇总了所有 Git 相关笔记，方便快速导航和查阅。

Scoop 是一个 Windows 命令行软件包管理器，灵感来自 Homebrew。它通过简洁的命令行界面安装和管理"便携式"应用程序，无需 UAC 弹窗提示、不污染系统 PATH、不修改 Windows 注册表。

概述 Windows 系统默认使用 GBK（代码页 936）编码，这在处理多语言文本或与 Linux/macOS 协作时容易出现乱码问题。本文介绍多种将系统编码切换为 UTF-8 的方法，并提供一键配置脚本。

统计信息 共安装 131 个软件，涵盖 18 个分类，来源于 7 个 bucket（main、extras、versions、nerd-fonts、nonportable、atm、YewFenceYewNursery）。 使用 scoop list | Sort-Object Updated -Descending 查…

winget install --id ZhipuAI.AutoGLM --source winget --force

Analysis of cost per use, see Buy wisely

本文档适用于：

本文档介绍在 Windows 中查看、设置、取消环境变量的常用方法，适合开发环境配置（如 Java、Node.js、Rust、Go 等）。