llm-wiki

name llm-wiki description Xây dựng và duy trì knowledge base cá nhân theo pattern LLM Wiki (Karpathy). Hỗ trợ init, ingest, query, lint, discover, run, digest, pain-rank, setup, book-summary, competitive-brief, interview-prep. LLM Wiki — Claude Code Skill Hệ thống knowledge base cá nhân. LLM xây dựng và duy trì wiki từ nguồn thô. Dựa trên pattern của Andrej Karpathy, mở rộng với auto-discovery. Sub-commands Skill này hỗ trợ các sub-commands sau. Parse argument đầu tiên để xác định command: Command Mô tả Ví dụ init Tạo wiki mới cho một chủ đề /llm-wiki init "AI Agents" ingest Xử lý nguồn mới trong raw/ /llm-wiki ingest query Hỏi đáp dựa trên wiki /llm-wiki query "So sánh RAG vs Wiki" lint Kiểm tra sức khỏe wiki /llm-wiki lint discover Tự tìm nguồn mới /llm-wiki discover run Chạy full cycle: discover → ingest → lint /llm-wiki run status Xem trạng thái wiki /llm-wiki status digest Daily brief — tóm tắt thay đổi wiki 24h /llm-wiki digest pain-rank Xếp hạng pain points theo cơ hội kinh doanh /llm-wiki pain-rank setup Khởi tạo wiki theo variant template có sẵn /llm-wiki setup book-companion book-summary Tóm tắt có cấu trúc toàn bộ wiki sách /llm-wiki book-summary competitive-brief Battlecard 1-pager cho một competitor /llm-wiki competitive-brief "Linear" interview-prep 1-pager chuẩn bị interview cho một công ty /llm-wiki interview-prep "Stripe" Nếu không có sub-command → hiển thị trạng thái và hỏi user muốn làm gì. Thư mục gốc WIKI_ROOT = <current working directory> Xác định WIKI_ROOT bằng cách tìm folder chứa CLAUDE.md + config.yaml + wiki/ + raw/. Thường là thư mục project hiện tại. Luôn đọc WIKI_ROOT/CLAUDE.md trước khi thực hiện bất kỳ command nào — đó là schema quy định mọi quy tắc. Command: init Mục đích: Khởi tạo wiki mới hoặc thêm topic mới vào wiki hiện tại. Quy trình: Đọc CLAUDE.md và config.yaml Nếu argument là topic mới → thêm vào config.yaml → topics Nếu wiki chưa có folder structure → tạo theo CLAUDE.md Ghi LOG.md Ví dụ: /llm-wiki init "Rust Programming" → Thêm topic "Rust Programming" vào config.yaml → Keywords tự sinh: ["Rust language", "Rust programming", "cargo", "rustc"] Command: ingest Mục đích: Xử lý mọi file mới/chưa xử lý trong raw/ . Quy trình: Đọc CLAUDE.md (schema & quy tắc) Đọc .discoveries/history.json → lấy danh sách đã xử lý Scan raw/ → tìm file chưa có trong history Với mỗi file mới: a. Đọc nội dung (dùng Read cho text, WebFetch cho URL, PDF reader cho PDF) b. Tạo source summary → wiki/sources/ c. Trích xuất entities → tạo/cập nhật wiki/entities/ d. Trích xuất concepts → tạo/cập nhật wiki/concepts/ e. Thêm cross-references [[links]] vào các trang liên quan f. Phát hiện contradictions → ghi chú vào trang liên quan Cập nhật wiki/INDEX.md Ghi wiki/LOG.md Cập nhật .discoveries/history.json Quy tắc QUAN TRỌNG: KHÔNG BAO GIỜ sửa file trong raw/ Mỗi source có thể ảnh hưởng 5-15 wiki pages Luôn trích dẫn nguồn: [Nguồn: filename](../raw/path) Nếu thông tin mới mâu thuẫn với cũ → giữ cả hai, ghi rõ Không bịa thông tin — chỉ viết những gì có trong raw sources Batch size theo config.yaml → schedule.ingest.batch_size Command: query Mục đích: Hỏi đáp dựa trên nội dung wiki. Quy trình: Đọc wiki/INDEX.md → tìm trang liên quan đến câu hỏi Đọc các trang wiki liên quan (đọc đủ context, không chỉ 1-2 trang) Tổng hợp câu trả lời với citations [[trang-wiki]] Nếu câu trả lời có giá trị phân tích → lưu vào wiki/syntheses/ hoặc outputs/ Ghi LOG.md Quy tắc: Trả lời DỰA TRÊN WIKI, không dùng kiến thức bên ngoài Nếu wiki thiếu thông tin → nói rõ và gợi ý topic cần discover So sánh, phân tích → tự động lưu thành synthesis page Format đầu ra linh hoạt: markdown, bảng so sánh, bullet points Ví dụ: /llm-wiki query "So sánh RAG truyền thống vs LLM Wiki pattern" → Đọc INDEX.md → tìm trang về RAG, LLM Wiki → Đọc các trang liên quan → Tạo bảng so sánh → Lưu vào wiki/syntheses/rag-vs-llm-wiki.md Command: lint Mục đích: Kiểm tra sức khỏe wiki, phát hiện vấn đề. Quy trình: Đọc toàn bộ wiki/INDEX.md Scan mọi file trong wiki/ Kiểm tra: Contradictions : thông tin mâu thuẫn giữa các trang Orphans : trang không ai link đến Missing pages : [[link]] trỏ đến trang chưa tồn tại Stale claims : thông tin cũ bị nguồn mới bác bỏ Broken links : link đến raw source không còn tồn tại Gaps : lĩnh vực quan trọng thiếu coverage Quality : trang quá ngắn, thiếu sources, thiếu cross-refs Tạo báo cáo → outputs/lint-YYYY-MM-DD.md Cập nhật .discoveries/gaps.json (cho discover dùng) Ghi LOG.md Nếu config.yaml → schedule.lint.auto_fix = true → tự sửa lỗi đơn giản Output format: # Lint Report — YYYY-MM-DD ## Tóm tắt - Tổng trang: N - Contradictions: N - Orphans: N - Missing pages: N - Gaps: N ## Chi tiết ### Contradictions ... ### Đề xuất - Tạo trang mới: [danh sách] - Tìm nguồn cho: [danh sách gaps] Command: discover Mục đích: Tự động tìm nguồn mới từ internet. Quy trình: Đọc config.yaml → topics, feeds, discovery settings Đọc .discoveries/gaps.json → knowledge gaps cần lấp Đọc .discoveries/history.json → tránh trùng lặp Thực hiện theo strategies trong config: a. reddit_scan : WebSearch site:reddit.com theo subreddits + keywords trong config.yaml → tìm pain points, use cases, ý tưởng. Lưu vào raw/reddit/YYYY-MM-DD-slug.md . Trích xuất: vấn đề gốc, giải pháp được đề xuất, upvotes, sentiment. b. github_trending : WebSearch GitHub trending repos theo languages/topics filter c. github_watch : Kiểm tra repos/orgs/people trong config → new releases, new repos d. web_search : WebSearch theo keywords của mỗi topic e. feed_poll : Kiểm tra RSS feeds, Hacker News f. gap_fill : WebSearch theo gaps từ lint g. snowball : Đọc references trong wiki → follow links chưa có Với mỗi nguồn tìm được: a. Kiểm tra dedup (URL, title) b. WebFetch nội dung c. Lưu vào raw/articles/YYYY-MM-DD-slug.md với frontmatter: --- title: "Tiêu đề" url: "https://..." discovered: YYYY-MM-DD topic: "tên topic" --- Cập nhật .discoveries/history.json Ghi LOG.md Tự động trigger ingest cho nguồn mới Quy tắc: Tối đa sources theo config.yaml → schedule.discover.max_sources Ưu tiên: gaps > reddit pain points > trending > feeds Chỉ lấy nội dung chất lượng (bài viết sâu, papers, guides, high-upvote posts) Skip: quảng cáo, listicles nông, nội dung trùng lặp Reddit posts: trích xuất pain point + giải pháp, phân loại theo domain (business, dev, consumer) Lưu reddit vào raw/reddit/ (tách riêng khỏi raw/articles/ ) Command: run Mục đích: Chạy full cycle tự động. Quy trình: discover → ingest → lint → (nếu có gaps mới → discover lại) Chạy discover → tìm nguồn mới (Reddit, GitHub trending, web search) Chạy ingest → xử lý mọi file mới trong raw/ Chạy lint → kiểm tra sức khỏe Nếu lint phát hiện critical gaps → chạy thêm 1 vòng discover+ingest Tạo summary report → outputs/run-YYYY-MM-DD.md Ghi LOG.md Giới hạn: Tối đa 2 vòng discover-ingest để tránh vòng lặp vô hạn. Command: status Mục đích: Hiển thị trạng thái wiki hiện tại. Output: LLM Wiki Status ═══════════════ Wiki: My LLM Wiki Topics: 3 (LLM Agents, Claude Code, AI Engineering) Raw sources: N files Wiki pages: N pages (E entities, C concepts, S sources, Y syntheses) Last ingest: YYYY-MM-DD Last lint: YYYY-MM-DD Last discover: YYYY-MM-DD Knowledge gaps: N Orphan pages: N Health: Good | Warning | Needs Attention Command: digest Mục đích: Tạo daily brief — tóm tắt mọi thay đổi wiki trong 24h, highlights insights mới. Quy trình: Đọc wiki/LOG.md → lọc entries trong 24h qua Đọc các trang wiki mới/cập nhật trong khoảng thời gian đó Tổng hợp thành báo cáo ngắn gọn Output format: # Daily Digest — YYYY-MM-DD ## Nguồn mới (N) - [tên nguồn] — 1 dòng tóm tắt ## Wiki pages mới (N) - [tên trang] — 1 dòng mô tả ## Top 3 Insights 1. [Insight quan trọng nhất — trích từ syntheses hoặc cross-references mới] 2. [Insight thứ hai] 3. [Insight thứ ba] ## Pain Points mới phát hiện (từ Reddit) | Pain Point | Domain | Upvotes | Cơ hội | |------------|--------|---------|--------| | ... | ... | ... | ... | ## Knowledge Gaps cần lấp - [gap 1] - [gap 2] ## Thống kê - Wiki: N pages (+X hôm nay) - Sources: N (+Y hôm nay) - Health: Good/Warning Lưu vào: outputs/digest-YYYY-MM-DD.md Command: pain-rank Mục đích: Xếp hạng pain points từ Reddit và các nguồn khác theo tiềm năng kinh doanh. Quy trình: Đọc tất cả files trong raw/reddit/ Đọc wiki/concepts/ai-pain-points.md và wiki/concepts/micro-saas-pattern.md Trích xuất mọi pain point đã thu thập Scoring mỗi pain point theo 5 tiêu chí Scoring Framework (mỗi tiêu chí 1-10, tổng max 50): Tiêu chí Mô tả Trọng số Urgency Người dùng cần giải pháp ngay? Hay "nice to have"? x2 Market Size Bao nhiêu người/doanh nghiệp có vấn đề này? x2 Willingness to Pay Sẵn sàng trả tiền? Đang trả cho alternatives? x3 AI Solvability AI/LLM có thể giải quyết tốt không? x2 Competition Ít cạnh tranh = điểm cao x1 Output format: # Pain Point Ranking — YYYY-MM-DD ## Top 10 Cơ hội | Rank | Pain Point | Domain | Score | Urgency | Market | WTP | AI-Fit | Comp | |------|-----------|--------|-------|---------|--------|-----|--------|------| | 1 | ... | B2B | 42/50 | 9 | 8 | 9 | 8 | 8 | | 2 | ... | Consumer | 38/50 | 7 | 9 | 7 | 9 | 6 | ## Chi tiết Top 3 ### #1: [Tên Pain Point] — Score: 42/50 - **Vấn đề:** [Mô tả cụ thể] - **Target user:** [Ai có vấn đề này] - **Giải pháp đề xuất:** [MVP concept] - **Revenue model:** [Cách kiếm tiền] - **Nguồn Reddit:** [Links/upvotes] - **Next step:** [Hành động cụ thể tiếp theo] ### #2: ... ### #3: ... ## Idea-to-Spec Pipeline (cho #1) - Problem Statement: ... - Target User Persona: ... - MVP Features (3-5): ... - Tech Stack Suggestion: ... - Estimated effort: ... (human) / ... (CC) Lưu vào: outputs/pain-rank-YYYY-MM-DD.md Quy tắc: Chỉ rank pain points CÓ TRONG WIKI — không bịa thêm Scoring phải giải thích lý do cho mỗi điểm số Top 1 luôn kèm Idea-to-Spec pipeline Cross-reference với [[micro-saas-pattern]], [[saas-unbundling]], [[ai-pain-points]] Ngôn ngữ & Format Wiki content: tiếng Việt có dấu (thuật ngữ kỹ thuật giữ tiếng Anh) File names: tiếng Anh, kebab-case Frontmatter: tiếng Anh Wiki links: [[kebab-case-name]] Cross-refs: mỗi trang ít nhất 2 links đến trang khác Citations: [Nguồn: filename](../raw/path) Command: setup Mục đích: Khởi tạo wiki theo một variant template có sẵn trong variants/ . Syntax: /llm-wiki setup <variant-name> Variants có sẵn: book-companion , competitive-intel , job-search Quy trình: Kiểm tra WIKI_ROOT/variants/<variant-name>/ tồn tại Nếu config.yaml chưa có → copy variants/<variant-name>/config.yaml vào WIKI_ROOT/