ce-polish-beta

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Polish

打磨优化

Start the dev server, open the feature in a browser, and iterate. You use the feature, say what feels off, and fixes happen.
启动开发服务器,在浏览器中打开功能并进行迭代。你使用该功能,说出觉得不顺手的地方,然后进行修复。

Phase 0: Get on the right branch

阶段0:切换到正确分支

  1. If a PR number or branch name was provided, check it out (probe for existing worktrees first).
  2. If blank, use the current branch.
  3. Verify the current branch is not main/master.
  1. 如果提供了PR编号或分支名称,检出该分支(先检查是否存在现有工作树)。
  2. 如果未提供,则使用当前分支。
  3. 验证当前分支不是main/master分支。

Phase 1: Start the dev server

阶段1:启动开发服务器

1.1 Check for
.claude/launch.json

1.1 检查
.claude/launch.json

Run
bash scripts/read-launch-json.sh
. If it finds a configuration, use it — the user already told us how to start the project.
运行
bash scripts/read-launch-json.sh
。如果找到配置,则使用该配置——用户已经告知我们如何启动项目。

1.2 Auto-detect (when no launch.json)

1.2 自动检测(无launch.json时)

Run
bash scripts/detect-project-type.sh
to identify the framework.
Route by type to the matching recipe reference for start command and port defaults:
TypeRecipe
rails
references/dev-server-rails.md
next
references/dev-server-next.md
vite
references/dev-server-vite.md
nuxt
references/dev-server-nuxt.md
astro
references/dev-server-astro.md
remix
references/dev-server-remix.md
sveltekit
references/dev-server-sveltekit.md
procfile
references/dev-server-procfile.md
unknown
Ask the user how to start the project
For framework types that need a package manager, run
bash scripts/resolve-package-manager.sh
and substitute the result into the start command.
Resolve the port with
bash scripts/resolve-port.sh --type <type>
.
运行
bash scripts/detect-project-type.sh
识别框架。
根据类型匹配对应的启动命令和端口默认值的参考指南:
类型参考指南
rails
references/dev-server-rails.md
next
references/dev-server-next.md
vite
references/dev-server-vite.md
nuxt
references/dev-server-nuxt.md
astro
references/dev-server-astro.md
remix
references/dev-server-remix.md
sveltekit
references/dev-server-sveltekit.md
procfile
references/dev-server-procfile.md
unknown
询问用户如何启动项目
对于需要包管理器的框架类型,运行
bash scripts/resolve-package-manager.sh
并将结果替换到启动命令中。
通过
bash scripts/resolve-port.sh --type <type>
确定端口。

1.3 Start the server

1.3 启动服务器

Start the dev server in the background, log output to a temp file. Probe
http://localhost:<port>
for up to 30 seconds. If it doesn't come up, show the last 20 lines of the log and ask the user what to do.
在后台启动开发服务器,将输出日志记录到临时文件。探测
http://localhost:<port>
最多30秒。如果服务器未启动,显示日志的最后20行并询问用户下一步操作。

1.4 Open in browser

1.4 在浏览器中打开

Load
references/ide-detection.md
for the env-var probe table. Open the browser using the IDE's mechanism (Claude Code →
open
, Cursor → Cursor browser, VS Code → Simple Browser).
Tell the user:
Dev server running on http://localhost:<port>
Browse the feature and tell me what could be better.
加载
references/ide-detection.md
获取环境变量探测表。使用IDE的机制打开浏览器(Claude Code →
open
,Cursor → Cursor浏览器,VS Code → Simple Browser)。
告知用户:
Dev server running on http://localhost:<port>
Browse the feature and tell me what could be better.

Phase 2: Iterate

阶段2:迭代优化

This is the core loop. The user browses the feature and tells you what to improve. You fix it. Repeat until they're happy.
  • When the user describes something to fix → make the change, the dev server hot-reloads
  • When the user asks to check something → use
    agent-browser
    to screenshot or inspect the page
  • When the user says they're done → commit the fixes and stop
No checklist. No envelope. Just conversation.
这是核心循环。用户浏览功能并告知需要改进的地方,你进行修复。重复此过程直到用户满意。
  • 当用户描述需要修复的内容时 → 进行修改,开发服务器会热重载
  • 当用户要求检查某些内容时 → 使用
    agent-browser
    截图或检查页面
  • 当用户表示完成时 → 提交修复并停止
无需检查清单,无需繁琐流程,只需对话即可。

References

参考资料

Reference files (loaded on demand):
  • references/launch-json-schema.md
    — launch.json schema + per-framework stubs
  • references/ide-detection.md
    — host IDE detection and browser-handoff
  • references/dev-server-detection.md
    — port resolution documentation
  • references/dev-server-rails.md
    — Rails dev-server defaults
  • references/dev-server-next.md
    — Next.js dev-server defaults
  • references/dev-server-vite.md
    — Vite dev-server defaults
  • references/dev-server-nuxt.md
    — Nuxt dev-server defaults
  • references/dev-server-astro.md
    — Astro dev-server defaults
  • references/dev-server-remix.md
    — Remix dev-server defaults
  • references/dev-server-sveltekit.md
    — SvelteKit dev-server defaults
  • references/dev-server-procfile.md
    — Procfile-based dev-server defaults
Scripts (invoked via
bash scripts/<name>
):
  • scripts/read-launch-json.sh
    — launch.json reader
  • scripts/detect-project-type.sh
    — project-type classifier
  • scripts/resolve-package-manager.sh
    — lockfile-based package-manager resolver
  • scripts/resolve-port.sh
    — port resolution cascade
按需加载的参考文件:
  • references/launch-json-schema.md
    — launch.json 模式 + 各框架模板
  • references/ide-detection.md
    — 宿主IDE检测与浏览器切换
  • references/dev-server-detection.md
    — 端口解析文档
  • references/dev-server-rails.md
    — Rails 开发服务器默认配置
  • references/dev-server-next.md
    — Next.js 开发服务器默认配置
  • references/dev-server-vite.md
    — Vite 开发服务器默认配置
  • references/dev-server-nuxt.md
    — Nuxt 开发服务器默认配置
  • references/dev-server-astro.md
    — Astro 开发服务器默认配置
  • references/dev-server-remix.md
    — Remix 开发服务器默认配置
  • references/dev-server-sveltekit.md
    — SvelteKit 开发服务器默认配置
  • references/dev-server-procfile.md
    — 基于Procfile的开发服务器默认配置
脚本(通过
bash scripts/<name>
调用):
  • scripts/read-launch-json.sh
    — launch.json 读取脚本
  • scripts/detect-project-type.sh
    — 项目类型分类脚本
  • scripts/resolve-package-manager.sh
    — 基于锁文件的包管理器解析脚本
  • scripts/resolve-port.sh
    — 端口解析脚本