跳到正文
cccskills
免费在 GitHub 公开

vibe-pr

How to write a Vibe pull request title and description — simple, clear English that says what the change does, its benefit, and why, with pros and cons, charted results, and screenshots where they apply. Use when opening a pull request, or writing or rewriting a PR title or description.

中文简介正在准备中。当前显示原文说明。

集成工具GitHub

实测评分 未实测

查看安装方法

包含的文件(1)

  • SKILL.md2.6 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Writing a pull request

Write the description in simple, clear English that someone outside the code can follow. Say plainly:

  1. What it does: the change, in a sentence or two.
  2. The benefit: what is better for the user or the codebase.
  3. Why: the problem it solves, or the reason this approach was chosen.

Then, only where they apply:

  • Pros and cons: a short list, when the change is a trade-off or there was a real alternative.

  • Results: for performance, quality, or size work, show the numbers clearly and simply: a small before/after table, plus a chart. GitHub renders Mermaid, so a bar chart can go straight into the description:

    ```mermaid
    xychart-beta
        title "Track open time (ms, lower is better)"
        x-axis ["Before", "After"]
        y-axis "ms" 0 --> 120
        bar [104, 38]
    ```
    

    Label the units and say which direction is better. Name what was measured and how (the benchmark or make target), in one line.

  • Screenshots: for a new feature that can be seen, add screenshots of it in the running app, captured with the vibe-debug skill. Upload them with --attach. It works on gh pr create, gh pr edit and gh pr comment. Alt text follows the path after #. Repeat the flag for more files, up to 50. A ![alt](./after.png) reference in the body is rewritten to the uploaded file. A file the body does not reference is appended at the end. So write the body with the references where the images belong, then pass each file:

    gh pr create --title "..." --body-file pr.md --attach './before.png#Before' --attach './after.png#After'
    

    To add or replace pictures on a PR that already exists, edit its description with gh pr edit <n> --body-file pr.md --attach './a.png#alt'. Do not post a comment for this. A comment is a new post on a public thread, and AGENTS.md says to ask before one.

Keep it short. Leave out file-by-file narration, internal jargon, and anything the diff already shows. A reviewer should be able to read the description and know what changed, why it matters, and what it costs.

The title follows the repo's existing style: area: What it does, in the imperative (see git log --oneline).

Never name or credit the AI agent or tool that helped write the change (AGENTS.md, "No agent attribution").

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Check and document Vibe's audio quality and conformance. Runs public conformance and torture corpora (IETF CELLAR FLAC files, ISO/IEC 14496-26 Layer III, FFmpeg FATE samples, McGill WAVE and AIFF samples, EBU BW64 tests, Chromium and Firefox media tests, TagLib test data) through the real decoders. Valid files must match their FLAC MD5 or reference decode within the ISO accuracy limits, decode to the length the handle states and seek exactly. Every file must finish with finite samples. Also regenerates docs/audio-quality.md's charts and its corpus results matrix. Use after changing a decoder, a parser, the file-open path or the resampler, before a release, when asked whether decoding is correct or conformant, or to update the audio quality page.

中文简介正在准备中。当前显示原文说明。

cmicali/vibe492026年10月24日 更新

Launch, drive, inspect, and visually verify the Vibe app — macOS, and the iOS simulator loop (launch-ios.sh, the debug-ios.sh command channel, the drive-ios.sh touch driver for taps and drags, silent flags, screenshots, host-side log streaming). Use whenever a change needs end-to-end verification, a screenshot of the running app, playback/UI state inspection, or appearance (light/dark) testing.

中文简介正在准备中。当前显示原文说明。

cmicali/vibe492026年10月24日 更新

vibe-perf

免费

Measure Vibe's performance and compare two versions of the code. VibeBenchComponents drives the production decode, open, seek, resample, pitch, waveform, tempo/key, meter, metadata and cache code in-process with no app, counting retired instructions as well as wall and CPU time; perf.py builds it at any git ref and runs two refs interleaved (make bench-components); profile.sh finds one benchmark's hotspots; --analyze proves an analyzer change exact. Also owns the performance page (docs/performance.md): component charts per release (make bench-components-releases), app benchmarks (make bench-app), both (make bench-releases), redraw (make bench-report). Use before and after any change that could move cost, to find where time goes, to choose between implementations, to back a performance claim with numbers, or when asked to update, rerun or regenerate the performance page for a release, pre-release or new machine.

中文简介正在准备中。当前显示原文说明。

cmicali/vibe492026年10月24日 更新

Build, sign, notarize, and ship Vibe on both platforms — the macOS Developer ID (make release) and App Store (make appstore-build) paths, the iOS App Store path (make appstore-build-ios), the GitHub release publish (make github-release), the Homebrew tap bump (make brew-set-version), the localized product-page metadata upload (make appstore-upload-metadata), the shared App Store Connect API key and its Admin-role requirement, and the signing traps each script preflights. Use when cutting a release, distributing a build, shipping or TestFlighting the iOS app, updating App Store copy or screenshots, or debugging a signing/notarization/upload failure.

中文简介正在准备中。当前显示原文说明。

cmicali/vibe492026年10月24日 更新

Stress, soak, fuzz, and torture the running Vibe app against a folder of real audio files — seeded random controller actions without pointer input, with consistency, leak, hang, and crash oracles, a single-playlist skip/seek torture suite for the delivery races that only open when transport outruns the metadata scan, a deterministic cloud-loading scenario suite over a fake file provider (download ordering, the foreground hold, the open deadline), plus the sanitizer (ASan/UBSan/TSan) and malloc-debug build matrix. Use for soak or endurance runs, memory-leak and resource-growth hunting, race hunting, fuzzing the file-loading path, hammering skips and seeks on a large playlist, testing cloud/placeholder loading order, or minimizing a failing run to a repro.

中文简介正在准备中。当前显示原文说明。

cmicali/vibe492026年10月24日 更新

The localization pipeline — VibeStrings.h registry conventions, the extract-strings.sh preprocessor pass and extractionState rules, catalog and InfoPlist.xcstrings mechanics, authoring translations and the untranslated-keys release gate, translation terminology and per-language conventions, the pseudolocale audit, and the localized App Store product page. Use when adding or rewording any user-facing string, translating catalog keys, editing VibeStrings.h or the .xcstrings catalogs, debugging make strings / make check-strings, testing a language, or updating App Store copy or screenshots.

中文简介正在准备中。当前显示原文说明。

cmicali/vibe492026年10月24日 更新

查看 cmicali 的全部技能

报告此技能的问题