frontend

name	sillyspec:workspace
description	工作区管理 — 初始化、管理多项目工作区，查看子项目状态

交互规范

当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。

不要用编号列表让用户手动输入数字。 如果需要自由输入，在 AskUserQuestion 的选项中加入"Other（自定义输入）"。

---

CLI 边界（重要）

sillyspec workspace 命令已存在（2026-08-21 落地）：

sillyspec workspace add <名> <相对路径> [--role <角色>] [--repo <仓库地址>]   # 登记子项目（外科写入 yaml，已有字段保留）
sillyspec workspace remove <名>                                             # 删除登记（项目本体不动）
sillyspec workspace status                                                  # 三态探测表（已扫描/已初始化/未初始化）

优先用命令；命令异常时才按下文手工兜底（yaml 字段口径：init 写 name/path/status 三字段，role/repo 由 add 追加）。

相关 CLI 命令

sillyspec scan                       # 扫描子项目生成文档
sillyspec init [--tool <名>]         # 安装命令模板
sillyspec progress show              # 查看进度

你现在是 SillySpec 的工作区管理器。

用户指令

$ARGUMENTS

核心流程

Step 1: 检查工作区配置

ls .sillyspec/projects/*.yaml 2>/dev/null | grep -q .

如果不存在 → 这是一个尚未配置工作区的项目。询问用户：

1. 初始化工作区
2. 跳过

Step 2: 解析指令

根据 $ARGUMENTS 或默认行为：

• 无参数 / status → 显示工作区状态
• add → 添加子项目
• remove → 移除子项目
• info → 显示某个子项目详情
• 无参数且 projects/*.yaml 不存在 → 初始化工作区

Step 3: 执行对应操作

3a. 初始化工作区（projects/ 不存在时）

1. 询问工作区名称（默认用当前目录名）
2. 逐个添加子项目：
   • 询问子项目名称（如 frontend、backend）
   • 询问子项目路径（相对于工作区根目录，如 ./frontend）
   • 询问子项目角色描述（如 前端 - Vue3 + TypeScript）
   • 询问仓库地址（可选）
   • 验证路径存在 添加完后询问：

   1. 继续添加子项目
   2. 完成，配置共享规范

3. 询问共享规范文件
4. 为每个子项目创建 .sillyspec/projects/<name>.yaml：

   name: <name>
   path: <relative-path>
   status: active
   

   ⚠️ sillyspec init 只会写入 name、path、status 三个字段。 role 和 repo 由 /sillyspec:workspace add 追加。

5. 创建 .sillyspec/shared/ 目录

3b. 添加子项目（add）

1. 询问名称、路径、角色
2. 验证路径存在
3. 创建/更新 .sillyspec/projects/<name>.yaml
4. Git 提交

3c. 移除子项目（remove）

1. 显示当前所有子项目列表
2. 询问要移除哪个：

   1. （列出子项目名称）
   2. 取消

3. 删除 .sillyspec/projects/<name>.yaml
4. Git 提交

3d. 工作区状态（status，默认）

读取所有 projects/*.yaml，对每个子项目检查：

# 读取子项目列表
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:]]*//')
  # 检查子项目状态
  cd "$proj_path"
  ls .sillyspec/ 2>/dev/null
  cat .sillyspec/PROJECT.md 2>/dev/null
  ls .sillyspec/docs/${proj_name}/scan/ 2>/dev/null | wc -l
  cd -
done

输出格式：

🏢 工作区：<workspace-name>

📦 子项目（N 个）：
  ✅ frontend  ./frontend       前端 - Vue3 + TypeScript    已扫描（7 份文档）
  ⚠️ backend   ./backend        后端 - Node.js              已初始化（未扫描）
  ❌ miniprogram  ./miniprogram  小程序 - Taro               未初始化

📄 共享规范：2 份
  - api-contract.md
  - data-models.md

💡 操作：
  /sillyspec:workspace add        — 添加子项目
  /sillyspec:workspace remove     — 移除子项目
  /sillyspec:init                 — 初始化子项目
  /sillyspec:scan                 — 扫描子项目

3e. 子项目详情（info <name>）

显示指定子项目的详细信息，包括 PROJECT.md、REQUIREMENTS.md 内容摘要、扫描文档列表。

Step 4: projects/*.yaml 格式

每个子项目对应 .sillyspec/projects/<name>.yaml：

sillyspec init 创建的格式（3 字段）：

name: frontend
path: ./frontend
status: active

workspace add 扩展的格式（最多 5 字段）：

name: frontend
path: ./frontend
status: active
role: 前端 - Vue3 + TypeScript
repo: https://github.com/xxx/frontend.git  # 可选

最后说：

工作区已更新。 下一步：对子项目运行 /sillyspec:init 或 /sillyspec:scan。

绝对规则

• 不修改子项目目录下的任何文件
• projects/*.yaml 必须是合法 YAML
• 子项目路径必须是相对于工作区根目录的相对路径
• 路径必须验证存在性