Agent Skills › different-ai/openwork › fix-design-notes

fix-design-notes

GitHub

用于修复前端 PR 中设计审查反馈的 UI 问题。流程包括读取证据检查中的设计备注,定位并修改代码以符合设计规范,重新运行测试验证修复效果,或合理保留备注。

.opencode/skills/fix-design-notes/SKILL.md different-ai/openwork

Trigger Scenarios

PR 设计审查标记为 Worth fixing UI 布局或样式不符合设计规范 需要修复 Evidence preview 检查中的设计备注

Install

npx skills add different-ai/openwork --skill fix-design-notes -g -y
More Options

Non-standard path

npx skills add https://github.com/different-ai/openwork/tree/dev/.opencode/skills/fix-design-notes -g -y

Use without installing

npx skills use different-ai/openwork@fix-design-notes

指定 Agent (Claude Code)

npx skills add different-ai/openwork --skill fix-design-notes -a claude-code -g -y

安装 repo 全部 skill

npx skills add different-ai/openwork --all -g -y

预览 repo 内 skill

npx skills add different-ai/openwork --list

SKILL.md

Frontmatter
{
    "name": "fix-design-notes",
    "description": "Design notes on a PR, \"Design review (advisory)\" in the evidence check, \"worth fixing\", layout.split-row, OW-LIST, a reviewer says the UI looks off. Use to read what the design review found on a PR's screenshots, fix it in code, and prove the note is gone."
}

Skill: Fix design notes

Every PR that records evidence screenshots gets an advisory design review. Its notes ride in the Evidence preview check, next to the evidence they are about: one summary line, and the notes as the check's text. They never change the evidence verdict, but a note marked Worth fixing is a defect a careful designer would send back. Fix it, or say in the PR why the screen is right.

Read the notes

sha=$(gh pr view <pr> --json headRefOid --jq .headRefOid)
check() { gh api "repos/{owner}/{repo}/commits/$sha/check-runs?check_name=Evidence%20preview" --jq ".check_runs[0].output.$1"; }
check summary   # ends with "Design review (advisory): 3 notes, 1 worth fixing." or "no notes."
check text      # the notes, then the same notes as JSON

Each note gives:

Field Use it to
rule layout.* was measured from the DOM (exact). S2, V2… are DESIGN.md; OW-* are the OpenWork Design rules in evals/design-review/rubric.md (judged from pixels; may vary run to run)
Screenshot the spec step that took it, and the spec file
Where in the code grep for the hook ([data-library-row="…"] → data-library-row) or the class list to find the component
Reproduce the command that re-records the screenshots and reviews them locally

The JSON block at the end of the check text has the same notes for scripts. The screenshots themselves are in the review report the check links to.

Reproduce, fix, verify

  1. Run the note's reproduce command. Read --json output, not prose: pnpm evals:e2e <slug> --local && pnpm --dir evals design:review -- --test-run latest --json (judged notes need OPENAI_API_KEY or ANTHROPIC_API_KEY; measured ones do not).
  2. Find the component from the hook or class list. Read DESIGN.md and the rule in evals/design-review/rubric.md before changing anything: the fix follows the team's pattern, not the note's wording.
  3. Fix it in the product code, never in the spec or the rubric.
  4. Re-run the same command. The note must be gone and no new Worth fixing note may appear. Look at the screenshot yourself: a passing rule is not a good screen.
  5. Push. CI re-runs the review; the evidence check's summary says Design review (advisory): no notes. or lists only what you decided to keep.

When the screen is right

A judged note can be wrong, and a team decision can outrank a generic rule. Leave the code, and put one line in the PR body under Evidence: Design review: kept OW-LIST-HEADER on the Library; the columns are compared (see DESIGN.md S2). Do not edit the rubric to silence a note in the same PR that triggers it.

Rules

  • Measured notes are facts about the layout; do not argue with the numbers.
  • Never chase a judged note across runs: if it flips between runs, it is low confidence. Fix what you can see in the screenshot.
  • Fix the shared component when the hook points at one (a row used by every list), not each screen.

Version History

  • b73f6c6 Current 2026-10-19 21:56

Same Skill Collection

.opencode/skills/add-a-feature/SKILL.md
.opencode/skills/agent-first-screenshots/SKILL.md
.opencode/skills/browser-automation/SKILL.md
.opencode/skills/build-a-witness/SKILL.md
.opencode/skills/cloud-dashboard-walkthrough/SKILL.md
.opencode/skills/create-plugin/SKILL.md
.opencode/skills/daytona-chrome-cdp/SKILL.md
.opencode/skills/daytona-cloud-instance/SKILL.md
.opencode/skills/daytona-cloud-server/SKILL.md
.opencode/skills/daytona-dev/SKILL.md
.opencode/skills/daytona-electron-den/SKILL.md
.opencode/skills/daytona-electron-test/SKILL.md
.opencode/skills/daytona-flow-validator/SKILL.md
.opencode/skills/daytona-recording-artifacts/SKILL.md
.opencode/skills/daytona-secrets-volume/SKILL.md
.opencode/skills/daytona-seeded-cloud-demo/SKILL.md
.opencode/skills/daytona-windows-cert/SKILL.md
.opencode/skills/daytona/SKILL.md
.opencode/skills/diagnose-a-red-run/SKILL.md
.opencode/skills/drive-desktop-cdp/SKILL.md
.opencode/skills/fake-model-faults/SKILL.md
.opencode/skills/fraimz/SKILL.md
.opencode/skills/get-env-var/SKILL.md
.opencode/skills/hunt-a-prod-error/SKILL.md
.opencode/skills/measure-chat-flicker/SKILL.md
.opencode/skills/open-a-pr/SKILL.md
.opencode/skills/openwork-models/SKILL.md
.opencode/skills/preview-my-work/SKILL.md
.opencode/skills/product-tutorial-pipeline/SKILL.md
.opencode/skills/prove-a-pr/SKILL.md
.opencode/skills/publish-evidence/SKILL.md
.opencode/skills/record-a-demo/SKILL.md
.opencode/skills/release/SKILL.md
.opencode/skills/reproduce-chat-states/SKILL.md
.opencode/skills/review-a-contributor-pr/SKILL.md
.opencode/skills/run-evals/SKILL.md
.opencode/skills/run-tests/SKILL.md
.opencode/skills/shadcn/SKILL.md
.opencode/skills/upload-photo/SKILL.md
.opencode/skills/validate-a-release/SKILL.md
.opencode/skills/verify-openwork/SKILL.md
.opencode/skills/write-a-spec/SKILL.md
.warden/skills/confidentiality-review/SKILL.md
.warden/skills/contributor-screen/SKILL.md
.warden/skills/design-spec-review/SKILL.md
.warden/skills/desktop-den-sync-review/SKILL.md
.warden/skills/diff-security-review/SKILL.md
.warden/skills/spec-provenance-review/SKILL.md
integrations/agent-plugins/openwork-connect/skills/openwork-connect/SKILL.md

Metadata

Files
0
Version
b73f6c6
Hash
6d5ed666
Indexed
2026-10-19 21:56

홈 - 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-10-25 20:21
浙ICP备14020137号-1