fix: scan agent skills for Claude workspace

Author: linhay

.agents/skills/gettokens-domain-engineering/SKILL.md

@@ -129,6 +129,7 @@ This skill unifies the technical rules for building, styling, and debugging GetT
 - **Codex Extensions**: For Codex Skills / MCP Servers, `[[skills.config]]`, `tk://github.com` / `tk://gitlab.com` skill sources, and `#frame=codex&workspace=skills|mcp-servers`, use the dedicated `gettokens-codex-extensions-management` skill. Keep source-accurate parsing, modal/list UI semantics, and cleanup split rules in that skill instead of expanding this general domain skill.
 - **Claude Code Workspace Parity**: When Claude Code adds a capability that corresponds to existing Codex workspace entries, keep the workspace granularity aligned with Codex unless Claude semantics clearly require a different information architecture.
   - If Codex exposes separate workspaces such as `#frame=codex&workspace=skills` and `#frame=codex&workspace=mcp-servers`, Claude should expose separate workspaces such as `#frame=claude&workspace=skills` and `#frame=claude&workspace=mcp-servers`, not a single merged page with internal tabs.
+  - Claude skills read-only scanning must include both native Claude roots (`$CLAUDE_CONFIG_DIR/skills` or `~/.claude/skills`, plus project `.claude/skills`) and unified Agent Skills roots (`~/.agents/skills`, plus project `.agents/skills`). GetTokens installs project skills under `.agents/skills`, so scanning only `.claude/skills` produces a false empty state.
   - Implement this split as route-level feature components, for example `ClaudeCodeSkillsWorkspace` and `ClaudeCodeMcpServersWorkspace`, with the page wrapper only dispatching by `ClaudeWorkspace`.
   - Shared shells and visual primitives are still encouraged. Reuse `AssetWorkbenchShell`, preview data, DTO mappers, and list patterns where they fit, but do not let shared UI collapse distinct navigation surfaces into one tabbed page.
   - Keep legacy hash/storage compatibility explicit. A retired merged workspace such as `extensions` may migrate to the safest default (`skills`), but should not remain a first-class menu item once split pages exist.

docs-linhay/memory/2026-05-28.md

@@ -96,3 +96,10 @@
 - preview usage 和 rate-limit 现在对新增预览账号有兜底生成逻辑，避免扩展 provider 后出现无运行态的空卡片。
 - 验收截图已归档：`docs-linhay/screenshots/20260528/accounts/20260528-accounts-full-mock-after-v01.png`。
 - 验证通过：`node --test frontend/src/features/accounts/tests/previewData.test.mjs`、`npm --prefix frontend run typecheck`、Chrome DevTools DOM 验收 `http://localhost:5173/#frame=accounts` 显示 `22 UNITS`。
+
+## Claude Skills 扫描修复
+- `#frame=claude&workspace=skills` 空态根因是后端只扫 `$CLAUDE_CONFIG_DIR/skills`、项目 `.claude/skills` 和 `.claude/commands`，但 GetTokens 当前项目级 skills 安装在 `.agents/skills`。
+- 已将 Claude Code skills snapshot 的只读扫描 roots 扩展为：native Claude roots + `~/.agents/skills` + 项目 `.agents/skills`；项目 `.agents/skills` 以 project scope 展示，用户 `~/.agents/skills` 以 user scope 展示。
+- 回归测试新增 `TestGetClaudeCodeExtensionsSnapshotScansAgentSkillRoots`，验证 `.agents/skills` 下的用户级和项目级 `SKILL.md` 都能被扫描到。
+- 已同步更新 `20260521-claude-code-codex-alignment` space 与 `.agents/skills/gettokens-domain-engineering/SKILL.md` 的 Claude Code workspace parity 规则。
+- 本机 Wails dev 页面验收通过：`http://127.0.0.1:34115/#frame=claude&workspace=skills` 显示 `41 SKILLS`，包含 `~/.agents/skills` 的 user skills 和项目 `.agents/skills` 的 project skills；截图归档到 `docs-linhay/spaces/20260521-claude-code-codex-alignment/screenshots/20260528/claude/20260528-claude-skills-scan-after-v01.png`。

docs-linhay/spaces/20260521-claude-code-codex-alignment/README.md

@@ -80,7 +80,7 @@ GetTokens 已经把 Claude Code 账号列表从旧判断里的“单 key 本地
 ### P0：Claude Code 扩展资产工作台
 
 - 新增 Claude workspace：`skills`、`mcp-servers`；旧 `extensions` 作为兼容 hash 迁移到 `skills`。
