1仕組みと動作原理
プロンプトの構成設計のみでアンチスロップ(粗製乱造防止)を完全実現:skill ディレクトリには単一の SKILL.md(87,253 バイト / 1,206 行の Markdown)のみが存在し、スクリプトやデータファイルは一切含みません。『厳格な禁止事項 + カウント可能な閾値 + セルフチェックリスト』の形式により、エージェントが出力前に自己フィルタリングを行います。
[taste-skill]="skills/taste-skill/SKILL.md"
ルール適用の前にまず『要件書(brief)の読み込み』を実施:3つのダイヤル(DESIGN_VARIANCE / MOTION_INTENSITY / VISUAL_DENSITY)をドキュメント全体の疑似グローバル変数(ベースライン 8/6/4)として定義し、すべてのレイアウト・アニメーション・密度の決定をこの変数で制御。各ルールはこの変数のコンテキスト下でのみ有効となります。
**Baseline:** `8 / 6 / 4`. Use these unless the design read overrides them. Do not ask the user to edit this file - overrides happen conversationally.
アンチスロップルールは実践的な『AI Tells(AI特有の癖)ブラックリスト』として機能:LLM 生成物で頻出する欠陥を識別可能なシグネチャ(em-dash、eyebrow のカウント、均等3分割カード、スプリットスクリーンヘッダー、単色フッターなど)としてリスト化し、カウント可能な閾値を設定。その多くに明確なオーバーライド(例外規定)パスを設けています。
**Em-dash (`—`) is COMPLETELY banned.** It is the LLM's signature stylistic crutch and it is the #1 visual Tell in production tests. There is no "limited use" allowance, no "natural language frequency" allowance, no "in body copy is fine" allowance. None.
出荷前チェックマトリクスを強制:§14 PRE-FLIGHT CHECK ではこれまでの全ルールを網羅する 50 項目以上のチェックボックスを提供し、出力前の全項目セルフチェックを義務化。1項目でもチェックできない場合は『not done(未完了)』とみなします。
Run this matrix before outputting code. This is the last filter. **THIS IS NOT OPTIONAL. Run every box. If any box fails, the output is not done.**
エージェントが記憶に頼って誤ったライブラリを使用するのを防ぐため、『コピーして即使用可能』なコードスケルトンと実際のインストールコマンドを提供:§5.A/B/C では GSAP/Motion の TSX カノニカルスケルトンをインライン展開し、付録 A に各種デザインシステムの正確な install コマンドを、付録 B に公式ドキュメントリンクを掲載しています。
The sections below are vendored reference content. They give the agent real install commands, real canonical doc links, and real working starter snippets for each design system named in Section 2. Use them to ground decisions in production reality, not training-data fiction.
『モデルの事前分布の使い回し』に対抗するプロジェクト間ローテーション機構:フォントやプレミアムカラーパレットについて、連続するプロジェクトで同一の組み合わせを再利用することを禁止し、多様性を強制します。
**Palette-rotation rule:** if the previous premium-consumer project you generated used the beige+brass family, this one MUST use a different family. Do not ship the same warm-craft palette twice in a row.
2コア機能
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| cli | npx shadcn@latest |
| cli | npm install / yarn add(设计系统安装指令) |
| package | 设计系统:@fluentui/react-components、@material/web、@carbon/react、@primer/css、@radix-ui/themes、govuk-frontend、uswds、bootstrap、@atlaskit/* |
| package | 动效库:motion(motion/react)、gsap、three.js |
| package | 图标库:@phosphor-icons/react、hugeicons-react、@radix-ui/react-icons、@tabler/icons-react(lucide 降级) |
| network | 素材源(写进生成页面):picsum.photos 占位摄影 / cdn.simpleicons.org 品牌 logo / unsplash、pexels(若明确允许) |
| network | Polaris Web Components CDN script(仅 Shopify app 场景,写入生成页面 head) |
| tool | 图像生成工具(条件式):generate_image / MCP image tool / IDE-integrated gen / OpenAI image tools——仅在宿主环境可用时 |
| network | 官方文档链接(仅参考不抓取):github.com、developer.mozilla.org、各设计系统官网、developer.apple.com 等 50+ 条 |
4推奨統制措置と判定根拠
- SKILL.md: プロンプト指示およびルールテキストのみで構成され、スクリプト実行や外部への直接的副作用はありません。
5二重目の独立検証
- [ok] 『无脚本、单文件』 — git ls-tree 确认 skills/taste-skill/ 下仅 SKILL.md;仓库根 skill.sh 只是 SKILL.md 路径注册表,非 skill 运行代码
- [ok] 『无网络外发』 — 全量提取 55 个 http(s) URL,全部为官方文档链接或写给生成页面的素材/CDN 源;SKILL.md 内无 fetch/axios/curl/wget
- [ok] 『无凭证读取』 — 全文唯一命中 api-key 的是 Polaris 模板中的 <meta name="shopify-api-key" content="%SHOPIFY_API_KEY%" /> 占位符,写入的是用户页面;无 env/keychain/密钥读取指令
- [ok] 『安装命令仅文字指示』 — npm/npx/yarn 只出现在 Appendix A 代码块与 §2.A 表格,作为给 agent 的安装提示;npx shadcn 为官方初始化器
- [discrepancy] §12 引用的 blocks/ 目录 — SKILL.md 内唯一内部路径引用 skills/taste-skill/blocks/(§12.A)在本 commit 不存在;正文已自述 'Blocks will be added iteratively',属未兑现契约而非缺陷
- [ok] em-dash 自洽性(正文宣称全禁却含 em-dash) — 全文仅 5 个 —,均为禁令规则演示文本;git log 339afcb 证实 'purge em-dashes throughout (177 -> 6)',与声明一致
- [ok] 『strict pre-flight check』是否夸大 — §14 确实给出 50+ 勾选盒矩阵并声明 'THIS IS NOT OPTIONAL';但它是认知自检而非程序化校验——文档未声称有自动化,无夸大
- [ok] 『real design systems when applicable』是否夸大 — §2.A 表 + Appendix B 官方文档 + Appendix A 真实安装命令俱全;Appendix C 主动声明 Apple Liquid Glass 无官方 web 实现,诚实度高于多数同类 skill
6結論
1cf075267bf20c7a…