jawadsajjad503/workbuddy-skill/grounded-vault

Claude Code and agent skill by jawadsajjad503/workbuddy-skill

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Use when compiling durable Markdown knowledge from sources and code, and every claim must remain traceable and cheap to check for staleness.

Install

npx vskill@latest install jawadsajjad503/workbuddy-skill/grounded-vault

SKILL.md

The same SKILL.md was published earlier as sandbaseai/workbuddy-skill/grounded-vault.

可追溯知识库

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

何时使用

  • 从论文、文档、转录、日志或代码整理出会被后续会话依赖的 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 - 构建主张、证据和不确定性的映射

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
5

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/jawadsajjad503/workbuddy-skill/grounded-vault/badge)](https://verified-skill.com/skills/jawadsajjad503/workbuddy-skill/grounded-vault)

Something wrong with this skill or its page? Tell us.