-- Skills 覆盖用户级 `~/.claude/skills/`、项目级 `.claude/skills/`、兼容 `.claude/commands/` 只读展示与迁移提示。
+- Skills 覆盖用户级 `~/.claude/skills/`、统一用户级 `~/.agents/skills/`、项目级 `.agents/skills/`、项目级 `.claude/skills/`、兼容 `.claude/commands/` 只读展示与迁移提示。
 - MCP 覆盖 user/local `~/.claude.json` 与 project `.mcp.json`，支持 stdio / http、env、headers、tool 限制和 scope 标记。
 - 新增通用 target adapter：`codex` 使用 TOML adapter，`claude` 使用 JSON / directory adapter；前端组件尽量复用现有 Codex Extensions。
 

docs-linhay/spaces/20260521-claude-code-codex-alignment/plans/research-skills-commands.md

@@ -5,27 +5,30 @@
 
 ## 结论
 
-Claude Code Skills 与 Codex Skills 在 UI 工作流上高度可复用，但数据语义必须按 Claude Code 单独实现。P0 可以做 `~/.claude/skills/`、项目 `.claude/skills/`、兼容 `.claude/commands/` 的扫描、预览、来源标记和 Git source 预研；不先做“启停开关”，因为 Claude Code 的可见性和触发控制主要来自 frontmatter，而不是 Codex 的 `[[skills.config]] enabled=false`。
+Claude Code Skills 与 Codex Skills 在 UI 工作流上高度可复用，但数据语义必须按 Claude Code 单独实现。P0 可以做 `~/.claude/skills/`、`~/.agents/skills/`、项目 `.agents/skills/`、项目 `.claude/skills/`、兼容 `.claude/commands/` 的扫描、预览、来源标记和 Git source 预研；不先做“启停开关”，因为 Claude Code 的可见性和触发控制主要来自 frontmatter，而不是 Codex 的 `[[skills.config]] enabled=false`。
 
 ## 已验证依据
 
 - 官方文档确认：skill 是包含 `SKILL.md` 的目录；personal 路径为 `~/.claude/skills/<skill-name>/SKILL.md`，project 路径为 `.claude/skills/<skill-name>/SKILL.md`；legacy `.claude/commands/` 仍可用，并且 skill 与 command 同名时 skill 优先。
 - 官方 frontmatter 已确认包含 `name`、`description`、`when_to_use`、`argument-hint`、`arguments`、`disable-model-invocation`、`user-invocable`、`allowed-tools`、`model`、`effort`、`context`、`agent`、`hooks`、`paths`、`shell` 等字段。
 - 本地参考 `docs-linhay/references/cherry-studio/scripts/skills-sync.ts` 已证明 `.agents/skills/<skill>` 可以通过 symlink mirror 到 `.claude/skills/<skill>`。
 - 本地参考 `docs-linhay/references/cherry-studio/scripts/skills-check.ts` 已证明 skill 白名单、symlink 目标和 git tracked 文件范围可以自动校验。
+- GetTokens 当前项目级 skills 实际安装在 `.agents/skills/`，用户级开放标准目录为 `~/.agents/skills/`；Claude skills 页面只读扫描必须直接覆盖这两类 roots，否则本机页面会误显示空态。
 - 可行性验证已跑过 Node frontmatter 解析原型，可解析 `SKILL.md` 的 YAML frontmatter 与 markdown body。
 
 ## 数据边界
 
 - 读取 roots：
   - user：`$CLAUDE_CONFIG_DIR/skills` 或默认 `~/.claude/skills`
+  - user agent：`~/.agents/skills`
+  - project agent：`<repo>/.agents/skills`
   - project：`<repo>/.claude/skills`
   - legacy command：`<repo>/.claude/commands`
 - P0 写入：不写入用户现有 skill；只提供扫描和预览。
 - P1 写入：
   - 新增 skill：仅写目标 root 下的新目录，目录名 slug 校验。
   - 删除：需要二次确认，只允许删除已识别 root 内目录。
-  - `.agents/skills` mirror：优先采用 symlink，Windows 或权限受限时降级为复制前必须另行验证。
+  - `.agents/skills` mirror：只读扫描可直接读取；涉及同步到 `.claude/skills` 时优先采用 symlink，Windows 或权限受限时降级为复制前必须另行验证。
 - 不复用 Codex 的 `[[skills.config]] enabled=false`，Claude Code 没有同构禁用语义。
 
 ## 后端设计
@@ -55,6 +58,7 @@ Claude Code Skills 与 Codex Skills 在 UI 工作流上高度可复用，但数
 
 - `internal/wailsapp/claude_code_extensions_test.go`：
   - 扫描 `CLAUDE_CONFIG_DIR/skills/foo/SKILL.md`。
