Skip to content

anbeime/skill / skills/native-subtitle-quote-image/native-subtitle-quote-image

native-subtitle-quote-image

Verified

将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube 金句长图、台词截图、不重绘字幕、自定义中文台词,或调整主图比例、字幕区域、台词间隔和美感时使用。

FileKindSize
.codex-plugin/plugin.jsonconfig1.5 KB
.github/ISSUE_TEMPLATE/bug_report.ymlconfig1.2 KB
.github/ISSUE_TEMPLATE/config.ymlconfig275 B
.github/ISSUE_TEMPLATE/feature_request.ymlconfig827 B
.github/agent/implement.mdmarkdown1.7 KB
.github/agent/review.mdmarkdown1.1 KB
.github/agent/triage.mdmarkdown2.7 KB
.github/labels.jsonconfig2.5 KB
.github/pull_request_template.mdmarkdown432 B
.github/release.ymlconfig345 B
.github/scripts/apply_triage.pyscript6.6 KB
.github/scripts/dump_issue.shscript509 B
.github/scripts/intake_feedback.pyscript4.0 KB
.github/scripts/open_agent_pr.shscript3.7 KB
.github/workflows/agent-implement.ymlconfig4.4 KB
.github/workflows/agent-review.ymlconfig2.8 KB
.github/workflows/agent-triage.ymlconfig4.6 KB
.github/workflows/claude.ymlconfig2.9 KB
.github/workflows/feedback-intake.ymlconfig2.0 KB
.github/workflows/release-label.ymlconfig1.2 KB
.github/workflows/release.ymlconfig3.5 KB
.github/workflows/sync-labels.ymlconfig798 B
.github/workflows/validate.ymlconfig1.3 KB
.gitignoreother169 B
CLAUDE.mdmarkdown1.6 KB
LICENSEother1.0 KB
README.mdmarkdown31.5 KB
README_EN.mdmarkdown33.9 KB
README_KO.mdmarkdown37.0 KB
SKILL.mdskill md22.4 KB
VERSIONother7 B
agents/openai.yamlconfig467 B
assets/banner-en.jpgbinary417.7 KB
assets/banner-ko.jpgbinary417.9 KB
assets/banner-zh.jpgbinary434.0 KB
assets/native-subtitle-quote-image-icon.pngbinary275.1 KB
docs/agent-workflow.mdmarkdown8.2 KB
examples/README.mdmarkdown6.0 KB
examples/gallery-manifest.jsonconfig7.6 KB
examples/gallery/en/darby-saxbe-shared-care.jpgbinary313.5 KB
examples/gallery/en/mikayla-johnson-define-outcome.jpgbinary294.4 KB
examples/gallery/en/rick-rubin-be-yourself.jpgbinary355.4 KB
examples/gallery/ko/codie-sanchez-321-speaking.jpgbinary331.9 KB
examples/gallery/ko/inaya-mcmillan-money-program.jpgbinary391.2 KB
examples/gallery/ko/masud-husain-starting-hill.jpgbinary266.2 KB
examples/gallery/zh/chen-shu-simple-life.jpgbinary328.2 KB
examples/gallery/zh/girls-on-the-bus-native.jpgbinary163.5 KB
examples/gallery/zh/rick-rubin-creative-clouds.jpgbinary339.9 KB
examples/scripts/en/darby-saxbe-shared-care.jsonconfig436 B
examples/scripts/en/mikayla-johnson-define-outcome.jsonconfig419 B
examples/scripts/en/rick-rubin-be-yourself.jsonconfig426 B
examples/scripts/ko/codie-sanchez-321-speaking.jsonconfig462 B
examples/scripts/ko/inaya-mcmillan-money-program.jsonconfig491 B
examples/scripts/ko/masud-husain-starting-hill.jsonconfig496 B
examples/scripts/zh/chen-shu-simple-life.jsonconfig747 B
examples/scripts/zh/girls-on-the-bus-native.jsonconfig1.0 KB
examples/scripts/zh/rick-rubin-creative-clouds.jsonconfig404 B
references/end-to-end-workflow.mdmarkdown17.2 KB
references/troubleshooting.mdmarkdown5.7 KB
references/visual-style.mdmarkdown10.2 KB
references/yt-dlp-and-transcripts.mdmarkdown14.0 KB
requirements.txtmanifest33 B
scripts/bump_version.pyscript2.7 KB
scripts/check_environment.pyscript8.9 KB
scripts/check_update.pyscript8.0 KB
scripts/native_subtitle_stitch.pyscript59.1 KB
scripts/render_banners.pyscript7.4 KB
scripts/submit_feedback.pyscript2.6 KB
scripts/validate_repo.pyscript9.0 KB
tests/test_agent_workflow.pyscript8.9 KB
tests/test_check_update.pyscript5.0 KB
tests/test_native_subtitle_stitch.pyscript63.2 KB
tests/test_render_banners.pyscript2.6 KB
tests/test_text_encoding.pyscript3.2 KB

