菜单
Keep product docs current for pages, components, and services under docs/product-specs/. ALWAYS use before adding, changing, or removing user-visible behavior, reusable UI, or background product behavior; update specs, dependency tables, and folder README status rollups in the same change.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | product-docs-specs |
| description | Keep product docs current for pages, components, and services under docs/product-specs/. ALWAYS use before adding, changing, or removing user-visible behavior, reusable UI, or background product behavior; update specs, dependency tables, and folder README status rollups in the same change. |
Use this skill for any user-visible change on the Recipes site:
docs/product-specs/application.md — site-wide intent, personas, principlesdocs/product-specs/pages/ — one .md per route; entry pages/README.mddocs/product-specs/components/ — shared UI; entry components/README.mddocs/product-specs/services/ — behavior spanning multiple pages; entry services/README.mddocs/product-specs/index.mdWhen a page feature uses loaders or JSON, add API dependencies on the page spec (links to docs/api-specs/loaders/*.md). Update the loader spec's Page dependencies in the same change. See api-specs and recipes-static-api skills.
Use planned, complete, and broken in each folder's README.md status table.
not-working (= broken at row level).../components/<name>.md or state none../services/<name>.md when applicable../../api-specs/endpoints/<name>.md for each endpoint the page usesplanned rows and dependency tables before ambiguous implementationcomplete / broken; refresh README tables; reconcile links both waysindex.md links new top-level docsScrape non-YouTube sourceUrl into the catalog (JSON-LD/HTML parser or browser). Subskill of recipes-import-recipe — use the parent skill first to route YouTube vs web. Use for blog/recipe-site URLs with empty ingredients or placeholder steps.
Add or refresh a recipe in the static catalog from a URL. Simplifies noisy titles, always fetches ingredients/steps/images from the source, and delegates to recipes-youtube-recipe when sourceUrl is YouTube. Use when the user asks to add a recipe, import from a link, or fill the database from a bookmark.
Starred cook queue and meal-type tags on recipes. Use when changing the starred queue, starred order, or tagging recipes for breakfast/lunch/dinner/etc.
Subskill of recipes-import-recipe for YouTube URLs. Timestamped video recipes, simplified titles, ingredients from description RECIPE blocks or linked blogs. Use when sourceUrl is youtube.com or youtu.be — not as the top-level import entry.
Entry point for Recipes — design docs, static API contracts, design system, component-first UI, and TDD. Use when starting work, planning features, writing specs, or onboarding to this repo.
Document static JSON and loader contracts under docs/api-specs/ before changing src/static-api/. Use when adding recipes, loaders, types, filters, or data the UI depends on; pairs with recipes-static-api, page-specs, and recipes-tdd.