菜单
Add a new article, video, talk, paper, book, podcast, or repo to the corresponding INDEX/ table with correctly-shaped frontmatter, derived labels, validated URL, and provenance. Use whenever the user wants to add reading material or a new tool to the awesome list. Wraps the row shapes defined in `.claude/templates/{source,repo}.md`.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Canonical spec for how research entries, sources, tools, topics, and pipelines are structured in this repo. Use whenever adding to INDEX/, when writing under topics/, when authoring or modifying a pipeline skill, or when validating a contribution against the standard. Defines frontmatter schema, identifier rules, linking conventions, status and confidence lifecycles, and provenance requirements.
Re-classify rows in INDEX/sources.md and INDEX/tools.md that landed in the `unsorted` bucket — either with `category=unsorted` or `kind=unsorted`. Re-applies the categories.md vocabulary and the kind heuristic with a fresh attempt, using GitHub topics, description, README excerpts. Use on demand or on a slow weekly schedule to drain the unsorted backlog.
Diff your current GitHub stars against INDEX/tools.md, emit a PR adding newly-starred repos and flagging unstarred ones. Also re-checks staleness (last_pushed > 3 years or archived) and moves stale repos to _archived/tools.md. Use daily via the star-sweep GitHub Action.
Sweep INDEX/sources.md (and optionally INDEX/tools.md) for dead links, moving entries with confirmed-dead URLs to _archived/ with tombstones (last_seen, reason, optional wayback link). Use weekly via the link-check GitHub Action, or on demand when the user wants a manual sweep. Never hard-deletes.
Parse a captured docs corpus into structured concept, API, tool, and entity extracts with frontmatter, plus relation edges, and emit the knowledge graph in Mermaid and JSON forms. Use after scrape-firecrawl when a topic needs structured semantic extraction beyond the URL link graph.
Scan configured release feeds for new libraries, frameworks, and tools in the user's interest areas (Rust, distributed systems, observability, build tooling, FP, DevOps, knowledge-graph / RAG). Append candidates to TRIAGE.md for manual review. Never auto-adds to INDEX/. Use daily via the new-releases-triage GitHub Action, or on demand.
| name | add-source |
| description | Add a new article, video, talk, paper, book, podcast, or repo to the corresponding INDEX/ table with correctly-shaped frontmatter, derived labels, validated URL, and provenance. Use whenever the user wants to add reading material or a new tool to the awesome list. Wraps the row shapes defined in `.claude/templates/{source,repo}.md`. |
Adds one entry to INDEX/sources.md (articles, videos, papers, books, talks, podcasts, courses, RFCs, docs) or INDEX/tools.md (repos / tools).
| input | type | notes |
|---|---|---|
| URL | string | The entry's canonical URL. Required. |
| type | enum | article | video | talk | book | paper | rfc | podcast | course | docs | repo |
| labels | comma list | Optional. If omitted, derived from URL host + page metadata. |
| notes | string | Optional one-liner. |
Resolve and validate URL.
curl -sIL -m 10.url if it differs from the input.repo type, additionally call gh api repos/<owner>/<repo> and verify archived: false. If archived, warn and ask whether to add anyway (will land in _archived/ immediately).Derive metadata.
title — for repo: full_name from GH API. For others: <title> of the page, fetched with a single GET if HEAD didn't include it.published — for articles, parse from URL pattern (/2024/07/...), then page metadata <meta property="article:published_time">. For repos, created_at from GH API. For videos with youtube.com/watch, fall back to upload date in page metadata.description — for repos, the GH description field, first sentence, ≤120 chars.language — for repos, primary language from GH API.stars, last_pushed, archived, license — for repos, all from GH API.Derive labels.
TAXONOMY/domains.md based on URL host + title keywords (article/video) or topics array + description + language (repo).fp-scala, kubernetes, event-sourcing) where they apply.Assign id.
src_<slug-from-title> truncated to 60 chars, kebab-case.<owner>-<repo> lowercased.-2 discriminator.Append row.
.claude/templates/source.md or .claude/templates/repo.md.id (keeps diffs reviewable).added = today (ISO date).status = active.Commit message format.
add(<type>): <title> — e.g. add(article): Rethinking MonadError.
-2 discriminator (rare; means three entries with identical slug).In all rejection cases, surface the reason and stop. Do not insert a partial row.
labels contains at least one domain label from TAXONOMY/domains.md.id.added is today's date in ISO 8601.dead-link-sweep — periodic check that catches what add-source missed.star-sweep — bulk add of newly-starred repos.