tutor-setup by roundtable02/tutor-skills
npx skills add https://github.com/roundtable02/tutor-skills --skill tutor-setup切勿访问当前工作目录 (CWD) 之外的文件。 所有源文件扫描、读取和金库输出必须保持在 CWD 及其子目录内。如果用户提供了外部路径，请要求他们先将文件复制到 CWD 中。
调用时，自动检测模式：
package.json、pom.xml、build.gradle、Cargo.toml、go.mod、Makefile、*.sln、pyproject.toml、、广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
setup.pyGemfile.git/ 是唯一指示符且不存在源代码文件 (*.ts、*.py、*.java、*.go、*.rs 等)，则默认为文档模式。将知识源 (PDF、文本、网页、epub) 转换为学习笔记。模板：templates.md
**/*.pdf、**/*.txt、**/*.md、**/*.html、**/*.epub (排除 node_modules/、.git/、dist/、build/、StudyVault/)。呈现给用户确认。PDF → 仅使用 pdftotext CLI (通过 Bash 工具运行)。切勿直接对 PDF 文件使用 Read 工具 — 它会将页面渲染为图像并浪费 10-50 倍的令牌。先转换为 .txt，然后读取 .txt 文件。
pdftotext "source.pdf" "/tmp/source.txt"
如果 pdftotext 未安装，请先安装：brew install poppler (macOS) 或 apt-get install poppler-utils (Linux)。
URL → WebFetch
其他格式 (.md、.txt、.html) → 直接读取。
.txt 文件 — 理解范围、结构、深度。仅从转换后的文本工作，切勿从原始 PDF 工作。{ 源文件 → 实际主题 → 页码范围 }等深规则：即使是被简要提及的子主题，也必须获得一份完整的专用笔记，并辅以教科书级别的知识。
在创建笔记之前定义标签词汇：
#data-hazard)根据 templates.md 创建 StudyVault/ 并按编号文件夹分组。每个文件包含 3-5 个相关概念。
创建 00-Dashboard/：MOC、快速参考、考试陷阱。参见 templates.md。
→ [[概念笔记]] 链接；所有关键公式根据 templates.md。关键规则：
source_pdf、part、keywords (强制)source_pdf: 원문 미보유[[wiki-links]]、标注 ([!tip]、[!important]、[!warning])、比较表格 > 散文根据 templates.md。关键规则：
> [!answer]- 정답 보기 折叠标注> [!hint]- / > [!summary]- 折叠标注## 相关概念 包含 [[wiki-links]]## 相关笔记[[概念笔记]] 链接根据 quality-checklist.md 的文档模式部分进行验证。修复并重新验证，直到所有检查通过。
从源代码项目生成新开发者入职 StudyVault。完整工作流：codebase-workflow.md 模板：codebase-templates.md
| 阶段 | 名称 | 关键行动 |
|---|---|---|
| C1 | 项目探索 | 扫描文件，检测技术栈，读取入口点，映射目录布局 |
| C2 | 架构分析 | 识别模式，追踪请求流，映射模块边界和数据流 |
| C3 | 标签标准 | 定义 #arch-*、#module-*、#pattern-*、#api-* 标签注册表 |
| C4 | 金库结构 | 创建 StudyVault/，包含仪表板、架构、按模块、DevOps、练习文件夹 |
| C5 | 仪表板 | MOC (模块地图 + API 接口 + 入门指南 + 入职路径) + 快速参考 |
| C6 | 模块笔记 | 按模块笔记：目的、关键文件、公共接口、内部流程、依赖关系 |
| C7 | 入职练习 | 代码阅读、配置、调试、扩展练习 (每个主要模块 5+ 个) |
| C8 | 互连 | 交叉链接模块、架构 ↔ 实现、练习 ↔ 模块 |
| C9 | 自我审查 | 根据 quality-checklist.md 的代码库模式部分进行验证 |
详细的分阶段说明请参见 codebase-workflow.md。
每周安装数
473
仓库
GitHub 星标数
536
首次出现
2026 年 2 月 24 日
安全审计
安装于
codex468
opencode466
gemini-cli464
kimi-cli462
amp462
cursor462
NEVER access files outside the current working directory (CWD). All source scanning, reading, and vault output MUST stay within CWD and its subdirectories. If the user provides an external path, ask them to copy the files into CWD first.
On invocation, detect mode automatically:
package.json, pom.xml, build.gradle, Cargo.toml, go.mod, Makefile, *.sln, pyproject.toml, setup.py, Gemfile.git/ is the sole indicator and no source code files (*.ts, *.py, *.java, *.go, *.rs, etc.) exist, default to Document Mode.Transforms knowledge sources (PDF, text, web, epub) into study notes. Templates: templates.md
**/*.pdf, **/*.txt, **/*.md, **/*.html, **/*.epub (exclude node_modules/, .git/, dist/, build/, StudyVault/). Present for user confirmation.Equal Depth Rule : Even a briefly mentioned subtopic MUST get a full dedicated note supplemented with textbook-level knowledge.
Define tag vocabulary before creating notes:
#data-hazard)Create StudyVault/ with numbered folders per templates.md. Group 3-5 related concepts per file.
Create 00-Dashboard/: MOC, Quick Reference, Exam Traps. See templates.md.
→ [[Concept Note]] link; all key formulasPer templates.md. Key rules:
source_pdf, part, keywords (MANDATORY)source_pdf: 원문 미보유[[wiki-links]], callouts ([!tip], [!important], [!warning]), comparison tables > prosePer templates.md. Key rules:
> [!answer]- 정답 보기 fold callout> [!hint]- / > [!summary]- fold callouts## Related Concepts with [[wiki-links]]## Related Notes on every concept note[[Concept Note]] linksVerify against quality-checklist.md Document Mode section. Fix and re-verify until all checks pass.
Generates a new-developer onboarding StudyVault from a source code project. Full workflow: codebase-workflow.md Templates: codebase-templates.md
| Phase | Name | Key Action |
|---|---|---|
| C1 | Project Exploration | Scan files, detect tech stack, read entry points, map directory layout |
| C2 | Architecture Analysis | Identify patterns, trace request flow, map module boundaries and data flow |
| C3 | Tag Standard | Define #arch-*, #module-*, #pattern-*, #api-* tag registry |
| C4 | Vault Structure | Create StudyVault/ with Dashboard, Architecture, per-module, DevOps, Exercises folders |
See codebase-workflow.md for detailed per-phase instructions.
Weekly Installs
473
Repository
GitHub Stars
536
First Seen
Feb 24, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykWarn
Installed on
codex468
opencode466
gemini-cli464
kimi-cli462
amp462
cursor462
Gmail过滤器创建教程 - 使用Google Workspace CLI自动分类邮件与添加标签
6,700 周安装
PDF →pdftotext CLI ONLY (run via Bash tool). NEVER use the Read tool directly on PDF files — it renders pages as images and wastes 10-50x more tokens. Convert to .txt first, then Read the .txt file.
pdftotext "source.pdf" "/tmp/source.txt"
If pdftotext is not installed, install it first: brew install poppler (macOS) or apt-get install poppler-utils (Linux).
URL → WebFetch
Other formats (.md, .txt, .html) → Read directly.
.txt files — understand scope, structure, depth. Work exclusively from the converted text, never from the raw PDF.{ source_file → actual_topics → page_ranges }| C5 |
| Dashboard |
| MOC (Module Map + API Surface + Getting Started + Onboarding Path) + Quick Reference |
| C6 | Module Notes | Per-module notes: Purpose, Key Files, Public Interface, Internal Flow, Dependencies |
| C7 | Onboarding Exercises | Code reading, configuration, debugging, extension exercises (5+ per major module) |
| C8 | Interlinking | Cross-link modules, architecture ↔ implementations, exercises ↔ modules |
| C9 | Self-Review | Verify against quality-checklist.md Codebase Mode section |