Agent Skills
› rohitg00/pro-workflow
› wiki-builder
wiki-builder
GitHub用于创建和管理持久化研究维基的技能。支持Markdown存储与SQLite FTS5索引，提供多种内容类型（如研究、论文、产品等）。具备严格的质量控制、来源溯源及自动化维护工作流，适用于构建长期可检索的知识库。
Trigger Scenarios
用户要求启动新维基或添加资料到维基
需要编译概念页面或查询特定主题知识
希望建立关于论文、项目、代码库等的长期知识库
Install
npx skills add rohitg00/pro-workflow --skill wiki-builder -g -y
SKILL.md
Frontmatter
{
"name": "wiki-builder",
"description": "Start, structure, and grow a persistent research wiki indexed in pro-workflow's SQLite knowledge base. Each wiki is a folder of markdown pages with provenance, plus a shadow FTS5 index so any session can recall it. Use when the user says \"start a wiki\", \"add to wiki\", \"compile a page\", \"wiki on X\", or wants a long-lived knowledge base on a topic, paper, product, person, project, or codebase.",
"user-invocable": true
}
Wiki Builder
Persistent knowledge base for any topic. Markdown on disk + SQLite FTS5 shadow index.
When to use
- "Start a wiki on
" - "Add this paper / link / note to the
wiki" - "Compile a concept page on X in
" - "What does the
wiki say about Y?" (delegates to wiki-query) - "List my wikis"
Locations
- Global:
~/.pro-workflow/wikis/<slug>/— default, never committed - Project:
<project>/.claude/wikis/<slug>/— pass--scope project, committable
Both register in the same ~/.pro-workflow/data.db.
Flavors
| Flavor | Use for |
|---|---|
research |
ongoing topic exploration |
paper |
one-paper deep dive |
domain |
broad subject area |
product |
product/tool KB |
person |
researcher/founder dossier |
organization |
company/lab profile |
project |
internal project KB |
codebase |
symbol/file-aware KB tied to a repo |
incident |
post-mortem KB |
Layout
<slug>/
├── wiki.config.md # purpose, audience, page types, style, auto_research block
├── raw/ # untouched source material (PDFs, scrapes, transcripts)
├── wiki/
│ └── index.md # entry point, hand-curated TOC
├── derived/ # generated artifacts (surveys, charts, summaries)
├── prompts/ # per-task prompts (compile-page, lint, query)
├── logs/maintenance-log.md
└── sources.md # one row per source: id | url | title | hash | fetched_at
Flavor adds folders: wiki/papers, wiki/concepts, wiki/people, wiki/products, wiki/timelines, wiki/questions.
CLI surface
node $SKILL_ROOT/scripts/wiki-cli.js init <slug> --title "X" --flavor research [--scope project] [--root <path>]
node $SKILL_ROOT/scripts/wiki-cli.js list
node $SKILL_ROOT/scripts/wiki-cli.js page <slug> <rel-path> --title "X" [--type concept|paper|person|...] [--from-file path]
node $SKILL_ROOT/scripts/wiki-cli.js reindex <slug>
node $SKILL_ROOT/scripts/wiki-cli.js info <slug>
init runs init_wiki.sh (mirrors dair layout) AND registers the wiki in SQLite. page writes markdown + upserts FTS row.
Workflow when invoked
- Resolve action (init / ingest / compile / list / reindex / info).
- Read
wiki.config.mdof the target wiki before any compile. - Every claim that lands in
wiki/must cite a row insources.md(one citation = one source row). - After page write, call
wiki-cli.js pageso FTS index stays in sync. - Append a one-line entry to
logs/maintenance-log.mdper change. - Update
wiki/index.mdif new top-level page.
Quality bar
- First page useful immediately, not stub.
- Stable slug filenames (
tool-use-benchmarks.md, not2026-05-08-notes.md). - Separate raw source from compiled interpretation.
- Cross-link related pages in same wiki via relative links.
- Mark speculation with
> SPECULATION:block. - No duplicate summaries — link existing page instead.
- Generated pages stay navigable for future agents.
Privacy
Wikis with private: true in config never get fetched from web sources by wiki-research-loop. Local raw/ only.
Auto-research opt-in
Phase 3.3.0 ships builder + query only. Loop arrives in 3.3.1. To prep, wiki.config.md may include:
auto_research:
enabled: false # flip in 3.3.1
max_pages_per_run: 5
max_depth: 3
budget_usd: 0.50
fetchers: [web, arxiv, github]
Templates
See templates/ for wiki.config.md, index.md, prompt files. init_wiki.sh copies these into the new wiki root.
Version History
- 7f7209d Current 2026-07-24 11:41
