feat(init): label universal as shared agent directory and add coexistence docs

- Change universal description from "(recommended)" to "(shared agent directory)"
  in detect, checklist, and discover flows
- Add FAQ section on using universal alongside npx skills: merge vs copy mode
  differences, name collision caveats, lock file visibility
- Add universal info admonition to supported-targets page
- Add E2E runbook for universal target path verification
- Update CHANGELOG and release notes for v0.16.4
This commit is contained in:
Willie
2026-02-28 03:44:02 +08:00
parent 1a207e6d2c
commit 5d9a77372d
7 changed files with 183 additions and 7 deletions
+5 -3
View File
@@ -629,7 +629,7 @@ func detectCLIDirectories(home string) []detectedDir {
detected = append(detected, detectedDir{
name: "universal", path: target.Path,
})
ui.Info("Found: %-12s %s (recommended)", "universal", target.Path)
ui.Info("Found: %-12s %s (shared agent directory)", "universal", target.Path)
}
}
}
@@ -804,7 +804,9 @@ func buildTargetsList(detected []detectedDir, copyFrom, copyFromName, targetsArg
items := make([]checklistItemData, len(detected))
for i, d := range detected {
status := ""
if d.exists {
if d.name == "universal" {
status = "(shared agent directory)"
} else if d.exists {
if d.skillCount > 0 {
status = fmt.Sprintf("(%d skills)", d.skillCount)
} else {
@@ -1362,7 +1364,7 @@ func detectNewAgents(existingCfg *config.Config) []agentInfo {
newAgents = append(newAgents, agentInfo{
name: "universal",
path: target.Path,
description: "(recommended)",
description: "(shared agent directory)",
})
}
}