SuperAPI AI 工具集

workspace

办公与效率

查看项目

更新于 10-16 00:21

技能介绍

用途:协调多仓库工作区,让共享团队上下文(PDR、ADR、CDR)集中存放在父仓库的 .adlc/ 目录,实现仓库克隆。纯约定,无 workspace.yml 或注册表文件:父仓库即当前工作目录(须为 Git 仓库),子仓库为深度 1、含 .git/ 的子目录,共享上下文为父根目录的 .adlc/。

主要能力与命令:/workspace --init 初始化并创建 .adlc/ 目录结构、检查 .gitignore 约定、发现子仓库;/workspace 只读发现并显示状态摘要;/workspace --link 将子仓库转为 Git 子模块(要求父树干净);/workspace --status 详细审计分支、脏状态、未推送、SHA 漂移与 .adlc 是否存在;/workspace --ignore-only 改为将子仓库加入 .gitignore;--dry-run 预览不执行;--force 转换已被父索引跟踪的仓库。

用法:初始化时执行 Bash 脚本 scripts/bash/setup-workspace.sh --json(PowerShell 对应 scripts/powershell/setup-workspace.ps1);审计/链接模式执行 "$(dirname "$0")/../scripts/bash/workspace.sh" --json [--link] [--status] [--dry-run] [--force] $ARGUMENTS,解析 JSON 输出。

适用场景:团队多仓库共享决策上下文;product-specify、architect-specify 生成 PDR/ADR 后;克隆新子仓库后注册或忽略;审计工作区健康;验证子仓库能否访问父级 .adlc/。

限制:--init 安全且幂等,仅创建目录并报告缺失的 .gitignore 规则,不覆盖既有内容,.gitignore 变更仅新增不移除;默认只读;--link 要求父工作树干净,子仓库须配置 origin,已注册子模块和已忽略仓库会跳过;无 origin 的子仓库报错并跳过;发现深度仅 1 层,排除 node_modules、.venv、venv、dist、build、target、.idea、.vscode、.git、.cache、.specify。若工作区已初始化,应使用 --status 而非 --init;仅审计子仓库状态时用只读 /workspace。具体收费、价格与平台支持资料暂未提供。