sillyspec 3.8.5 → 3.8.7

package/templates/workspace-sync.md

@@ -0,0 +1,99 @@
+## 交互规范
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+## 核心约束（必须遵守）
+- ❌ 修改子项目的代码
+- ❌ 删除已有文件（clone 前必须确认）
+- ❌ 跳过冲突检查直接覆盖
+
+## 流程
+
+### Step 1: 读取配置
+
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
+```
+
+无子项目配置 → 提示先执行 `/sillyspec:workspace` 初始化工作区。
+
+### Step 2: 逐个子项目检查
+
+对每个子项目配置文件，按顺序执行：
+
+```bash
+for f in .sillyspec/projects/*.yaml; do
+  [ -f "$f" ] || continue
+  proj_name=$(basename "$f" .yaml)
+  proj_path=$(grep '^path:' "$f" | head -1 | sed 's/^path:[[:space:]]*//')
+  proj_repo=$(grep '^repo:' "$f" | head -1 | sed 's/^repo:[[:space:]]*//')
+  # ... 检查逻辑
+done
+```
+
+```bash
+# 检查目录是否存在
+ls -d <path> 2>/dev/null && echo "EXISTS" || echo "MISSING"
+```
+
+#### 情况 A：目录不存在
+
+```bash
+# 检查是否有 repo 配置
+grep '^repo:' .sillyspec/projects/<name>.yaml
+```
+
+- **有 repo** → AskUserQuestion："子项目 `<name>` 不存在，是否从 `<repo>` clone 到 `<path>`？"
+  - 用户确认 → `git clone <repo> <path>` → ✅ 成功
+  - clone 失败 → ❌ 报错，提示用户手动 clone
+- **无 repo** → ⚠️ 提示用户："子项目 `<name>` 不存在且无 repo 配置，请手动放置到 `<path>`"
+
+#### 情况 B：目录已存在
+
+```bash
+# 检查是否是 git 仓库
+git -C <path> rev-parse --is-inside-work-tree 2>/dev/null
+
+# 如果是，检查 remote 是否匹配
+git -C <path> remote get-url origin 2>/dev/null
+```
+
+- **不是 git 仓库** → AskUserQuestion："目录 `<path>` 存在但不是 git 仓库，可能和其他项目冲突。"
+  - 跳过此子项目
+  - 让用户指定正确路径
+- **是 git 仓库，remote 匹配 repo** → ✅ 跳过，状态正常
+- **是 git 仓库，remote 不匹配 repo** → ⚠️ AskUserQuestion：
+  - "目录 `<path>` 是 git 仓库但 remote 不匹配（期望 `<repo>`，实际 `<actual>`）。可能是不同项目。"
+  - 跳过 / 用户确认覆盖
+
+#### 情况 C：路径冲突
+
+检查两个子项目的 path 是否指向同一目录或互相包含：
+
+```bash
+# 将相对路径转为绝对路径后比较
+realpath <path1>
+realpath <path2>
+```
+
+冲突 → ❌ 报错："子项目 A 和 B 的路径冲突，请修改对应的 projects/*.yaml"
+
+### Step 3: 汇总报告
+
+```
+📊 工作区同步结果
+
+┌───────────────────┬──────────┬────────────────────────────────────┐
+│ 子项目            │ 状态     │ 说明                               │
+├───────────────────┼──────────┼────────────────────────────────────┤
+│ back-service      │ ✅ 正常   │ 目录存在，git remote 匹配         │
+│ sub-grid-security │ 🔄 已克隆 │ 从 https://... clone 成功         │
+│ frontend          │ ⚠️ 缺失   │ 无 repo 配置，请手动放置           │
+└───────────────────┴──────────┴────────────────────────────────────┘
+```
+
+全部正常 → 提示 `/sillyspec:brainstorm '你的需求'` 继续。
+有异常 → 提示用户处理后再 sync。
+
+### Step 4: 更新子项目配置
+
+如果 clone 过程中实际 remote 和 `projects/<name>.yaml` 中的 repo 不一致，更新对应 yaml 文件的 repo 字段为实际值。

package/templates/workspace.md

@@ -0,0 +1,70 @@
+## 交互规范
+**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
+
+## 核心约束（必须遵守）
+- ❌ 修改子项目目录下的任何文件
+- ❌ 写非法 YAML
+- ❌ 使用绝对路径（必须是相对路径）
+
+## 用户指令
+$ARGUMENTS
+
+---
+
+## 流程
+
+### Step 1: 检查配置
+
+```bash
+ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
+```
+
+不存在 → 询问是否初始化工作区。
+
+### Step 2: 解析指令
+
+- 无参数 / `status` → 显示状态
+- `add` → 添加子项目
+
+**添加流程：**
+1. AskUserQuestion 询问子项目名称、目录路径、角色描述
+2. **自动检测 git 远程地址：**
+```bash
+git -C <path> remote get-url origin 2>/dev/null
+```
+检测到则写入 repo 字段，检测不到则留空
+3. 创建 `.sillyspec/projects/<name>.yaml` 文件
+- `remove` → 删除 `.sillyspec/projects/<name>.yaml` 文件
+- `sync` → 同步子项目（clone 缺失的，检查冲突）
+
+### Step 3: 执行操作
+
+**初始化工作区：** 询问名称 → 逐个添加子项目（名称、路径、角色描述，验证路径存在）→ 共享规范 → 创建 `projects/*.yaml` + `.sillyspec/shared/`
+
+**添加/移除子项目：** 创建或删除 `projects/<name>.yaml`，Git 提交。
+
+**状态显示：** 读取每个子项目的 `.sillyspec/` 内容（PROJECT.md、docs/<project>/scan/ 文档数、进行中变更），输出格式：
+
+```
+🏢 工作区：<name>
+📦 子项目（N 个）：
+  ✅ frontend  ./frontend    前端 - Vue3+TS    已扫描（7 份文档）
+  ⚠️ backend   ./backend     后端 - Node.js     已初始化（未扫描）
+📄 共享规范：2 份
+💡 操作：/sillyspec:workspace add | /sillyspec:init | /sillyspec:scan
+```
+
+### 读取子项目信息
+
+```bash
+for f in .sillyspec/projects/*.yaml; do
+  [ -f "$f" ] || continue
+  proj_name=$(basename "$f" .yaml)
+  proj_path=$(grep '^path:' "$f" | head -1 | sed 's/^path:[[:space:]]*//')
+  proj_role=$(grep '^role:' "$f" | head -1 | sed 's/^role:[[:space:]]*//')
+  proj_repo=$(grep '^repo:' "$f" | head -1 | sed 's/^repo:[[:space:]]*//')
+  # 检查文档数、变更数等
+  doc_count=$(ls "$proj_path"/.sillyspec/docs/$proj_name/scan/*.md 2>/dev/null | wc -l)
+  echo "  $proj_name  $proj_path    $proj_role    docs:$doc_count"
+done
+```

package/.claude/skills/sillyspec-archive/SKILL.md

@@ -1,17 +0,0 @@
----
-name: sillyspec:archive
-description: 归档变更 — 规范沉淀，可追溯
----
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run archive` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run archive --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS

package/.claude/skills/sillyspec-auto/SKILL.md

@@ -1,77 +0,0 @@
----
-description: 自动模式 — 全流程自动推进（通用版）
-argument-hint: "<需求描述>"
----
-
-## 用法
-- /sillyspec:auto 实现用户登录功能
-- /sillyspec:auto 修复搜索结果的排序问题
-
-## 任务
-$ARGUMENTS
-
----
-
-## 执行流程
-
-你是全流程编排器，按 brainstorm → plan → execute → verify 顺序自动推进。
-
-### 启动
-1. 运行 `sillyspec run auto --input "<用户需求>"`
-2. 读取 CLI 输出的 step prompt（包含你的角色描述）
-3. 执行 prompt 中的操作
-
-### 步骤循环
-重复以下循环直到 CLI 输出"全部流程已完成"：
-
-1. **读取 CLI 输出的 step prompt**
-2. **判断是否需要用户确认：**
-   - prompt 中包含"请用户选择""等待用户回答""展示给用户""用户确认" → **暂停，等用户回复**
-   - 纯内部操作 → **直接执行**
-3. **执行 prompt 要求的操作**
-4. **完成后运行** `sillyspec run auto --done --output "<你的摘要>"`
-5. **读取 CLI 输出的下一步 prompt**，回到步骤 1
-
-### 阶段审核门控
-
-**brainstorm 完成后：**
-评估需求复杂度（参考 brainstorm Step 5 的判断结果），根据复杂度决定：
-
-| 复杂度 | 审核策略 |
-|--------|---------|
-| 简单（无拆分、无批量） | 不审核，直接进入 plan |
-| 中等（有拆分或批量） | 启动 1 个审核子代理（QA 视角）审查 design.md |
-| 复杂（拆分 + 批量/多角色） | 启动 2-3 个审核子代理多角度审查 |
-
-多角度审核子代理分工：
-- **架构师** — 审查设计合理性、技术选型 trade-off、模块划分
-- **安全专家** — 审查安全隐患、权限设计、数据校验
-- **QA 专家** — 审查需求覆盖率、边界场景遗漏、验收标准
-
-审核流程：
-1. 暂停，提示用户当前复杂度等级和建议审核策略
-2. 用户确认后，启动审核子代理（读取 design.md + requirements.md + tasks.md）
-3. 子代理输出问题清单
-4. 汇总问题，询问用户"是否需要修改后再继续"
-5. 需要修改 → 修复后重新审核；不需要 → 进入下一阶段
-
-**plan 完成后：**
-同样评估复杂度，启动审核子代理审查 plan.md：
-- **项目经理** — 审查任务拆解粒度、依赖关系、优先级
-- **工程师** — 审查任务可行性、工作量评估是否合理
-- **QA** — 审查验收标准是否具体可测试
-
-### 关键规则
-- 不要跳过任何步骤
-- 不要手动修改 progress.json
-- 不要自动 commit，只 git add
-- 不要使用 npx
-- 不要编造不存在的 CLI 子命令
-- 遇到命令报错 → 展示错误，暂停等用户介入
-
-### 异常处理
-- 命令执行失败 → 展示错误信息，暂停等待用户指示
-- 用户说"停止"或"暂停" → 立即停止，报告当前进度
-
-### 完成条件
-CLI 输出"全部流程已完成"后，输出完整流程总结，提示用户提交改动。

package/.claude/skills/sillyspec-brainstorm/SKILL.md

@@ -1,17 +0,0 @@
----
-name: sillyspec:brainstorm
-description: 需求探索 — 结构化头脑风暴，含技术方案输出（创建性工作前必用）
----
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run brainstorm` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run brainstorm --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS

package/.claude/skills/sillyspec-continue/SKILL.md

@@ -1,44 +0,0 @@
----
-name: sillyspec:continue
-description: 自动判断并执行下一步
----
-
----
-
-你现在是 SillySpec 的自动推进器。
-
-## 判断逻辑
-
-按顺序检查，第一个未完成的就执行：
-
-```
-1. 有 HANDOFF.json？→ 执行 /sillyspec:resume
-
-2. .sillyspec/changes/ 有进行中的变更？
-   2a. 没有任何文件 → 提示检查 proposal 是否需要完善
-   2b. 没有 design.md → 提示补充 design
-   2c. 没有 tasks.md → 执行 /sillyspec:propose（补全规范）
-   2d. tasks.md 有未完成项 + 有计划文件 → 执行 /sillyspec:execute
-   2e. tasks.md 全完成 + 没验证 → 执行 /sillyspec:verify
-   2f. 已验证通过 → 执行 /sillyspec:archive
-
-3. 有设计文档但没有对应变更？
-   → 提示运行 /sillyspec:propose <name>
-
-4. 有 docs/*/scan/ 但没有进行中的工作？
-   → 提示运行 /sillyspec:brainstorm "你的想法"
-
-5. 什么都没有？
-   → 提示运行 /sillyspec:init（新项目）或 /sillyspec:scan（棕地项目）
-```
-
-## 输出
-
-先报告检测结果，再执行：
-
-> 🤖 SillySpec 自动检测
-> 
-> 当前状态：[描述]
-> 下一步：[执行的命令]
-> 
-> [开始执行...]

package/.claude/skills/sillyspec-doctor/SKILL.md

@@ -1,22 +0,0 @@
----
-name: sillyspec:doctor
-description: 项目自检 — 检查 CLI、配置、构建环境和外部依赖
----
-
-## 前置检查
-
-**在执行任何检查之前，先确认 SillySpec CLI 是否可用：**
-
-1. 运行 `sillyspec --version`
-2. 如果失败：
-   - 输出：❌ SillySpec CLI 未安装
-   - 给出安装命令：`npm install -g sillyspec`
-   - 停止，不要继续后续步骤
-
-## 执行
-
-CLI 可用后，运行 `sillyspec run doctor`，按提示逐步执行。
-每步完成后运行 `sillyspec run doctor --done --output "摘要"`。
-
-## 用户指令
-$ARGUMENTS

package/.claude/skills/sillyspec-execute/SKILL.md

@@ -1,17 +0,0 @@
----
-name: sillyspec:execute
-description: 波次执行 — 子代理并行 + 强制 TDD + 两阶段审查
----
-
-## 执行
-
-**你必须使用 exec 工具（shell）执行以下命令，不要自己编造流程：**
-
-1. 运行 `sillyspec run execute` — 读取输出的步骤 prompt
-2. 按照输出的 prompt **严格执行**，不要跳过或自行添加步骤
-3. 步骤完成后，运行 `sillyspec run execute --done --output "你的摘要"`
-4. 重复 2-3 直到阶段完成
-5. **禁止**在没有运行 CLI 的情况下自行决定流程
-
-## 用户指令
-$ARGUMENTS

package/.claude/skills/sillyspec-explore/SKILL.md

@@ -1,96 +0,0 @@
----
-name: sillyspec:explore
-description: 自由思考模式 — 讨论、画图、调研，不写代码
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
----
-
-你现在是 SillySpec 的自由思考伙伴。
-
-## 话题
-$ARGUMENTS
-
-## 这是什么模式
-
-**探索模式用于思考，不用于实现。** 你可以读文件、搜代码、调查代码库，但绝对不能写代码或实现功能。如果用户要求实现，提醒他们先退出探索模式。
-
-**这不是一个工作流，是一种姿态。** 没有固定步骤、没有必需的输出。你是一个帮助用户思考的伙伴。
-
-## 姿态
-
-- **好奇，不说教** — 问自然产生的问题，不按脚本走
-- **开放式线程** — 展示多个有趣方向，让用户选择
-- **可视化** — 大量使用 ASCII 图表
-- **自适应** — 追随有趣的线索，随时转向
-- **耐心** — 不急着下结论
-- **务实** — 探索实际代码库，不只纸上谈兵
-
-## 你可以做的事
-
-**探索问题空间：** 问澄清问题、挑战假设、重新定义问题
-
-**调查代码库：** 映射相关架构、找集成点、识别已有模式、暴露隐藏复杂性
-
-**比较选项：** 头脑风暴多种方案、建对比表、画权衡分析
-
-**画图：**
-```
-┌─────────────────────────────────┐
-│     用 ASCII 图自由表达          │
-├─────────────────────────────────┤
-│                                 │
-│   ┌────────┐       ┌────────┐  │
-│   │ State  │──────▶│ State  │  │
-│   │   A    │       │   B    │  │
-│   └────────┘       └────────┘  │
-│                                 │
-└─────────────────────────────────┘
-```
-
-**暴露风险：** 识别可能出错的地方、发现理解空白
-
-## OpenSpec 上下文感知
-
-### 检查已有上下文
-
-```bash
-# 查看进行中的变更
-ls .sillyspec/changes/ 2>/dev/null | grep -v archive
-# 查看需求
-cat .sillyspec/REQUIREMENTS.md 2>/dev/null
-cat .sillyspec/ROADMAP.md 2>/dev/null
-```
-
-### 当有进行中的变更时
-
-读取变更的 proposal、design、tasks，自然地引用它们。
-
-当发现重要的决策时，**提议保存**（不自动保存）：
-
-请选择：
-1. 写入 design.md
-2. 加入 specs
-3. 暂不保存
-
-## 没有必需的结束
-
-探索可以：
-1. 创建变更提案 — 流入 proposal
-2. 产出文档更新
-3. 继续探索
-4. 结束探索
-
-## 禁止事项
-
-- ❌ 写实现代码
-- ❌ 安装依赖
-- ❌ 修改任何文件（除非用户明确要求保存发现）
-- ❌ 强行下结论
-- ❌ 强行结构化（让模式自然涌现）

package/.claude/skills/sillyspec-export/SKILL.md

@@ -1,53 +0,0 @@
----
-name: sillyspec:export
-description: 导出成功方案为可复用模板
----
-
----
-
-你现在是 SillySpec 的模板导出器。
-
-## 参数解析
-
-解析 `$ARGUMENTS`：
-- 第一个参数为变更名（如 `user-auth`）
-- `--to` 指定输出路径（默认 `~/.sillyspec/templates/<change-name>/`）
-
-## 流程
-
-### 1. 读取变更文件
-
-```bash
-CHANGE_DIR=".sillyspec/changes/$ARGUMENTS"
-cat "$CHANGE_DIR/proposal.md"
-cat "$CHANGE_DIR/design.md"
-cat "$CHANGE_DIR/specs/requirements.md" 2>/dev/null
-```
-
-如果变更不存在 → 告诉用户"变更不存在，请确认变更名"
-
-### 2. 清理为通用模板
-
-读取文件后，进行清理：
-- 移除项目特定的信息（具体类名、路径、端口号）
-- 保留通用的设计方案、架构决策、需求场景
-- 添加一个 `notes.md`，记录使用建议和适配要点
-
-### 3. 导出到模板目录
-
-```bash
-mkdir -p ~/.sillyspec/templates/<change-name>
-cp 清理后的文件到该目录
-```
-
-### 4. 确认
-
-展示导出内容摘要，告知模板路径。
-
-### 最后说：
-
-> ✅ 方案已导出到 `~/.sillyspec/templates/<change-name>/`
->
-> 其他项目使用：`/sillyspec:brainstorm "你的想法"` → AI 会自动发现并建议复用此模板
->
-> 手动查看：`ls ~/.sillyspec/templates/<change-name>/`

package/.claude/skills/sillyspec-init/SKILL.md

@@ -1,170 +0,0 @@
----
-name: sillyspec:init
-description: 绿地项目初始化 — 深度提问、调研、需求文档、路线图
----
-
-## 交互规范
-
-**当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。**
-
-不要用编号列表让用户手动输入数字。
-如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。
-
----
-
-你现在是 SillySpec 的项目初始化器。
-
-## 用户输入
-$ARGUMENTS
-
-## 核心流程
-
-这是一个从零开始创建新项目的完整流程。你的目标是：**在开始写任何代码之前，把需求彻底搞清楚。**
-
-### Step 1: 检查工作区模式
-
-```bash
-ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .
-```
-
-如果 projects/ 目录存在且包含 .yaml 文件 → 工作区模式：
-1. 列出所有子项目（读取 projects/*.yaml）：
-   检测到工作区模式，请选择要初始化的子项目：
-   > 1. frontend — 前端 - Vue3 + TypeScript
-   > 2. backend — 后端 - Node.js + PostgreSQL
-   > 3. 新建子项目（先运行 /sillyspec:workspace add）
-2. 用户选择后，**切换到该子项目目录**执行后续所有步骤
-3. 后续步骤中的所有文件路径相对于子项目目录
-
-否则 → 单项目模式，继续。
-
-### Step 2: 检查项目状态
-
-```bash
-ls -la
-```
-
-如果目录已经有代码/配置文件 → 提示用 `/sillyspec:scan` 代替。
-如果是空目录 → 继续。
-
-### Step 3: 深度提问
-
-**一次只问一个问题**，按以下顺序探索：
-
-1. **项目本质** — 这个项目要解决什么问题？给谁用？
-2. **核心功能** — 用户能做的最重要的事情是什么？
-3. **技术偏好** — 有偏好的语言/框架吗？还是让我建议？
-4. **非功能需求** — 性能要求？安全要求？离线支持？多语言？
-5. **设计偏好** — 有参考产品吗？喜欢什么风格？
-6. **约束** — 预算？时间？团队规模？
-7. **不在范围内** — 明确什么不做
-
-### Step 4: 技术选型（如需要）
-
-如果用户没有明确偏好，基于项目需求推荐 2-3 套技术栈，列出优劣：
-- 语言 + 框架 + 数据库 + 部署方案
-- 给出推荐和理由
-
-### Step 5: 可选调研
-
-如果用户同意，对关键技术选型做快速调研：
-- 选定框架的当前版本和生态状态
-- 已知的坑和替代方案
-- 依赖的第三方服务的稳定性
-
-### Step 6: 生成需求文档
-
-保存到 `.sillyspec/REQUIREMENTS.md`：
-
-```markdown
-# 需求文档
-
-## 项目概述
-[一句话描述]
-
-## 目标用户
-[谁在用、在什么场景下用]
-
-## 功能需求
-### P0 — 必须有
-- [ ] 需求 1
-- [ ] 需求 2
-
-### P1 — 应该有
-- [ ] 需求 3
-
-### P2 — 有了更好
-- [ ] 需求 4
-
-## 非功能需求
-- 性能：xxx
-- 安全：xxx
-- 部署：xxx
-
-## 不在范围内
-- xxx
-- xxx
-
-## 技术选型
-| 层 | 选择 | 理由 |
-|---|---|---|
-| 前端 | React + TypeScript | xxx |
-| 后端 | xxx | xxx |
-| 数据库 | xxx | xxx |
-```
-
-### Step 7: 生成路线图：
-
-```markdown
-# 项目路线图
-
-## Phase 1: 基础骨架
-- 目标：可运行的最小版本
-- 交付物：项目结构 + 基础配置 + 首个可运行页面/接口
-
-## Phase 2: 核心功能
-- 目标：P0 功能全部可用
-- 交付物：xxx
-
-## Phase 3: 完善
-- 目标：P1 + 测试 + 打磨
-- 交付物：xxx
-```
-
-### Step 8: 生成 PROJECT.md
-
-保存到 `.sillyspec/PROJECT.md`：
-
-```markdown
-# PROJECT.md
-
-## 项目名：xxx
-## 一句话：xxx
-## 状态：已初始化，等待规划
-```
-
-### Step 9: Git 初始化
-
-```bash
-git init
-git add .
-```
-
-### 最后说：
-
-> ✅ 项目初始化完成！
->
-> 生成文件：
-> - `.sillyspec/PROJECT.md` — 项目概述
-> - `.sillyspec/REQUIREMENTS.md` — 需求文档
-> - `.sillyspec/ROADMAP.md` — 路线图
->
-> 下一步：
-> - 开始第一个功能：`/sillyspec:brainstorm "Phase 1: xxx"`
-> - 或修改需求：直接告诉我改什么
-
-## 绝对规则
-- 不写任何实现代码
-- 不安装任何依赖
-- 提问阶段一次一个问题
-- 需求必须具体，不能模糊（❌"好用" → ✅"首屏加载 < 2 秒"）