技能 2026-09-24 18:25 UTC
hyperframes-community-skillsv2.3.2
版本【2.3.2】由提交人 jmoran-heygen 提交,主要更新类型为:功能特性新增与扩展。提交说明:Add day-in-my-life community skill (#13)。为项目引入了新的能力与模块支持。
Commit提交信息原文
Add day-in-my-life community skill (#13) ## What it does Makes a 60 to 75 second hand-drawn ink film of one ordinary session between an agent and its user: "a day in my life as <name>'s agent". - The agent reads its own local Claude Code history and works out the user's routine from its tool calls: reading, editing, tests, commits, renders, whatever the history shows. - It tells one session in time order, using the user's own words: the opener, go-aheads, check-ins, corrections, praise, and memory titles. - A coder gets a coding day (a terminal going red, then green, then a merged PR). A video maker gets a video day. - The look is two-tone p5.brush ink that boils at 8 fps, with a hand-lettered title. - The score is strings composed note for note on the film's clock. The typed `claude` is the theme, and every knock, test result and lamp-out is a note at the same timestamp as its drawing. ## Why it belongs here It is one personal workflow built on one engine (a p5.brush canvas painter driven through the `hf-seek` bridge), too specialized for the curated skill set. ## Contents - `SKILL.md`: workflow, requirements, rules, verification. - `references/`: - `story.md`: routine → timeline → lines → privacy gate. - `look.md`: the ink kit and how to add a chapter type. - `score.md`: the arrangement and one recipe per chapter type. - `scripts/`: - `harvest.py`: local receipts and the routine. - `new-film.mjs`: scaffolds a film and validates `story.json`. - `shoot.mjs`: stills and design-pass sheets. - `score.py`: composes, synthesizes and masters the score, and writes MIDI. - `qc.py`: render checks. - `setup.sh`, `package.json`, `package-lock.json`, `requirements.txt`: pinned dependencies. - `assets/kit/`: `brush-ink.js`, `props.js`, `film.js`, `hf-bridge.js`. - `assets/template/`: `index.html`, `scenes.js` (16 chapter types), `archetypes.json` (the shared clock), `story.example.json` (a fictional user). ## Commands, network, credentials, cost - `sh scripts/setup.sh`, run manually once: `npm ci` from the lockfile. It installs p5 2.3.2, p5.brush 2.2.1 and puppeteer 25.9.0; puppeteer fetches its pinned Chrome for Testing from Google. - `python3 -m pip install -r scripts/requirements.txt`: numpy 2.0.2, scipy 1.13.1. - `npx --yes hyperframes@0.8.70` for check and render, from registry.npmjs.org. Needs Node 22+. - `ffmpeg`, run locally for mastering, QC and render. - At preview and render time the page loads the Gochi Hand font from Google Fonts. - No credentials, no paid calls, nothing uploaded. ## Side effects and privacy - **Reads, locally:** - `~/.claude/projects/*/*.jsonl`: the user's messages and the agent's own tool calls. - `~/.claude/projects/*/memory/*.md`. - The `CLAUDE.md` of the projects those transcripts point at. - It skips transcripts modified in the last 30 minutes (the session making the film) unless `--keep-current` is passed. - **Writes** only inside the film folder: `receipts.json`, `story.json`, `story.js`, `music/`, `renders/`. These hold the user's words, and SKILL.md says never to commit or share them. - **The user approves every on-screen line, with its source, before anything renders** (`story.approved`). - `new-film.mjs --sync` refuses credentials, email addresses and file paths, and warns on URLs. - `harvest.py` flags secrets, emails, paths, URL domains and capitalised names. It also attaches each line's session opener so the agent can judge context. ## Tests - `bash .github/scripts/validate-skills.sh`: Validated 6 skill(s). - Smoke test with the fictional example (a coding day): scaffold, then `score.py` (372 notes, -17.1 LUFS), then `hyperframes check` (0 errors), then render (66.25 s, 1590 frames, 57 s on an M3 Pro GPU), then `qc.py`, which passes all 18 checks: - 8 drawings a second, every change on the 3-frame grid, no hold longer than 3 frames - a fully inked frame at every cut - picture black and audio silent within one frame at the lamp-out - -17.2 LUFS, -2.5 dBTP - Regression against the film the skill was built from (a real user's history, not included): the composer reproduces its 424 notes exactly, and stills match within 0.6% of pixels. - Failure paths: - A story with a trailing-period caption, an email, a credential-like string and a misplaced `kept` chapter is refused with four errors. - Scaffolding into a folder holding other files is refused. - A fresh agent given only the skill: - harvested a real history, built a 13-chapter story, and produced the design-pass sheet - reported 13 unclear instructions and layout bugs, all fixed in this version: candidate order, pasted-text filtering, session context, sticky fit, labels showing through the new book, per-chapter check times, the receipts format ## Dependencies and licenses - p5 2.3.2 (LGPL-2.1), p5.brush 2.2.1 (MIT), puppeteer 25.9.0 (Apache-2.0). Pinned by `package-lock.json` and copied into each film's `vendor/` at scaffold time. Nothing vendored in this repo. - numpy 2.0.2 and scipy 1.13.1 (BSD-3-Clause). - Gochi Hand (SIL OFL 1.1), via Google Fonts. ## Residual risk - The film shows the user's real words. The privacy gate relies on the agent following it and the user reading the approval table. The heuristics miss lowercase names and can't know which repos are private. - The strings are synthesized (additive bowed tones, Karplus-Strong pizzicato), so they sound hand-made, not orchestral. `music/strings.mid` can be re-voiced with a sampled library; `score.py --master-only` then re-masters it. - The page paints with WebGL, so renders run locally with `--browser-gpu`. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Miguel Ángel <miguel.sierra@heygen.com>