- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add shinpr/claude-code-workflows --skill recipe-front-design -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add shinpr/claude-code-workflows --skill recipe-front-design -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add shinpr/claude-code-workflows --skill recipe-front-design -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add shinpr/claude-code-workflows --skill recipe-front-design -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/shinpr/claude-code-workflows/tree/HEAD/dev-workflows-frontend/skills/recipe-front-design来自发布者
Explicit User Instruction: The user explicitly instructs and authorizes every subagent call named in this recipe. Execute each applicable call when its prerequisites are met.
Execute Skill: documentation-criteria before document routing or creation.
Execute Skill: llm-friendly-context before writing Agent prompts, handoffs, or generated artifacts.
Execute Skill: subagents-orchestration-guide before invoking agents or resolving findings.
Before the first finding disposition, read references/review-resolution.md from the loaded subagents-orchestration-guide skill.
Coordinate a Medium/Large frontend design from evidence to an applicable UI Spec and approved Design Doc. The user owns product requirements and exclusions; the orchestrator owns convergence readiness, Structural Scale, document routing, ADR qualification, evidence selection, and Review Resolution. Named specialists own semantic investigation and artifacts.
The frontend Design Doc always carries the complete implementation design. An ADR batch narrows qualifying technical choices; an applicable UI Spec owns UI structure and behavior that remain to be designed.
Requirements: $ARGUMENTS
requirement source -> codebase-analyzer -> scope/document routing confirmation [Stop]
|
conditional UI analysis -> UI Spec review [Stop]
|
optional ADR batch/review [Stop]
|
Design Doc -> code-verifier/Resolution -> document-reviewer
|
design-sync -> approval [Stop]
Use Review Resolution for every actionable finding. Wait at each [Stop] for explicit user confirmation.
At each Agent invocation below, build the prompt as a mechanical extraction: copy the named source values into the exact fields, apply only the declared serialization, then invoke immediately.
Use the approved PRD path when one exists. Otherwise use the requirements verbatim.
Set requirement_context to the approved PRD path exactly. Only when no approved PRD exists, use the orchestrator's convergence record unchanged.
Invoke dev-workflows-frontend:codebase-analyzer once for the complete scope with exactly prd_path: [approved PRD path], or requirements: [requirements verbatim] when no approved PRD exists.
Require one valid JSON result and let the analyzer discover affected paths, responsibility boundaries, and cross-layer contracts. Treat focusAreas as existing-behavior safeguards rather than requirements.
This independent discovery keeps scope and option convergence grounded in repository evidence rather than the orchestrator's unverified implementation hypothesis.
Apply the documentation-criteria UI Spec creation condition. When it does not apply, skip UI analysis and Step 5.
When a UI Spec applies, load and apply external-resource-context only when an external resource can change the current UI direction, component contract, or verification boundary. Otherwise use external_resource_refs: [].
Ask for prototype code only when it supplies an unresolved approved UI decision or the target cannot be determined from requirements, repository UI, and recorded resources. A missing optional prototype is not a stop condition.
Invoke dev-workflows-frontend:ui-analyzer with exactly one governing source:
prd_path: [approved PRD path]
or, when no approved PRD exists:
requirements: [requirements verbatim]
Add only an existing ui_spec_path, a decision-relevant prototype_path, and selected external_resource_refs or [].
ui_spec_path: [existing UI Spec path]
prototype_path: [decision-relevant path]
external_resource_refs: [selected references or []]
Execute Skill: requirement-convergence. Build and judge the convergence record from the governing requirement source, repository analysis, and applicable UI analysis.
Judge all four convergence fields by the rules in references/criteria.md of the requirement-convergence skill. Assign cost from Step 2 structural evidence and record its unknowns; run the hearing only for fields below ready.
Determine Structural Scale from outcomes and responsibility boundaries; file count is supporting evidence only. Resolve candidate decision points against the governing source, applicable code/UI simplifications, reuse, and invalidations; applicable UI facts may support or contradict the remaining options. Apply documentation-criteria Choice and Durability filters only after this convergence and record passing points as adrDecisionPoints; an empty list is valid.
Present the requirement-convergence Scope Confirmation. Place affected responsibilities, applicable simplifications with their conditions, and qualifying ADR points or none under Decision evidence; place Structural Scale, UI Spec applicability, and the recommended document route under Workflow. Offer proceed, or correct and re-run. Ask a question only when its answer can change a convergence field, the outcome, or scope. Continue only when every convergence field is ready or weak-but-explicit. [Stop: Scope confirmation].
Run this step only when Step 3 determined that a UI Spec applies.
Invoke dev-workflows-frontend:ui-spec-designer with exact inputs:
requirement_context: [the value set in Step 1]
ui_analysis: [complete Step 3 UI analyzer JSON unchanged]
codebase_analysis: [complete Step 2 codebase-analyzer JSON unchanged]
prototype_path: [decision-relevant path from Step 3 exactly, or absent]
prototype_reference_strength: [binding | reference, present with a prototype_path]
external_resource_refs: [selected Step 3 reference records unchanged, or []]
Invoke dev-workflows-frontend:document-reviewer with exact inputs: doc_type: UISpec and target as the UI Spec path returned by ui-spec-designer, unchanged. pass presents the UI Spec with issues: []; needs_revision applies Review Resolution and re-reviews after correction; rejected resolves the governing-source conflict before another review. [Stop: UI Spec approval].
When adrDecisionPoints is non-empty:
document_to_create: ADRBatch; requirement_context; its ordered decision_points from Step 4, unchanged; decision_materials as the corresponding Step 2 decisionMaterials.candidateDecisionPoints objects copied unchanged in that order; and ui_spec_path only when the approved UI Spec constrains that owner's decision. Run owner batches serially so each batch allocates ADR numbers after the preceding batch exists.dev-workflows-frontend:document-reviewer once with exact inputs: doc_type: ADRBatch, targets: [all paths], and requirement_context. The reviewer follows the approved UI Spec cited by the ADRs when it can change the decision review.pass proceeds with issues: []; needs_revision applies Review Resolution, updates one ADR per path serially, and re-reviews the complete batch; rejected resolves the governing-source conflict before another review.[Stop: ADR batch approval].Accepted and verify the status update.Create the complete frontend MVP implementation design from reviewed artifacts and unchanged repository/UI evidence; this keeps the Design Doc traceable to approved sources instead of an orchestrator-authored shadow design.
Invoke dev-workflows-frontend:technical-designer-frontend with exactly:
document_to_create: DesignDoc;requirement_context;structural_scale;ui_spec_path exactly and selected external-resource reference records unchanged;adr_paths: [accepted paths or []];codebase_analysis: [complete Step 2 JSON unchanged];ui_analysis: [complete Step 3 JSON unchanged; omit when absent].The Design Doc owns the full component-to-service implementation and retains all applicable downstream safeguards.
When a backend Design Doc already exists for this feature, pass a distinct output_path such as docs/design/[feature-name]-frontend-design.md; preserve the backend path as a reference.
Keep verifier observations unchanged so corrections remain traceable to observed repository evidence instead of becoming orchestrator-authored design instructions.
Invoke dev-workflows-frontend:code-verifier with doc_type: design-doc and document_path as the Design Doc path returned by technical-designer-frontend, unchanged, to verify current premises and feasibility while treating planned behavior as intent. Apply Review Resolution before document review; send applied findings to a fresh technical-designer-frontend update invocation with Operation Mode: update, Existing Document: [Design Doc path], and correction_findings: [complete findings unchanged except for their dispositions]. The designer applies its review-triggered bounded self-verification gate for an unverified decision-changing premise; this fresh designer is the sole correction specialist and selects the evidence route. Rerun verification after an applied correction with the previous complete result, dispositions, and correction diff or paths as prior_feedback, then build one verification_evidence object from the latest result. Continue at the Review Resolution convergence condition.
Invoke dev-workflows-frontend:document-reviewer with exact inputs: doc_type: DesignDoc; target as the returned Design Doc path unchanged; review_context: creation; original user requirements unchanged as requirements_verbatim; the Step 1 requirement_context unchanged; the same unchanged codebase_analysis and optional ui_analysis supplied to the designer; and Step 8 verification_evidence unchanged. The reviewer follows an applicable UI Spec and accepted ADR paths cited by the Design Doc only when they can change an in-scope finding.
pass: continue.needs_revision: apply Review Resolution, update through a fresh technical-designer-frontend invocation using the existing path and complete applied findings, then re-review with prior_feedback.rejected: resolve technical governing-source conflicts through Review Resolution; ask the user only when the outcome, desired-future requirements, and non-goals cannot all remain true and the user must choose which changes.Invoke dev-workflows-frontend:design-sync with source_design as the returned Design Doc path unchanged, apply Review Resolution to actionable conflicts, and report SKIPPED distinctly when only one Design Doc exists.
Present the applicable UI Spec, Design Doc, accepted ADR paths, resolved limitations/declines, and sync result. [Stop: Design approval].
needs_revision issues into correction work.Execute from repository evidence through applicable UI Spec and optional ADR decisions to complete frontend Design Doc approval
---name: recipe-front-designdescription: Execute from repository evidence through applicable UI Spec and optional ADR decisions to complete frontend…---# dev-workflows-frontend/skills/recipe-front-design/SKILL.md常见问题
从发布者处下载 dev-workflows-frontend/skills/recipe-front-design/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/shinpr/claude-code-workflows。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。