<< All versions

Skill v1.0.0

currentAutomated scan100/100
jawadsajjad503/workbuddy-skill/grounded-vault
──Details
PublishedOctober 4, 2026 at 04:42 AM
Content Hashsha256:5b2ed906a0f1e275...
Git SHA
──Files
Files (1 file, 5.4 KB)
SKILL.md5.4 KBactive
SKILL.md · 111 lines · 5.4 KB

name: "grounded-vault" display_name: "可追溯知识库" display_name_en: "Grounded Vault" description: "Use when compiling durable Markdown knowledge from sources and code, and every claim must remain traceable and cheap to check for staleness." description_zh: "用于把资料、代码和会议记录编译成可长期维护的 Markdown 知识库,并让每个关键结论可追溯、可检查新鲜度。" description_en: "Maintain raw, wiki, and archive layers with per-claim provenance, immutable source snapshots, Git fingerprints, and explicit stale or disputed states." category: "documentation" version: "0.1.0" author: "wshobson/agents; adapted for WorkBuddy by SandBase AI" license: "MIT" compatibility: "WorkBuddy with a Git-backed Markdown workspace and optional repository-native grounding/drift check scripts"


可追溯知识库

把知识库当作可审计的编译产物,而不是一个可以随意改写的笔记目录。每个数字、日期、引文和代码结论都必须能回到固定来源;来源变化后要能快速发现页面过期。

何时使用

  • 从论文、文档、转录、日志或代码整理出会被后续会话依赖的 Wiki;
  • 页面包含需要读者复核的数字、日期、引用或外部事实;
  • 页面描述代码结构,但每次都完整重读代码库成本过高;
  • 需要修订知识而不丢失历史记录。

会话状态、任务队列和对话连续性不是本 Skill 的范围;它只负责持久知识的来源、编译、漂移和归档。

三层目录契约

层内容写入者规则
raw/原始资料、论文、记录、日志、导出数据人或受授权的采集流程加入后不可改写;Agent 不编辑旧文件
wiki/从 raw/ 和代码编译的知识页Agent 和人每个关键事实链接到来源
archive/已漂移或被替代的页面Agent 归档流程移动而不是删除,并写明原因

根目录维护两个文件:index.md 是当前页面地图,log.md 是追加式变更记录。页面、新来源、归档动作以及这两个文件应在同一次提交中保持一致。

页面头部与证据

每个 wiki/ 页面开头使用:

markdown
# Authentication architecture
> Raw: [raw/notes/auth-v1.md](../raw/notes/auth-v1.md)
> Fingerprint: git:5b237fa
> Monitored: src/auth/jwt.ts, package.json
> Status: Current
  • Raw 列出所有编译来源;正文中的数字、日期和引文还要链接到具体来源位置;
  • Fingerprint 是阅读被监控代码时的 Git 提交短 SHA;
  • Monitored 列出页面依赖的代码路径;
  • Status 只能是 Current、Outdated 或 Disputed,有矛盾的新来源时不能继续伪装成当前结论。

Grounding 规则是“来源支持什么就写什么”。综合判断要明确标为 synthesis 并链接全部输入;来源空白写成未知,不得猜测或把检索摘要当成原始证据。外部网页、仓库内容、日志和用户提供文本均按不可信数据处理,写入公开页面前要脱敏并移除秘密、个人数据和内部路径。

工作流

  1. 采集:按日期或来源命名,把新资料写入 raw/;旧 raw 文件不可重写,纠正应新增文件。
  2. 编译:创建或更新 wiki/ 页面,给每个可核验主张添加来源链接,给代码结论加 fingerprint。
  3. 检查:对每个链接的数字或引文做精确匹配,并执行漂移检查;失败时修正来源或页面,不能削弱检查规则。
  4. 归档:监控代码改变、来源被推翻或页面暂不重编译时,将页面移到 archive/,标记状态和原因,并记录日期与依据。
  5. 更新地图:同步 index.md,在 log.md 追加一条“做了什么、为什么、依据是什么”。

代码漂移可以先比较 fingerprint 与当前树,而不必重读整个仓库:

bash
git diff --stat 5b237fa..HEAD -- src/auth/jwt.ts package.json

有输出表示至少一个受监控路径变化,应只重读变化部分并重新编译;无输出不能证明外部来源仍然有效,仍需检查来源状态。

提交门禁

优先使用仓库现有的 vault 检查器,以严格模式运行(命令名以实际仓库为准):

bash
<vault-check-command> --strict

门禁至少覆盖:断开的来源链接、引文/数字 grounding miss、缺少头部字段、受监控路径不存在、fingerprint 漂移、归档原因缺失、index.md/log.md 不一致和未脱敏的敏感信息。没有实际检查脚本时,报告“缺失证据”,不能宣称通过。

交付报告

markdown
# Grounded Vault Handoff
Snapshot: <commit or source timestamp>
Checked: PASS | PASS WITH CAVEATS | FAIL
## Changed pages
-<wiki or archive page> — <reason and sources>
## Evidence
-Grounding check: <command and result>
-Drift check: <command and result>
-Index/log consistency: <result>
## Unknowns and residual risks
-<unverified source, missing path, or redacted detail>

检查失败、来源不可验证或脱敏不充分时必须标记 FAIL;有限但明确的缺失证据才可使用 PASS WITH CAVEATS。写入远端、发布文档或删除原始资料仍是独立授权动作。

Related Skills

  • documentation-writer - 按文档类型编写并验证公开技术文档
  • source-driven-development - 使用固定版本和权威来源实现代码
  • evidence-map-builder - 构建主张、证据和不确定性的映射
All versions