- : "bài research dài", "phân tích chương", "báo cáo" → đọc tuần tự như sách. - : "atlas", "dashboard research", "bản đồ ngành", "interactive" → click đổi view, data nhiều bảng quan hệ.
概览
- : "bài research dài", "phân tích chương", "báo cáo" → đọc tuần tự như sách. - : "atlas", "dashboard research", "bản đồ ngành", "interactive" → click đổi view, data nhiều bảng quan hệ. Mỗi sản phẩm đều đứng trên : - — mỗi con số có nguồn, đối chiếu được (Bước 5 / A3). - — mỗi lý thuyết dẫn đúng tác giả/năm/nội dung gốc (Bước 5b). Đây là gói skill dành cho các agent (Codex / ZCode / Codex CLI...). Trong agent, skill được gọi qua /longform-report (alias /longform). Skill là một thư mục chứa SKILL.md + các tài nguyên đi kèm. Đặt vào thư mục skills mà agent quét: ⚠️ để các lệnh copy template / chạy QA dùng $SKILL_DIR hoạt động đúng (xem phần Đường dẫn bên dưới). Không cần build, không cần dependency ngoài — trừ khi chạy QA script: SKILL.md dùng biến $SKILL_DIR (thư mục chứa skill) cho mọi lệnh tham chiếu file nội bộ: - : $SKILL_DIR = ~/.zcode/skills/longform-report - : $SKILL_DIR = ${CODEX_HOME:-~/.
README
以下为原文 README 节选，完整内容请查看原文。
Longform Report — Skill (2 mode: article + atlas)
Skill tạo báo cáo tự nghiên cứu HTML với 2 mode tùy theo nhu cầu:
| Mode | Khi nào | Tech | Output |
|---|---|---|---|
| article (mặc định) | Bài tư duy dài 15-40 chương, đọc tuần tự | Chart.js + minimap TOC + trình chiếu | 1 file HTML self-contained |
| atlas (mới) | Interactive research atlas/dashboard, nhiều view, multi-chart, data tách rời | SPA + hash router + ECharts/Cytoscape/SVG + JSON data | SPA + data/ + dist/ build self-contained |
Khi nào chọn mode nào?
- Article: “bài research dài”, “phân tích chương”, “báo cáo” → đọc tuần tự như sách.
- Atlas: “atlas”, “dashboard research”, “bản đồ ngành”, “interactive” → click đổi view, data nhiều bảng quan hệ.
Mỗi sản phẩm đều đứng trên hai trục song song:
- Số liệu thật — mỗi con số có nguồn, đối chiếu được (Bước 5 / A3).
- Học thuật thật — mỗi lý thuyết dẫn đúng tác giả/năm/nội dung gốc (Bước 5b).
Đây là gói skill dành cho các agent (Codex / ZCode / Codex CLI…). Trong agent, skill được gọi qua
/longform-report(alias/longform).
So sánh 2 mode
| Khía cạnh | Article | Atlas |
|---|---|---|
| Output | 1 file HTML self-contained (~50-200 KB) | SPA + data/ + dist/index.html (~500KB-1MB) |
| Architecture | HTML dài có section tuần tự | SPA shell + hash router + lazy render |
| Chart library | Chart.js | ECharts + Cytoscape + custom SVG |
| Theme | Dark-only (slate-900 + 6 accent) | Dark/light parity ([data-theme] + CSS variable) |
| Data | Nhồi trong `` HTML | JSON tách rời + validate + build script |
| QA | 8 check Playwright (qa_article.js) | 9 check (qa_atlas.js) + validate data 5 gate |
| Pitfall đã gặp | 10 (số liệu, lý thuyết, dịch, báo cáo ngụy tạo…) | + 5 atlas-specific (session note, router, theme parity, dead code, dangling refs) |
| Mẫu tham chiếu | bdong-tien, ttck-trung-quoc, bao-cao-bds-trung-quoc, giao-duc-trung-quoc, boom-tien-vixomo | china-ai-industrial-atlas, global-ai-industry-atlas |
| Chia sẻ | 1 file → gửi email/deploy tĩnh | URL shareable (#/route/param) hoặc self-contained build |
Cấu trúc
longformskill/
├── SKILL.md # Header "Chọn mode" + Workflow 7 bước article + Workflow A1-A7 atlas + 15 pitfall
├── assets/
│ ├── article_template.html # Template CORE article self-contained ({{TOKEN}} placeholder)
│ └── atlas_template/ # ⭐ MỚI — Template SPA atlas kickoff tối thiểu
│ ├── index.html # Shell CSS Grid 3 vùng + hash router + 3 view mẫu
│ ├── styles.css # Tokens + dark/light parity + view primitives + chart wrapper
│ └── app.js # IIFE + el() + Promise.all loadData + renderRoute dispose-first
├── references/
│ ├── components.md # Article: Catalog component (CORE + nâng cao)推荐工具
换一个关键词，或者移除筛选条件。
安装
npx skillfish add thanhtran-165/longformskill