harvest-playbook
Harvest a finished AKARI Video project's workflow into planning/playbook.md and planning/playbook.json, grouping media by role and leaving external media as empty placeholders. Use when asked to save a project's way of working as a reusable playbook.(旧名: record-playbook)
- License 许可
- MIT
- 最近更新
- 2026-10-22
- Stars
- ★ 214
- Forks
- 25
01 前言 Front Matter
- name
- harvest-playbook
- description
- Harvest a finished AKARI Video project's workflow into planning/playbook.md and planning/playbook.json, grouping media by role and leaving external media as empty placeholders. Use when asked to save a project's way of working as a reusable playbook.(旧名: record-playbook)
02 资源文件 2
- 脚本bin/record-playbook.mjs27.7 KB
- 脚本test/record-beats.test.mjs6.5 KB
03 SKILL.md 正文
Record a playbook
Language: Respond in the user's language — conversation, questions, approval prompts, and the reports and records you write follow the language the user writes in.
Hard rules
- A playbook is a document and inventory, not an automatic execution engine. Follow
docs/contract-2026-10-15-playbook-v0.md. - Read
edit.jsonthrough a script, followingdocs/guides/edit-json-access.md. Do not read the entire file into agent context. Never copy source media, source paths, or the original edit into the playbook. - Group sources by their role. Sum the duration hints for sources serving the same role. For
ownandsitematerial, write an empty placeholder without a sample. Do not putownorsiteitems inparts. - Ask the person once for
name,category, andlicenseonly. UseCC0-1.0as the proposed license. Do not ask for each step, role, setting, or part. Fill uncertain wording with要確認and refine it from observed evidence. - Keep the Markdown headings, including
## 内訳after## 必要な素材(仮枠), and the JSON schema in sync. For an existing playbook, incrementplaybookVersion. Use atomic writes.
Procedure
- Inspect
decisions.json, the documents inplanning/, and report types in.akari/reports/for the steps and human checkpoints. If the steps cannot be recovered, use four defaults: place media, confirm script, refine cut, export. Mark uncertainwhattext要確認. - Extract aspect and fps from
edit.json, and target duration from.akari/intake.json(target.duration_s), falling back to the used timeline length when no target is set. Caption style/position, default transition, and audio roles currently have no project-level default consumed when new work is created. Preserve those planning values from an existingplanning/playbook.jsonwhen recording an applied playbook; otherwise infer transition from used cuts and audio roles from item gains where possible. Record settings as values to start the next project, not as a copy of every cut. - Examine
edit.jsonsources and availableanalysis.jsontags or speaker observations to name placeholder roles. Use.akari/asset-references.jsonand.akari/style-usage.jsonto identify reusable parts and licenses. Keep onlybuiltin,lab, andaiparts. Check used skills and reciperequiresfor required tools and skills. Derivebeatsfrom plan lines inplanning/script.jsonwhen present; otherwise use chapter headings in captions orplanning/plan.mdtogether with visual cut boundaries. Write the## 内訳table inplaybook.md. - Run
node skills/harvest-playbook/bin/record-playbook.mjs <project-root> --name <name> --category <category> [--license <license>]from a repository checkout, or use.claude/skills/harvest-playbook/bin/record-playbook.mjsfrom a scaffolded project. The helper writes deterministic structure and要確認defaults. If a video exists inexports/, it usesffmpegandffprobefrom PATH to extract 3–5 representative PNG frames intoplanning/playbook-preview/frames/and records relative paths inpreview.frames.AKARI_FFMPEGandAKARI_FFPROBEcan override those commands. If no export or tool is available, or extraction fails, the helper warns and the outcome section says to record again after export. It clears old PNG frames before each extraction. You may review and replace frame choices while keeping 3–5 frames, the playbook aspect ratio, and a maximum long edge of 640 px. Refine the step wording and role names in both files where evidence supports better names; preserve role grouping and validate after editing withnode packages/schemas/validate-playbook.mjs <project-root>/planning/playbook.jsonwhen the repository checkout is available. - Show the playbook and preview frames to the person, then run
node skills/harvest-playbook/bin/record-playbook.mjs <project-root> --installif they want the reviewed files copied to their local shelf at~/.akari/playbooks/<id>/. This standalone install does not record again, so reviewed frame choices survive. The helper changes preview paths topreview/frames/0N.pngin the shelf copy and replaces an existing copy only whenplaybookVersionis higher. - Summarize the flow, placeholder count, part count, and required tools on one screen.
04 同仓库更多 Skills
verify-project
Verify an AKARI Video project with the L0 / L1 / L2 verification ladder required by an AKARI Video task contract on the current Theia stack. Read when acceptance criteria specify levels such as L0 or L0+L1, to determine exactly what to run and how at each level.(旧名: verify)
verify-edit
Verify edit.json and optional analysis.json / captions.json / media with a deterministic CLI, then finish QA with frame inspection and reporting after PASS. Use immediately after writing or modifying edit.json, before export, and after applying review feedback.(旧名: edit-lint)
setup-remote
Set up remote access to approval reports and previews from another device such as a phone, and send footage to the workspace. Use doctor to assess Tailscale, guide installation and login (human actions), expose the preview server (default 4567) and approval report helper over tailnet-only HTTPS with tailscale serve, connect Taildrop reception to workspace inbox/, and verify access from another device. Use for requests to view reports on a phone, approve remotely, send footage from a phone, or set up remote access. Public internet exposure (funnel) is outside the default scope.
setup-project
Set up an AKARI Video project headlessly. Recursively copy `templates/project-default/`, record the template version, initialize git only when safe, and generate an HTML creation report. No app launch is needed. Use to create a video project or fill in an existing folder as an AKARI Video project.(旧名: create-project)
setup-library
Use for first-time AKARI Video setup or when the current project needs more usable assets. This first-run skill checks ffmpeg / whisper-cli (and can install with approval), reads the bundled catalog with akari assets to propose a starter pack, obtains explicit human approval, then acquires, places, validates, and updates INDEX entries. It also covers the audio library (BGM and sound effects): bulk acquisition of first-party AKARI Sounds from GitHub Releases, a free-source candidate HTML list with drop-folder matching or assisted acquisition for missing families, and keep/drop decisions in the listening gallery. Use for requests such as "I want more BGM" or "add sound effects to the library".(旧名: setup-audio-library)
setup-connections
Set up and inspect AKARI Video connections: AI-service keys, which models are allowed, cost-approval policy, the tool and media-service state, and 3D settings. Use for first-time setup, adding a provider or key later, checking what is usable (「何が使える?」 'what can I use?'), setting a key such as fal (「fal の鍵を設定したい」), 3D settings (「3D の設定を使いたい」), connection checks, and gates before paid generation or external publication. Model selection belongs to the production skills (they read the ledger and preferences); this skill decides allowed models and the cost policy. Works with `.akari/connections.json` and a free, read-only doctor.(旧名: manage-connections)(旧名: connect)