+  - 扫描 `~/.agents/skills/foo/SKILL.md` 和项目 `.agents/skills/bar/SKILL.md`。
   - 扫描项目 `.claude/skills/bar/SKILL.md`。
   - 扫描 `.claude/commands/deploy.md` 为 `legacy-command`。
   - frontmatter 缺失时从正文首段生成摘要。
@@ -75,4 +79,3 @@ Claude Code Skills 与 Codex Skills 在 UI 工作流上高度可复用，但数
 
 - skill live reload 与新目录 watch 有差异，GetTokens 只能提示“Claude Code 可能需要重启会话”，不应承诺立即生效。
 - `allowed-tools`、`hooks`、`paths` 等字段未来可能变化，P0 解析时必须保留未知 frontmatter。
-

docs-linhay/spaces/20260521-claude-code-codex-alignment/screenshots/20260528/claude/20260528-claude-skills-scan-after-v01.png

@@ -241,11 +241,16 @@ type claudeCodeSkillRoot struct {
 }
 
 func scanClaudeCodeSkills(claudeConfigDir string, projectPath string) ([]ClaudeCodeSkillAsset, []string) {
+	home, homeErr := os.UserHomeDir()
 	roots := []claudeCodeSkillRoot{
 		{scope: "user", path: filepath.Join(claudeConfigDir, "skills"), removable: true},
 	}
+	if homeErr == nil && home != "" {
+		roots = append(roots, claudeCodeSkillRoot{scope: "user", path: filepath.Join(home, ".agents", "skills"), removable: true})
+	}
 	if projectPath != "" {
 		roots = append(roots,
+			claudeCodeSkillRoot{scope: "project", path: filepath.Join(projectPath, ".agents", "skills")},
 			claudeCodeSkillRoot{scope: "project", path: filepath.Join(projectPath, ".claude", "skills")},
 			claudeCodeSkillRoot{scope: "legacy-command", path: filepath.Join(projectPath, ".claude", "commands"), commands: true},
 		)

internal/wailsapp/claude_code_extensions.go

@@ -140,6 +140,57 @@ func TestGetClaudeCodeExtensionsSnapshotHandlesMissingAssets(t *testing.T) {
 	}
 }
 
+func TestGetClaudeCodeExtensionsSnapshotScansAgentSkillRoots(t *testing.T) {
+	base := t.TempDir()
+	home := filepath.Join(base, "home")
+	project := filepath.Join(base, "project")
+	claudeConfigDir := filepath.Join(home, ".claude")
+	t.Setenv("HOME", home)
+	t.Setenv("CLAUDE_CONFIG_DIR", claudeConfigDir)
+	mustMkdirAll(t, project)
+
+	previousCwd, err := os.Getwd()
+	if err != nil {
+		t.Fatalf("Getwd: %v", err)
+	}
+	if err := os.Chdir(project); err != nil {
+		t.Fatalf("Chdir project: %v", err)
+	}
+	project, err = os.Getwd()
+	if err != nil {
+		t.Fatalf("Getwd project: %v", err)
+	}
+	t.Cleanup(func() {
+		_ = os.Chdir(previousCwd)
+	})
+
+	writeTextFile(t, filepath.Join(home, ".agents", "skills", "user-agent-skill", "SKILL.md"), strings.Join([]string{
+		"---",
+		"name: user-agent-skill",
+		"description: User agent skill.",
+		"---",
+		"",
+		"# User Agent Skill",
+	}, "\n"))
+	writeTextFile(t, filepath.Join(project, ".agents", "skills", "project-agent-skill", "SKILL.md"), strings.Join([]string{
+		"---",
+		"name: project-agent-skill",
+		"description: Project agent skill.",
+		"---",
+		"",
+		"# Project Agent Skill",
+	}, "\n"))
+
+	app := &App{}
+	snapshot, err := app.GetClaudeCodeExtensionsSnapshot()
+	if err != nil {
+		t.Fatalf("GetClaudeCodeExtensionsSnapshot returned error: %v", err)
+	}
+
+	assertClaudeSkill(t, snapshot.Skills, "user-agent-skill", "user", "auto", "enabled", "valid")
+	assertClaudeSkill(t, snapshot.Skills, "project-agent-skill", "project", "auto", "enabled", "valid")
+}
+
 func TestSaveClaudeCodeMcpServerPatchesProjectServerPreservingUnknownFields(t *testing.T) {
 	base := t.TempDir()
 	home := filepath.Join(base, "home")