docs/agent-workflow.md

View on GitHub
# Agent 驱动的反馈 → 发版工作流

本项目用一套 GitHub Actions 把「收集反馈 → 评估 → 编码测试 → PR → 审查合并 → 发包」串起来。Agent 负责评估、写代码、跑测试和初审,**合并永远由维护者决定**。

```
社区 / 社媒 / GitHub ──► ① Feedback Intake ──► issue(needs-triage)
                                                   │
                                                   ▼
                                         ② Agent Triage 评估可行性
                     ┌──────────────┬──────────────┼─────────────────┐
                needs-info       rejected /     accepted          accepted
               (追问用户)      duplicate     (自动条件满足)  (需维护者确认)
                                                   │                 │ 加 agent:implement
                                                   ▼                 ▼
                                         ③ Agent Implement 编码 + 测试
                                                   │
                                                   ▼
                                         ④ 自动提交 PR(agent/issue-N)
                                                   │
                                                   ▼
                          ⑤ Validate CI + Agent Review ──► 维护者审查合并(可 @claude 继续改)
                                                   │
                                                   ▼
                              ⑥ Release:按 release:* 标签升版本、打 tag、发 GitHub Release
```

## 各阶段

| 阶段 | 工作流 | 触发 | 产出 |
|---|---|---|---|
| ① 收集 | `feedback-intake.yml` | `repository_dispatch`(类型 `feedback`)、手动运行、Discussions 的 Ideas/Feedback 分类新帖 | 带 `needs-triage`、`source:*` 的 issue;按原帖链接去重 |
| ① 收集 | Issue 模板 | 用户在 GitHub 提 issue | 结构化的 bug / 功能建议 |
| ② 评估 | `agent-triage.yml` | 新 issue、维护者评论 `/triage`、被 ① 调用 | `triage:*`、`type:*`、`size:*`、`risk:*`、`release:*` 标签 + 评估评论 |
| ③ 编码 | `agent-implement.yml` | 满足自动条件、维护者加 `agent:implement`、手动运行 | 改动 + 测试,跑通 `validate_repo.py` 与 `unittest` |
| ④ PR | `.github/scripts/open_agent_pr.sh` | ③ 完成后 | `agent/issue-N` 分支上的 PR,`Closes #N`;测试失败则提交为草稿 |
| ⑤ 审查 | `validate.yml`、`agent-review.yml`、`release-label.yml`、`claude.yml` | PR 打开/更新;维护者 `@claude` | CI 结果、Agent 行内审查意见;`@claude` 可按意见继续改 |
| ⑥ 发包 | `release.yml` | 带 `release:patch/minor/major` 的 PR 合并;或手动运行 | 升版本号、`vX.Y.Z` tag、附 Skill 压缩包的 GitHub Release |

已安装的 Skill 会通过 `check_update.py` 读取 Latest Release 提示用户升级,所以 ⑥ 发出的版本会自动触达用户。

## 什么时候自动进入编码

评估结论同时满足以下条件,Agent 才会**不经人工**直接开始编码:

- 仓库变量 `AGENT_AUTO_IMPLEMENT` 为 `true`(默认关闭);
- 结论 `accepted`,类型是 bug / feature / docs,规模 `S` 或 `M`,风险不是 `high`;
- issue 作者是仓库 Owner / Member / Collaborator,或反馈来自维护者控制的收集入口(社媒、社区)。

其他 `accepted` 的 issue 会打上 `status:awaiting-maintainer`,维护者加 `agent:implement` 标签即可放行。不想让 Agent 碰的 issue 加 `agent:skip`。

## 一次性配置

1. **Agent 凭据**(Settings → Secrets and variables → Actions → Secrets,二选一)
   - `ANTHROPIC_API_KEY`:Anthropic API key;或
   - `CLAUDE_CODE_OAUTH_TOKEN`:在本地运行 `claude setup-token` 生成。
