michalparkola/tapestry-skills
GitHub: michalparkola/tapestry-skills
为 Claude Code 提供 YouTube 字幕下载、网页文章提取、学习内容转行动计划等生产力技能的插件集合。
Stars: 477 | Forks: 64
# AI Agent 的 Tapestry 技能
为 [Claude Code](https://claude.com/claude-code) 等 AI agent 提供的一系列生产力技能,可帮助您更高效地工作和学习。
| 技能 | 功能描述 |
|-------|-------------|
| [Learn This](#0-learn-this-) | 一个命令从任何 URL 提取内容并将其转化为行动计划。 |
| [Ship-Learn-Next](#6-ship-learn-next-action-planner) | 将学习内容转化为包含 5 次迭代且可执行交付的行动计划。 |
| [YouTube Transcript](#1-youtube-transcript-downloader) | 下载并清理 YouTube 视频字幕,支持自动去重。 |
| [Article Extractor](#2-article-extractor) | 从网页文章和博客帖子中提取干净、易读的文本。 |
| [Scrum Sage](#3-scrum-sage) | 基于 Sutherland、Ohno 和第一性原理的 AI Scrum Master 和敏捷教练。 |
| [Session Log](#4-session-log) | 总结您的会话并将其追加到每周的 agent-log 文件中。 |
| [Unblock Action](#5-unblock-action) | 在 2 分钟内将模糊的停滞任务转化为具体的下一步行动。 |
## 包含的技能
### 0. 学习这个 ⭐
统筹一切的统一工作流。只需输入 `learn-this `,它就会:
1. 检测内容类型(YouTube、文章、PDF)
2. 提取干净的内容
3. 自动创建 Ship-Learn-Next 行动计划
**一个命令。完整工作流。从学习到交付。**
### 1. YouTube Transcript Downloader
下载并清理 YouTube 视频字幕,具有自动去重和清晰的格式化功能。
**功能:**
- 使用 yt-dlp 下载字幕
- 移除重复行(解决 YouTube VTT 格式问题)
- 使用视频标题作为文件名
- 如果没有字幕,回退使用 Whisper 转录
- 自动清理临时文件
**使用场景:**
- 从教育视频中获取字幕
- 从教程中提取内容
- 归档重要的演讲/访谈
### 2. Article Extractor
从网页文章和博客帖子中提取干净、易读的内容,去除广告、导航和杂乱信息。
**功能:**
- 使用 Mozilla Readability 或 trafilatura 进行提取
- 去除广告、导航和简报注册提示
- 保存为干净的纯文本
- 使用文章标题作为文件名
- 多种提取方法,支持自动回退
**使用场景:**
- 保存文章以便离线阅读
- 提取教程内容
- 归档重要的博客帖子
- 获取没有干扰的纯净文本
### 3. Scrum Sage
基于 Jeff Sutherland、Taiichi Ohno 和第一性原理思维的 AI 驱动的 Scrum Master 和企业敏捷性教练。
**功能:**
- Sprint 分析(基础和专家模式)
- Backlog 梳理和 Story 评估指导
- 反模式检测和障碍雷达
- 流动效率 (Flow efficiency) 和认知负荷分析
- 针对成长型组织的 Scrum@Scale 建议
- 回顾会议综合分析与预测建模
**使用场景:**
- 获取关于 Scrum 机制、仪式和制品的指导
- 分析 Sprint 健康度、速度趋势和可预测性
- 消除障碍并检测系统性瓶颈
- 规划规模化策略(使用 Scrum@Scale,而非 SAFe)
- 推动回顾会议和 Backlog 梳理
- 优化团队动态和可持续的节奏
### 4. Session Log
总结您的 Claude Code 对话,并将其追加到每周的 agent-log 文件中。
**功能:**
- 按时间倒序排列的每日记录
- 自动化的 ISO 周文件命名 (`YYYY-wWW agent-log.md`)
- 用于可复用输出(计划、摘要、框架)的 CHUNK 标记
- 追加内容而不覆盖现有记录
- 支持多日会话并标明日期归属
**使用场景:**
- 记录您在一次会话中完成的工作
- 建立可搜索的每周工作日志
- 跨会话跟踪决策、输出和主题
### 5. Unblock Action
摆脱模糊或令人难以承受的任务。明确预期输出,将其限定在今天,并确定具体的下一步物理行动。
**功能:**
- 苏格拉底式但快速 —— 最多 2-3 个问题
- 将模糊的目标转化为具体的交付物
- 将多日项目限定为今天可完成的切片
- 输出包含交付物、范围和下一步的清晰行动卡
**使用场景:**
- “我需要做营销工作,但无法开始”
- “我在定价上卡住了”
- “我必须对用户引导做点什么”
- 任何您一直在逃避的模糊任务
### 6. Ship-Learn-Next Action Planner
使用 Ship-Learn-Next 框架,将被动的学习内容(字幕、文章、教程)转化为可执行的实现计划。
**功能:**
- 将建议转化为具体、可交付的迭代
- 创建包含时间线的 5 次迭代行动计划
- 强调行动而非纯粹学习
- 在每次迭代后包含反思问题
- 将计划保存为 Markdown 文件
**使用场景:**
- 将 YouTube 教程转化为行动计划
- 从文章中提取实施步骤
- 从课程内容创建学习任务
- 通过交付来构建,而不仅仅是消耗
## 安装
### Claude Code 快速安装
```
# 克隆 repository
git clone https://github.com/michalparkola/tapestry-skills.git
# 运行安装脚本
cd tapestry-skills
chmod +x install.sh
./install.sh
```
### 手动安装
#### 选项 1:个人技能(在所有项目中可用)
```
# 如果不存在则创建个人 skills 目录
mkdir -p ~/.claude/skills
# 复制 skills
cp -r learn-this ~/.claude/skills/
cp -r youtube-transcript ~/.claude/skills/
cp -r article-extractor ~/.claude/skills/
cp -r ship-learn-next ~/.claude/skills/
cp -r scrum-sage ~/.claude/skills/
cp -r session-log ~/.claude/skills/
cp -r unblock-action ~/.claude/skills/
```
#### 选项 2:项目技能(仅在特定项目中可用)
```
# 在你的项目目录中
mkdir -p .claude/skills
# 复制 skills
cp -r /path/to/tapestry-skills-for-claude-code/learn-this .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/youtube-transcript .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/article-extractor .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/ship-learn-next .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/scrum-sage .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/session-log .claude/skills/
cp -r /path/to/tapestry-skills-for-claude-code/unblock-action .claude/skills/
```
## 用法
### Learn This(推荐 - 使用这个!)
使用 Tapestry 技能最简单的方法。一个命令即可提取内容并创建您的行动计划:
```
"learn-this https://www.youtube.com/watch?v=VIDEO_ID"
"weave https://example.com/article"
"help me plan https://example.com/paper.pdf"
"make this actionable https://blog.com/post"
```
**所有这些短语均有效**:learn-this, learn this, weave, help me plan, extract and plan, make this actionable
该技能将会:
1. 检测内容类型(YouTube/文章/PDF)
2. 提取干净的内容
3. 自动创建 Ship-Learn-Next 行动计划
4. 保存这两个文件
5. 询问:“您打算什么时候交付第 1 次迭代?”
### YouTube Transcript Downloader
安装后,当您要求下载 YouTube 字幕时,Claude 将自动使用此技能:
```
"Download the transcript for https://www.youtube.com/watch?v=VIDEO_ID"
```
该技能将会:
1. 检查是否安装了 yt-dlp(如果需要则进行安装)
2. 列出可用的字幕
3. 首先尝试手动字幕,然后是自动生成的字幕
4. 转换为以视频标题为文件名的易读纯文本
5. 移除重复行
6. 清理临时文件
### Article Extractor
当您要求从 URL 提取内容时,Claude 将使用此技能:
```
"Extract the article from https://example.com/blog-post"
"Download this article without the ads"
```
该技能将会:
1. 检查提取工具(reader 或 trafilatura)
2. 下载并提取干净的文章内容
3. 去除广告、导航和杂乱信息
4. 保存为以文章标题为文件名的纯文本
5. 显示提取内容的预览
### Scrum Sage
当您询问有关 Scrum、敏捷教练或团队绩效的问题时,Claude 将激活此技能:
```
"Help me plan our next sprint"
"Analyze our team's velocity trend"
"We keep missing sprint goals — what's wrong?"
"How should we scale from 2 to 5 teams?"
```
该技能将会:
1. 通过有针对性的澄清问题评估您的现状
2. 提供基于 Scrum 机制和第一性原理的分析
3. 检测反模式并揭示隐藏的障碍
4. 推荐具体的实验(而非强制命令)
5. 根据需要提供 Sprint 健康度看板、流动图或回顾会议综合分析
### Session Log
当您想要记录您的会话时,Claude 将使用此技能:
```
"log this"
"session log"
"summarize this session"
```
该技能将会:
1. 回顾完整的对话历史
2. 识别主题、决策和可复用的输出
3. 按时间倒序将记录追加到 `YYYY-wWW agent-log.md`
4. 确认已记录的内容
### Unblock Action
当您在某个任务上卡住时,Claude 将激活此技能:
```
"unblock: work on marketing"
"I'm stuck on the pricing page"
"unstick: figure out onboarding"
```
该技能将会:
1. 提问一个问题以明确具体的输出
2. 将其限定为一天内可完成的交付物
3. 确定字面意义上的第一个物理行动
4. 输出一张可供您工作的清晰行动卡
### Ship-Learn-Next Action Planner
当您想将内容转化为行动计划时,Claude 将使用此技能:
```
"Turn this transcript into an implementation plan"
"Make this actionable using the Ship-Learn-Next framework"
```
该技能将会:
1. 读取内容文件
2. 提取可执行的教训
3. 帮助您定义具体的任务
4. 设计 5 次渐进的迭代
5. 将完整的计划保存为 Markdown 文件
## 环境要求
### YouTube Transcript Downloader
- **yt-dlp**:由技能自动安装(macOS 上使用 Homebrew,Linux 上使用 apt,或使用 pip)
- **Whisper**(可选):用于转录没有字幕的视频
pip3 install openai-whisper
### Article Extractor
- **reader**(推荐):Mozilla 的 Readability
npm install -g reader-cli
- **trafilatura**(替代方案):基于 Python 的提取器
pip3 install trafilatura
- 如果两者均未安装,则使用回退方法(准确率较低)
### Ship-Learn-Next Action Planner
- 无额外要求(使用内置工具)
## 示例
### 示例 0:Learn This 统一工作流(推荐)
```
User: "learn-this https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Claude:
🧵 Learn This Workflow Starting...
📍 Detected: youtube
📺 Extracting YouTube transcript...
✓ Saved transcript: Never Gonna Give You Up.txt
🚀 Creating action plan...
✓ Quest: Master Video Production Techniques
✓ Saved plan: Ship-Learn-Next Plan - Master Video Production.md
✅ Learn This Complete!
📥 Content: Never Gonna Give You Up.txt
📋 Plan: Ship-Learn-Next Plan - Master Video Production.md
🎯 Rep 1 (This Week): Film and edit a 60-second video
When will you ship Rep 1?
```
### 示例 1:下载并处理 YouTube 视频
```
User: "Download transcript for https://www.youtube.com/watch?v=dQw4w9WgXcQ"
Claude:
✓ Checked available subtitles
✓ Downloaded auto-generated transcript
✓ Converted to readable format
✓ Removed duplicate lines
✓ Saved to: Never Gonna Give You Up.txt
✓ Cleaned up temporary files
```
### 示例 2:提取文章
```
User: "Extract https://example.com/how-to-build-saas"
Claude:
✓ Using reader (Mozilla Readability)
✓ Extracted article: How to Build a SaaS in 30 Days
✓ Saved to: How to Build a SaaS in 30 Days.txt
Preview (first 10 lines):
[Clean article text without ads or navigation...]
```
### 示例 3:创建行动计划
```
User: "Turn this transcript into an implementation plan"
Claude:
✓ Read transcript: Build a SaaS in 30 Days.txt
✓ Extracted core lessons
✓ Created 5-rep action plan
✓ Saved to: Ship-Learn-Next Plan - Build a SaaS.md
Your quest: Launch a SaaS MVP and get first 10 customers in 4 weeks
Rep 1 (this week): Find 3 proven market opportunities
When will you ship Rep 1?
```
## 理念
这些技能建立在这样一个原则之上:**学习 = 更好地行动,而不是知道得更多**。
### Ship-Learn-Next 框架
- **Ship**:创造真实的东西(代码、内容、产品)
- **Learn**:对发生的事情进行诚实的反思
- **Next**:基于学到的经验规划下一次迭代
100 次迭代胜过 100 小时的学习。
## 贡献
发现 Bug 或想要添加功能?欢迎贡献!
1. Fork 本仓库
2. 创建您的功能分支 (`git checkout -b feature/amazing-skill`)
3. 提交您的更改 (`git commit -m 'Add amazing skill'`)
4. 推送到分支 (`git push origin feature/amazing-skill`)
5. 发起一个 Pull Request
## 许可证
MIT 许可证 - 详见 [LICENSE](LICENSE) 文件
## 致谢
- **Ship-Learn-Next 框架**:灵感来源于 ShipLearnNext GPT 方法论
- **yt-dlp**:用于下载 YouTube 内容的优秀工具
- **OpenAI Whisper**:最先进的语音识别技术
- **Mozilla Readability**:干净的文章提取算法
- **trafilatura**:Python 网络抓取和内容提取工具
## 支持
遇到问题了吗?请在 GitHub 上[提交一个 issue](https://github.com/michalparkola/tapestry-skills/issues)。
**使用 Claude Code 制作**
在 [claude.com/claude-code](https://claude.com/claude-code) 了解有关 Claude Code 的更多信息
标签:AI提示词与技能, AI智能体, Claude, CVE检测, MITM代理, URL抓取, 人工智能, 数据抓取, 文本提取, 生产力工具, 用户模式Hook绕过, 逆向工具