@nick848/fet 1.1.7 → 1.1.8

package/README.md

@@ -13,7 +13,9 @@ FET 是一个围绕 OpenSpec 构建的前端开发工作流编排 CLI。它不
 - 统一语言：默认使用中文输出交互信息和生成产物，可通过 `--lang <language>` 切换。
 - 保护关键阶段：在 `sync` / `archive` 前检查 FET verify 状态，降低未验证变更被合入或归档的风险。
 - 可选代码图：可接入 GitNexus，在大范围扫描前优先提供结构化代码上下文。
-- Figma 守卫：当 change 产物含 Figma 链接时，自动写入停止协议并让 IDE 在理解失败时先问用户，不猜测样式（无需额外命令）。
+- Figma 守卫：当 change 产物含 Figma 链接时，自动写入 `figma-apply-instructions.md`（apply 前必读稿）与 `figma-stop.md`（读稿失败则停下问用户，禁止猜样式）。
+- UI 展示契约：当 change 含 Figma 和/或接口文档引用时，生成 `ui-display-contract.yaml` 草案与 `ui-field-apply-instructions.md`；规划 spec 须写入「仅展示 displayFields」Requirement，避免按 OpenAPI 全量渲染。
+- Spec 分层双语：英文 Requirements/Scenario 为权威，每个 Requirement 配 `<!-- 中文：... -->`；LLM 更新 spec 时须同次编辑同步中文说明（见 `fet.specLanguage` 与 `.cursor/rules/fet-spec-language.mdc`）。
 
 ## 基本原理
 
@@ -178,10 +180,13 @@ FET 可能创建或更新：
 - `.cursor/skills/fet-*/SKILL.md`
 - `.cursor/rules/fet-context.mdc`
 - `.cursor/rules/fet-figma-stop.mdc`
+- `.cursor/rules/fet-spec-language.mdc`
 - `.cursor/rules/karpathy-guidelines.mdc`
 - `.codex/fet/context.md`
 - `.codex/fet/figma-stop.md`
+- `.codex/fet/spec-language.md`
 - `.codex/fet/karpathy-guidelines.md`
+- `openspec/changes/<change-id>/.fet/figma-apply-instructions.md`（apply 时含 Figma 链接则写入，实施 UI 前必读）
 - `openspec/changes/<change-id>/.fet/figma-stop.md`（change 含 Figma 链接时自动写入）
 - `.codex/fet/commands/*.md`
 - `$CODEX_HOME/prompts/fet-*.md`

package/README_en.md

@@ -13,7 +13,9 @@ FET is a frontend development workflow orchestration CLI built around OpenSpec.
 - Unifies language: Chinese is the default for interaction messages and generated artifacts; use `--lang <language>` to switch.
 - Guards critical stages: checks FET verification state before `sync` / `archive`.
 - Supports optional code graphs: integrates with GitNexus so AI tools can prefer structured code context before broad repository scans.
-- Figma guard: when a change references Figma, FET writes a stop protocol so the IDE asks the user instead of guessing styles when design input is unclear (no extra commands).
+- Figma guard: when a change references Figma, FET writes `figma-apply-instructions.md` (read design before UI work on apply) and `figma-stop.md` (stop and ask the user when Figma cannot be read—no guessed styles).
+- Layered bilingual specs: English Requirements/Scenario stay canonical; each Requirement gets a `<!-- 中文：... -->` note. LLM edits must refresh Chinese notes in the same edit (`fet.specLanguage`, `.cursor/rules/fet-spec-language.mdc`).
+- UI display contract: when a change references Figma and/or API docs, FET writes `ui-display-contract.yaml` (draft) and `ui-field-apply-instructions.md`; planning specs must include a Requirement that only `displayFields` may render—OpenAPI must not drive full UI field lists.
 
 ## How It Works
 
@@ -180,10 +182,13 @@ FET may create or update:
 - `.cursor/skills/fet-*/SKILL.md`
 - `.cursor/rules/fet-context.mdc`
 - `.cursor/rules/fet-figma-stop.mdc`
+- `.cursor/rules/fet-spec-language.mdc`
 - `.cursor/rules/karpathy-guidelines.mdc`
 - `.codex/fet/context.md`
 - `.codex/fet/figma-stop.md`
+- `.codex/fet/spec-language.md`
 - `.codex/fet/karpathy-guidelines.md`
+- `openspec/changes/<change-id>/.fet/figma-apply-instructions.md` (written on apply when the change references Figma)
 - `openspec/changes/<change-id>/.fet/figma-stop.md` (written when the change references Figma)
 - `.codex/fet/commands/*.md`
 - `$CODEX_HOME/prompts/fet-*.md`