2. **允许 Actions 创建 PR**(Settings → Actions → General → Workflow permissions):勾选 **Allow GitHub Actions to create and approve pull requests** 并保存。不打开时 Agent 能推送分支,但建 PR 会报 `GitHub Actions is not permitted to create or approve pull requests`;配置了 `AGENT_GITHUB_TOKEN` 则不依赖这个开关。
3. **可选 Secrets**
   - `AGENT_GITHUB_TOKEN`:fine-grained PAT 或 GitHub App token(权限 Contents、Pull requests、Issues 读写)。配置后 Agent 建的 PR 会正常触发 CI;不配置时工作流会用 `workflow_dispatch` 补触发 Validate 与 Agent Review。
   - `RELEASE_TOKEN`:能绕过 `main` 分支保护的 token,供发版时推送版本提交和 tag。`main` 未开保护时可不配。
4. **Variables**
   - `AGENT_AUTO_IMPLEMENT`:`true` 开启自动编码,默认关闭。
   - `AGENT_MODEL`:可选,指定 Agent 使用的模型;留空用默认值。
5. **标签**:Actions 页手动运行一次 **Sync Labels**(之后修改 `.github/labels.json` 会自动同步)。
6. **@claude 交互**:在本地 Claude Code 里运行 `/install-github-app`,或安装 [Claude GitHub App](https://github.com/apps/claude)。
7. **分支保护**(Settings → Branches → `main`):要求 PR、至少 1 个审批、必需检查 `validate (3.10)`、`validate (3.13)`、`check`(Release Label)。
8. **Discussions**(可选):开启后建一个名为 `Ideas` 或 `Feedback` 的分类,新帖会自动转为 issue。

## 接入社媒 / 社区反馈

任何能发 HTTP 请求的工具(n8n、Zapier、飞书/企业微信机器人、定时爬取脚本)都可以把反馈送进来:

```bash
curl -X POST https://api.github.com/repos/chengyi-ai/native-subtitle-quote-image/dispatches \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json" \
  -d '{"event_type":"feedback","client_payload":{
        "source":"social","platform":"小红书",
        "url":"https://www.xiaohongshu.com/explore/xxx",
        "author":"某用户","title":"希望支持 9:16 竖版","body":"原帖内容……"}}'
```

或者用仓库自带的命令行:

```bash
GITHUB_TOKEN=... python scripts/submit_feedback.py \
  --platform 微博 --url https://weibo.com/xxx --title "导出后字幕糊了" --body "原帖内容……"
```

也可以在 Actions → **Feedback Intake** → Run workflow 里手动填写。`source` 取 `social`(社媒)或 `community`(群聊、论坛、Discussions)。同一个 `url` 只会登记一次,再次收到只在原 issue 下追加记录。

用于调用 dispatch 的 token 只需要本仓库的 Contents 写权限;它代表维护者,所以经它登记的反馈视为已过一道人工筛选,可以走自动编码。

## 安全设计

- **用户文本不进 prompt**:issue 内容写入 `.agent-in/issue.json`,Agent 被告知它是不可信数据。
- **评估 Agent 没有执行权**:只有 Read / Glob / Grep / Write,不能运行命令,也没有 GitHub 写权限;标签和评论由 `apply_triage.py` 根据 JSON 结论写入,并过滤疑似凭据。
- **编码 Agent 不能提交和推送**:checkout 不保留凭据;只允许运行 Python 和只读 git 命令。改动 `.github/`、`.codex-plugin/` 或 `VERSION` 会被拒绝。
- **外部用户提的 issue 不会自动编码**,必须维护者加 `agent:implement`。
- **fork 来的 PR 不跑 Agent Review**(拿不到密钥),由维护者手动 `@claude` 或审查。
- **合并永远需要人工审批**,发版只在合并后、且 PR 带明确 `release:*` 标签时发生。

## 常用操作

| 想做什么 | 怎么做 |
|---|---|
| 重新评估某个 issue | 在 issue 下评论 `/triage` |
| 让 Agent 实现某个 issue | 加 `agent:implement` 标签 |
| 让 Agent 按审查意见修改 PR | 在 PR 下评论 `@claude 请按上面的意见修改` |
| Agent 报 “not permitted to create or approve pull requests” | 按「一次性配置」第 2 步打开开关,再给 issue 重新加 `agent:implement` |
| Agent 失败后接手 | 查看 `agent:failed` 的 issue 与运行日志,在草稿 PR 上继续 |
| 合并后不发版 | PR 用 `release:skip` |
| 手动发版 | Actions → Release → Run workflow,选 patch / minor / major |
| 本地升版本号 | `python scripts/bump_version.py patch` |
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall