菜单
Auto-promote eligible project knowledge articles into Research Vault concepts with generated provenance metadata. Use when running the scheduled knowledge-corpus promotion or previewing candidates interactively. Not for consolidating overlapping concepts; use $wiki-merge.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/flonat/flonat-research --skill wiki-grow命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Filter a LaTeX project's bibliography to the entries actually cited, with Overleaf-source resolution, temporary staging, validation, approval-gated canonical replacement, and compilation. Use before submission or after large revisions.
Deliver a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers. Use when the user requests a fast pre-commit safety scan: file size, anonymity (author / affiliation strings in tex/bib), hardcoded secrets, and invisible-Unicode carriers. Triggers: 'audit before commit', 'check before push', 'pre-commit scan', 'safety check'.
Run the final, comprehensive submission-readiness gate and consolidate all checks into one dated report; citation-integrity-only mode is also supported. Use when a paper and submission package are nearly final. Not for a mid-draft adversarial review; use $review-cluster.
正在显示 SKILL.md
| name | wiki-grow |
| description | Auto-promote eligible project knowledge articles into Research Vault concepts with generated provenance metadata. Use when running the scheduled knowledge-corpus promotion or previewing candidates interactively. Not for consolidating overlapping concepts; use $wiki-merge. |
| allowed-tools | Bash, Read |
| argument-hint | --dry-run (default) | --autonomous to actually write |
Saturday-cron worker that grows
~/vault/concepts/from existing project knowledge articles. Designed for zero cognitive load: it surfaces results in the Maintenance Inbox; suppression is a single line in a.denylistfile. the user never has to decide "promote this y/n" at the moment of running.
wiki-grow --dry-runwiki-grow --autonomouscompile-knowledge.~/vault/concepts/ or the wiki at wiki.example.com.Three components, all in this repo:
| File | Role |
|---|---|
scripts/wiki-promote-scan.py | Inventory scanner. Walks vault concepts + project knowledge folders + atlas/book prose. Outputs /tmp/wiki-promote-scan.{md,json} with corpus mention counts and the wikilink graph. |
scripts/wiki-grow.py | Orchestrator. Reads the scan, applies thresholds, copies candidates into ~/vault/concepts/<slug>.md with auto-generated frontmatter and a draft banner. At copy time, [[wikilinks]] whose targets resolve to no vault file (atlas/concepts/venues/people/themes — same semantics as atlas-workspace's dead_wikilinks() validator) are converted to plain text; links between slugs co-promoted in the same run survive. Added 2026-06-12 after verbatim copies created 38 dead links on the wiki. |
scripts/weekly-wiki-grow.sh | Launchd-callable shell wrapper. Cron entrypoint. |
~/Library/LaunchAgents/com.example.weekly-wiki-grow.plist | Saturday 06:45 schedule. |
A slug is promoted on a given run if all of the following hold:
<project>/knowledge/ directory.MIN_CORPUS_MENTIONS,
env-overridable via WIKI_GROW_MIN_MENTIONS. A knowledge article the
curated corpus never references is project-internal, not a general
concept. (History: the original gate was ≥3, retired 2026-07-03 as
empty for this corpus; briefly removed entirely, which over-promoted
0-mention project notes; the ≥1 middle ground was set 2026-08-07.)PROJECT_MECHANICS_RE: dated
notes, -findings/-results/-decisions, hpc-, -roster, r1-,
related-literature, etc.) — a secondary exclusion applied regardless
of mention count.~/vault/concepts/<slug>.md.~/vault/concepts/.denylist.Run cap: at most 8 candidates per run (MAX_CANDIDATES_PER_RUN, env
WIKI_GROW_MAX). Excess roll over to the next Saturday. To scope a
single manual promotion, set WIKI_GROW_MAX=1 — do NOT denylist the
other candidates, which only frees cap slots for backlog items to
promote in their place.
Each promoted concept gets:
---
title: <Concept Name>
slug: <slug>
type: concept
auto_generated: true
source_project: <project-slug>
source_path: /full/path/to/knowledge/<slug>.md
promoted_on: 'YYYY-MM-DD'
corpus_mentions_at_promotion: N
related_topics: []
---
> **Auto-promoted draft.** Seeded from `<project>/knowledge/<slug>.md`
> on YYYY-MM-DD (corpus mentions at promotion: N). Body is verbatim
> from the source — refine for project-agnostic use when read. To
> remove, add the slug to `~/vault/concepts/.denylist`.
<body verbatim from project knowledge article, leading H1 stripped>
The auto_generated: true flag causes the concept overview page on
wiki.example.com to render a small amber "auto-promoted draft" badge
next to the title — the visual contract that distinguishes machine
seeds from human-curated entries.
Single source of truth: ~/vault/concepts/.denylist. One
slug per line; # lines are comments.
When a denylisted slug is encountered:
To stop the noise from a slug you've decided isn't a concept:
# ~/vault/concepts/.denylist
prompt-sensitivity # too narrow — covered by llm-as-judge
threat-models # generic — never promote
If you change your mind, remove the line. The next Saturday run will re-promote on threshold.
Per-run summary in ~/vault/inbox/wiki-grow-YYYY-MM-DD.md:
# Wiki promotion run (YYYY-MM-DD)
- Promoted: **3** new concepts to `~/vault/concepts/`
- Skipped (already in vault): 6
- Skipped (denylist): 2
- Below threshold (3+ mentions): 12
## Promoted slugs
- [`strategic-classification`](https://wiki.example.com/concept/strategic-classification) (14 mentions, from example-project-e)
- ...
The maintenance inbox (atlas.example.com/inbox) surfaces this file as
a single line "Wiki grew: N concept(s) auto-promoted" so you have
weekly signal without weekly triage work.
| Mode | Invocation | Behaviour |
|---|---|---|
| Dry-run (default) | uv run python scripts/wiki-grow.py | Prints the candidate plan, writes nothing. Safe to run ad-hoc. |
| Autonomous | uv run python scripts/wiki-grow.py --autonomous | Writes stubs + inbox summary. Used by cron. |
--autonomous here matches the global flag convention (--autonomous /
-y) — see rules/phased-work.md.
v1 of this skill is deterministic copy + banner — no LLM dispatch per candidate. Project-specific framing in stub bodies is acceptable short-term cost in exchange for fast, idempotent, zero-key cron runs.
When the LLM refinement step is added (v2), it will replace the body
of _promote_one() in wiki-grow.py with a sub-agent dispatch that
reads the source article and writes a project-agnostic version. The
stub frontmatter (auto_generated: true, etc.) stays the same so
existing pages don't need migration.
| Skill | Relationship |
|---|---|
compile-knowledge | Upstream — writes the project knowledge articles wiki-grow promotes from. Must run first to seed candidates. |
atlas-audit | Checks vault concept coverage as part of its routine audits. |
process-inbox | Triages the weekly summary item. |