fix(skill): organize instructions and version navigation in detail tabs

Signed-off-by: XiaoSeS <87064762+XiaoSeS@users.noreply.github.com>
This commit is contained in:
XiaoSeS 2026-11-04 17:44:12 +08:00
parent f888a2d884
commit db2be92e0b
14 changed files with 491 additions and 114 deletions

View file

@ -1,7 +1,7 @@
{
"schema": 1,
"description": "Source declarations, not runtime DOM counts, pageviews, successful outcomes or a closed runtime enum. Forwarding sites require explicit callers. See frontend-analytics.md for gaps and event policy.",
"counts": {"routes":54,"uniqueIds":804,"literalJsxSites":823,"literalJsxValues":977,"navigationDefinitions":29,"forwardingSites":36},
"counts": {"routes":54,"uniqueIds":810,"literalJsxSites":830,"literalJsxValues":984,"navigationDefinitions":29,"forwardingSites":36},
"routes": [
{"name":"landingRoute","path":"/","declaration":{"file":"web/src/app/router.tsx","line":258},"implementation":{"file":"web/src/pages/landing.tsx","line":258,"export":"LandingPage"},"guarded":false,"roleProtected":false},
{"name":"skillsRoute","path":"skills","declaration":{"file":"web/src/app/router.tsx","line":264},"implementation":{"file":"web/src/pages/home.tsx","line":12,"export":"HomePage"},"guarded":false,"roleProtected":false},
@ -16,7 +16,7 @@
{"name":"termsRoute","path":"terms","declaration":{"file":"web/src/app/router.tsx","line":344},"implementation":{"file":"web/src/pages/terms.tsx","line":171,"export":"TermsOfServicePage"},"guarded":false,"roleProtected":false},
{"name":"namespaceRoute","path":"/space/$namespace","declaration":{"file":"web/src/app/router.tsx","line":350},"implementation":{"file":"web/src/pages/namespace.tsx","line":5,"export":"NamespacePage"},"guarded":true,"roleProtected":false},
{"name":"joinRoute","path":"join","declaration":{"file":"web/src/app/router.tsx","line":357},"implementation":{"file":"web/src/pages/join.tsx","line":12,"export":"JoinPage"},"guarded":true,"roleProtected":false},
{"name":"skillDetailRoute","path":"/space/$namespace/$slug","declaration":{"file":"web/src/app/router.tsx","line":364},"implementation":{"file":"web/src/pages/skill-detail.tsx","line":133,"export":"SkillDetailPage"},"guarded":false,"roleProtected":false},
{"name":"skillDetailRoute","path":"/space/$namespace/$slug","declaration":{"file":"web/src/app/router.tsx","line":364},"implementation":{"file":"web/src/pages/skill-detail.tsx","line":134,"export":"SkillDetailPage"},"guarded":false,"roleProtected":false},
{"name":"skillVersionCompareRoute","path":"/space/$namespace/$slug/compare","declaration":{"file":"web/src/app/router.tsx","line":374},"implementation":{"file":"web/src/pages/skill-version-compare.tsx","line":5,"export":"SkillVersionComparePage"},"guarded":false,"roleProtected":false},
{"name":"dashboardRoute","path":"dashboard","declaration":{"file":"web/src/app/router.tsx","line":384},"implementation":{"file":"web/src/pages/dashboard.tsx","line":97,"export":"DashboardPage"},"guarded":true,"roleProtected":false},
{"name":"dashboardSkillsRoute","path":"dashboard/skills","declaration":{"file":"web/src/app/router.tsx","line":391},"implementation":{"file":"web/src/pages/dashboard/my-skills.tsx","line":59,"export":"MySkillsPage"},"guarded":true,"roleProtected":false},
@ -318,6 +318,8 @@
{"file":"web/src/features/skill/skill-avatar-manager.tsx","line":52,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.avatar.retry"]},
{"file":"web/src/features/skill/skill-avatar-takedown.tsx","line":21,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.avatar.takedown"]},
{"file":"web/src/features/skill/skill-card.tsx","line":37,"host":"Card","prop":"data-analytics-id","event":"click+keydown-enter-space","ids":[],"conditional":true,"forward":"analyticsId"},
{"file":"web/src/features/skill/skill-instructions.tsx","line":27,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.instructions.retry"]},
{"file":"web/src/features/skill/skill-instructions.tsx","line":44,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.instructions.source.toggle"]},
{"file":"web/src/features/skill/skill-label-panel.tsx","line":181,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.label.privileged.detach","skill.label.recommended.detach","suite.label.privileged.detach","suite.label.recommended.detach"],"conditional":true},
{"file":"web/src/features/skill/skill-label-panel.tsx","line":212,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.label.privileged.attach","skill.label.recommended.attach","suite.label.privileged.attach","suite.label.recommended.attach"],"conditional":true},
{"file":"web/src/features/skill/skill-version-compare-content.tsx","line":164,"host":"SelectTrigger","prop":"data-analytics-id","event":"click+keydown-intent","ids":["skill.comparison.base.interact"]},
@ -829,79 +831,84 @@
{"file":"web/src/pages/settings/profile.tsx","line":215,"host":"form","prop":"data-analytics-id","event":"submit","ids":["account.profile.save"]},
{"file":"web/src/pages/settings/profile.tsx","line":261,"host":"Button","prop":"data-analytics-id","event":"click","ids":["account.profile.cancel"]},
{"file":"web/src/pages/settings/security.tsx","line":96,"host":"form","prop":"data-analytics-id","event":"submit","ids":["account.password.save"]},
{"file":"web/src/pages/skill-detail.tsx","line":832,"host":"Button","prop":"data-analytics-id","event":"click","ids":["auth.login.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":868,"host":"div","prop":"data-analytics-id","event":"structural","ids":["skill.detail.render"]},
{"file":"web/src/pages/skill-detail.tsx","line":873,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.detail.back"]},
{"file":"web/src/pages/skill-detail.tsx","line":924,"host":"CopyButton","prop":"analyticsId","event":"click","ids":["skill.coordinate.copy"]},
{"file":"web/src/pages/skill-detail.tsx","line":946,"host":"Link","prop":"data-analytics-id","event":"click","ids":["search.label.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":986,"host":"TabsTrigger","prop":"data-analytics-id","event":"click","ids":["skill.overview.tab"]},
{"file":"web/src/pages/skill-detail.tsx","line":987,"host":"TabsTrigger","prop":"data-analytics-id","event":"click","ids":["skill.files.tab"]},
{"file":"web/src/pages/skill-detail.tsx","line":988,"host":"TabsTrigger","prop":"data-analytics-id","event":"click","ids":["skill.versions.tab"]},
{"file":"web/src/pages/skill-detail.tsx","line":1022,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.overview.toggle"]},
{"file":"web/src/pages/skill-detail.tsx","line":1065,"host":"FileTree","prop":"analyticsId","event":"click","ids":["skill.file.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1104,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.comparison.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1111,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.rerelease.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1121,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.delete"]},
{"file":"web/src/pages/skill-detail.tsx","line":1130,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.review.withdraw"]},
{"file":"web/src/pages/skill-detail.tsx","line":1139,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.publish"]},
{"file":"web/src/pages/skill-detail.tsx","line":1148,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.review.submit"]},
{"file":"web/src/pages/skill-detail.tsx","line":1185,"host":"button","prop":"data-analytics-id","event":"click","ids":["skill.browser.toggle"]},
{"file":"web/src/pages/skill-detail.tsx","line":1207,"host":"FileTree","prop":"analyticsId","event":"click","ids":["skill.file.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1260,"host":"Button","prop":"data-analytics-id","event":"click","ids":["report.create.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1298,"host":"Link","prop":"data-analytics-id","event":"click","ids":["suite.detail.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1325,"host":"Link","prop":"data-analytics-id","event":"click","ids":["skill.related.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1380,"host":"InstallCommand","prop":"analyticsId","event":"click","ids":["skill.command.copy"]},
{"file":"web/src/pages/skill-detail.tsx","line":1380,"host":"InstallCommand","prop":"skillhubAnalyticsId","event":"click","ids":["skill.command.skillhub.select"]},
{"file":"web/src/pages/skill-detail.tsx","line":1380,"host":"InstallCommand","prop":"clawhubAnalyticsId","event":"click","ids":["skill.command.clawhub.select"]},
{"file":"web/src/pages/skill-detail.tsx","line":1420,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.review.withdraw"]},
{"file":"web/src/pages/skill-detail.tsx","line":1430,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.download.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1449,"host":"InstallForAgentButton","prop":"analyticsId","event":"click","ids":["skill.prompt.copy"]},
{"file":"web/src/pages/skill-detail.tsx","line":1521,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.unarchive.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1525,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.archive.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1530,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.delete.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1562,"host":"SelectTrigger","prop":"data-analytics-id","event":"click+keydown-intent","ids":["skill.promotion.version.interact"]},
{"file":"web/src/pages/skill-detail.tsx","line":1567,"host":"SelectItem","prop":"data-analytics-id","event":"radix-item-intent","ids":["skill.promotion.version"]},
{"file":"web/src/pages/skill-detail.tsx","line":1576,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.promotion.create.request","skill.promotion.update.request"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1589,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1593,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.direct"]},
{"file":"web/src/pages/skill-detail.tsx","line":1628,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.hide.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1632,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.unhide.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1638,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.yank"]},
{"file":"web/src/pages/skill-detail.tsx","line":1648,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["report.create.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1668,"host":"Button","prop":"data-analytics-id","event":"click","ids":["report.create.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1671,"host":"Button","prop":"data-analytics-id","event":"click","ids":["report.create.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1678,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.promotion.create.confirm","skill.promotion.update.confirm"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1678,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.promotion.create.cancel","skill.promotion.update.cancel"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1697,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.revocation.direct.cancel","skill.revocation.request.cancel"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1710,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.direct.cancel","skill.revocation.request.cancel"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1711,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.direct.submit","skill.revocation.request.submit"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1718,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.archive.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1718,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.archive.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1727,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.unarchive.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1727,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.unarchive.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1736,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.delete.continue"]},
{"file":"web/src/pages/skill-detail.tsx","line":1736,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.delete.continue.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1755,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.delete.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1771,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.delete.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1774,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.delete.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1785,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.version.delete.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1785,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.version.delete.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1799,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.review.withdraw.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1799,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.review.withdraw.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1823,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.rerelease.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1843,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.rerelease.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1846,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.rerelease.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1853,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.rerelease.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1853,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.rerelease.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1874,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.version.publish.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1874,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.version.publish.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1887,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.review.submit.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1887,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.review.submit.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1909,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.comparison.close"]},
{"file":"web/src/pages/skill-detail.tsx","line":1974,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.comparison.close"]},
{"file":"web/src/pages/skill-detail.tsx","line":1988,"host":"FilePreviewDialog","prop":"closeAnalyticsId","event":"click","ids":["skill.file.close"]},
{"file":"web/src/pages/skill-detail.tsx","line":1988,"host":"FilePreviewDialog","prop":"downloadAnalyticsId","event":"click","ids":["skill.file.download"]},
{"file":"web/src/pages/skill-detail.tsx","line":1988,"host":"FilePreviewDialog","prop":"copyAnalyticsId","event":"click","ids":["skill.file.copy"]},
{"file":"web/src/pages/skill-detail.tsx","line":854,"host":"Button","prop":"data-analytics-id","event":"click","ids":["auth.login.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":889,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.retry"]},
{"file":"web/src/pages/skill-detail.tsx","line":903,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.latest"]},
{"file":"web/src/pages/skill-detail.tsx","line":916,"host":"div","prop":"data-analytics-id","event":"structural","ids":["skill.detail.render"]},
{"file":"web/src/pages/skill-detail.tsx","line":921,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.detail.back"]},
{"file":"web/src/pages/skill-detail.tsx","line":972,"host":"CopyButton","prop":"analyticsId","event":"click","ids":["skill.coordinate.copy"]},
{"file":"web/src/pages/skill-detail.tsx","line":994,"host":"Link","prop":"data-analytics-id","event":"click","ids":["search.label.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1034,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.latest"]},
{"file":"web/src/pages/skill-detail.tsx","line":1038,"host":"TabsTrigger","prop":"data-analytics-id","event":"click","ids":["skill.overview.tab"]},
{"file":"web/src/pages/skill-detail.tsx","line":1039,"host":"TabsTrigger","prop":"data-analytics-id","event":"click","ids":["skill.instructions.tab"]},
{"file":"web/src/pages/skill-detail.tsx","line":1040,"host":"TabsTrigger","prop":"data-analytics-id","event":"click","ids":["skill.files.tab"]},
{"file":"web/src/pages/skill-detail.tsx","line":1041,"host":"TabsTrigger","prop":"data-analytics-id","event":"click","ids":["skill.versions.tab"]},
{"file":"web/src/pages/skill-detail.tsx","line":1069,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.overview.toggle"]},
{"file":"web/src/pages/skill-detail.tsx","line":1115,"host":"FileTree","prop":"analyticsId","event":"click","ids":["skill.file.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1149,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.view"]},
{"file":"web/src/pages/skill-detail.tsx","line":1155,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.comparison.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1162,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.rerelease.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1172,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.delete"]},
{"file":"web/src/pages/skill-detail.tsx","line":1181,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.review.withdraw"]},
{"file":"web/src/pages/skill-detail.tsx","line":1190,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.publish"]},
{"file":"web/src/pages/skill-detail.tsx","line":1199,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.review.submit"]},
{"file":"web/src/pages/skill-detail.tsx","line":1236,"host":"button","prop":"data-analytics-id","event":"click","ids":["skill.browser.toggle"]},
{"file":"web/src/pages/skill-detail.tsx","line":1258,"host":"FileTree","prop":"analyticsId","event":"click","ids":["skill.file.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1311,"host":"Button","prop":"data-analytics-id","event":"click","ids":["report.create.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1349,"host":"Link","prop":"data-analytics-id","event":"click","ids":["suite.detail.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1376,"host":"Link","prop":"data-analytics-id","event":"click","ids":["skill.related.open"]},
{"file":"web/src/pages/skill-detail.tsx","line":1431,"host":"InstallCommand","prop":"analyticsId","event":"click","ids":["skill.command.copy"]},
{"file":"web/src/pages/skill-detail.tsx","line":1431,"host":"InstallCommand","prop":"skillhubAnalyticsId","event":"click","ids":["skill.command.skillhub.select"]},
{"file":"web/src/pages/skill-detail.tsx","line":1431,"host":"InstallCommand","prop":"clawhubAnalyticsId","event":"click","ids":["skill.command.clawhub.select"]},
{"file":"web/src/pages/skill-detail.tsx","line":1471,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.review.withdraw"]},
{"file":"web/src/pages/skill-detail.tsx","line":1481,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.download.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1500,"host":"InstallForAgentButton","prop":"analyticsId","event":"click","ids":["skill.prompt.copy"]},
{"file":"web/src/pages/skill-detail.tsx","line":1572,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.unarchive.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1576,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.archive.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1581,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.delete.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1613,"host":"SelectTrigger","prop":"data-analytics-id","event":"click+keydown-intent","ids":["skill.promotion.version.interact"]},
{"file":"web/src/pages/skill-detail.tsx","line":1618,"host":"SelectItem","prop":"data-analytics-id","event":"radix-item-intent","ids":["skill.promotion.version"]},
{"file":"web/src/pages/skill-detail.tsx","line":1627,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.promotion.create.request","skill.promotion.update.request"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1640,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1644,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.direct"]},
{"file":"web/src/pages/skill-detail.tsx","line":1679,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.hide.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1683,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.unhide.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1689,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.version.yank"]},
{"file":"web/src/pages/skill-detail.tsx","line":1699,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["report.create.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1719,"host":"Button","prop":"data-analytics-id","event":"click","ids":["report.create.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1722,"host":"Button","prop":"data-analytics-id","event":"click","ids":["report.create.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1729,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.promotion.create.confirm","skill.promotion.update.confirm"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1729,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.promotion.create.cancel","skill.promotion.update.cancel"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1748,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.revocation.direct.cancel","skill.revocation.request.cancel"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1761,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.direct.cancel","skill.revocation.request.cancel"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1762,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.revocation.direct.submit","skill.revocation.request.submit"],"conditional":true},
{"file":"web/src/pages/skill-detail.tsx","line":1769,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.archive.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1769,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.archive.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1778,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.unarchive.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1778,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.unarchive.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1787,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.delete.continue"]},
{"file":"web/src/pages/skill-detail.tsx","line":1787,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.delete.continue.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1806,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.delete.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1822,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.delete.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1825,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.delete.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1836,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.version.delete.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1836,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.version.delete.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1850,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.review.withdraw.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1850,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.review.withdraw.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1874,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.rerelease.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1894,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.rerelease.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1897,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.rerelease.request"]},
{"file":"web/src/pages/skill-detail.tsx","line":1904,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.rerelease.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1904,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.rerelease.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1925,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.version.publish.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1925,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.version.publish.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1938,"host":"ConfirmDialog","prop":"confirmAnalyticsId","event":"click","ids":["skill.review.submit.confirm"]},
{"file":"web/src/pages/skill-detail.tsx","line":1938,"host":"ConfirmDialog","prop":"cancelAnalyticsId","event":"click","ids":["skill.review.submit.cancel"]},
{"file":"web/src/pages/skill-detail.tsx","line":1960,"host":"DialogContent","prop":"closeAnalyticsId","event":"click","ids":["skill.comparison.close"]},
{"file":"web/src/pages/skill-detail.tsx","line":2025,"host":"Button","prop":"data-analytics-id","event":"click","ids":["skill.comparison.close"]},
{"file":"web/src/pages/skill-detail.tsx","line":2039,"host":"FilePreviewDialog","prop":"closeAnalyticsId","event":"click","ids":["skill.file.close"]},
{"file":"web/src/pages/skill-detail.tsx","line":2039,"host":"FilePreviewDialog","prop":"downloadAnalyticsId","event":"click","ids":["skill.file.download"]},
{"file":"web/src/pages/skill-detail.tsx","line":2039,"host":"FilePreviewDialog","prop":"copyAnalyticsId","event":"click","ids":["skill.file.copy"]},
{"file":"web/src/pages/suite-detail.tsx","line":116,"host":"Button","prop":"data-analytics-id","event":"click","ids":["suite.command.copy"]},
{"file":"web/src/pages/suite-detail.tsx","line":122,"host":"Button","prop":"data-analytics-id","event":"click","ids":["suite.command.copy"]},
{"file":"web/src/pages/suite-detail.tsx","line":128,"host":"Button","prop":"data-analytics-id","event":"click","ids":["suite.draft.edit"]},

View file

@ -27,6 +27,12 @@ Resolve versions by an exact version, tag, or fingerprint; `^` / `~` ranges are
Use Update in My Skills or publish again to the same namespace and skill name. Verify the coordinate: changing `name` may create a different skill. Published versions cannot be overwritten; use a new version for normal updates. While it awaits review, public users retain the previously published version. After approval, check the displayed version, title and summary.
### Browse historical versions and original instructions
The detail page separates Overview, Skill instructions, Files, and Versions. Overview displays the selected version's introduction; Skill instructions reads that version's original `SKILL.md` with rendered and source modes; Files retains the complete package tree. To browse a historical version, open Versions and choose View this version. The page returns to Overview and identifies the historical version, with an action to return to the latest published version. The summary, documentation, file inventory, and install/download targets follow the selected version. Refresh and browser back/forward retain the version represented by the URL.
Browsing changes only the reading target: it does not publish, rerelease, submit a review, or update an installed skill. Existing access restrictions still apply, including unpublished versions.
Existing local installations do not update automatically. Consumers explicitly upgrade through the CLI. Suite members remain pinned until a new Suite version is published.
### Tracking and Managing My Skills
@ -51,7 +57,6 @@ Version comparison opens in a centered dialog and only compares accessible publi
| Review rejected | Read the decision, revise the package and use the supported resubmission flow |
| Frozen namespace or removed membership | Restore legitimate write access first; a previously installed copy grants no publishing rights |
## Prepare metadata and choose a publishing entry
### Prepare metadata

View file

@ -27,6 +27,12 @@ my-skill/
在“我的技能”选择更新,或对原坐标重新发布。修改 `name` 可能创建另一技能;已发布版本不可覆盖,迭代使用新版本号。待审期间公众仍见旧版本;批准后核对详情版本、名称和摘要。
### 查看历史版本与原始指令
技能详情的“概述”展示当前所选版本的介绍;“技能指令”读取该版本原始 `SKILL.md`,可切换渲染与源码;“文件”保留完整包目录。无需重新发布即可查看历史版本:进入“版本”,在目标记录选择“查看此版本”,页面返回概述。页面会标注正在查看的历史版本,可选择返回最新已发布版本;简介、正文、文件和安装/下载目标应与所选版本一致。刷新及浏览器前进、后退保留 URL 对应版本。
查看版本只改变阅读对象,不会创建或发布版本,也不会升级本地安装。没有权限的版本不会因切换入口变得可读;待审内容仍受原访问权限限制。
本地已有安装不会因服务端发布新版而自动更新。使用者需要明确执行 CLI 升级;套装成员还受套装固定版本约束,不能以成员发布新版本代替发布新的套装版本。
### 在“我的技能”跟踪与管理

View file

@ -5,3 +5,11 @@
- Keep the existing display-name/version snapshot model and publish/review/rollback lifecycle. Pending versions never update the Skill container summary.
- The effective short description feeds `skill.summary`; search also retains the original package description in `search_text`. Overview is detail-only and falls back to README then SKILL.md in the existing documentation reader.
- Web package preview supplies defaults without editing the uploaded archive. Generated API types remain authoritative.
## 详情阅读与版本导航
详情页采用“概述/技能指令/文件/版本”四个 Tab。概述面向使用者展示版本介绍;技能指令展示该版本根目录的原始 `SKILL.md`,提供渲染与源码两种阅读方式,不通过弹窗或概述上方的额外按钮承载入口。指令读取复用版本文件接口,加载、读取失败与缺少文件分别表达,失败不得回退为其他版本的正文。
版本选择放在“版本”Tab 的每条记录中。选择“查看此版本”只更新现有 URL 的 `version` 条件,保留其他导航上下文,并返回概述;浏览器前进、后退与刷新继续按照 URL 读取版本。简介、概述、技能指令、文件和安装/下载目标使用同一选中版本。历史版本显示明确提示,返回最新版使用当前已发布版本,不把待审版本误称为最新版。选择版本不创建版本、不提审、不重新发布,访问边界沿用服务端授权。
折叠状态与技能指令阅读模式按版本重置,避免旧正文或阅读状态在版本之间串用。本次交互调整不替代此前字段继承、审核展示等诊断缺陷的修复及验收。

View file

@ -1,23 +1,74 @@
# Requirements
## Presentation metadata
## ADDED Requirements
### Requirement: Presentation metadata
The system MUST accept optional `metadata.short-description` and `metadata.overview` in SKILL.md. The short description MUST be at most 200 characters and the overview at most 20,000 characters.
## Web publish precedence
#### Scenario: Validate optional package presentation fields
- **GIVEN** a package with optional short-description and overview metadata
- **WHEN** the package is validated
- **THEN** values within the respective limits are accepted and values beyond them are rejected
### Requirement: Web publish precedence
A web-provided value MUST override the package value for that submitted version. The archive MUST remain unchanged. Reset MUST remove the custom override so the package/default resolution applies.
## Lifecycle isolation
#### Scenario: Override package defaults without rewriting files
- **GIVEN** package metadata and explicit web values
- **WHEN** the version is submitted
- **THEN** the explicit web edits win and the original package files remain unchanged
#### Scenario: Restore defaults for a later version
- **GIVEN** a reset request
- **WHEN** the version publishes
- **THEN** it uses package defaults and later default versions read their own package defaults
### Requirement: Lifecycle isolation
A pending version MUST NOT replace the currently published title, summary, or overview. Published metadata MUST be restored by rollback/yank using the selected published version snapshot.
## Search and detail
#### Scenario: Keep a pending update separate
- **GIVEN** an existing published version
- **WHEN** an update is submitted for review
- **THEN** the public title, summary, and overview remain unchanged until publication
#### Scenario: Restore a published snapshot after rollback
- **GIVEN** published versions with different presentation fields
- **WHEN** yanking changes the published pointer
- **THEN** the public presentation follows the selected published version snapshot
### Requirement: Search and detail
The effective short description MUST be used as the public summary. The original package description MUST remain searchable. The detailed overview MUST NOT be indexed and MUST fall back to README.md then SKILL.md when no explicit/package overview exists.
## Scenarios
#### Scenario: Resolve default and custom presentation
- **GIVEN** an accessible skill version
- **WHEN** a reader views its details or searches for it
- **THEN** the summary uses the effective short description, the original description remains searchable, and the overview is detail-only with the documented fallback order
- Given package metadata and web values, when previewing, the form is prefilled from package defaults and explicit edits win.
- Given a pending update, when it is submitted, public summary remains unchanged until publication.
- Given reset, when the version publishes, it uses package defaults and later default versions read their own package defaults.
### Requirement: Version-scoped detail navigation
The detail page MUST present Overview, Skill instructions, Files, and Versions tabs. Skill instructions MUST read the selected version's original root `SKILL.md`, support rendered and source modes, and distinguish loading, missing-file, and read-failure states. The overview MUST NOT contain an extra View SKILL.md button.
#### Scenario: Browse an accessible historical version
- **GIVEN** multiple accessible versions
- **WHEN** a reader chooses View this version in the Versions tab
- **THEN** the page returns to Overview and updates the URL version without losing other search context
- **AND** the summary, overview, instructions, file inventory, and install/download targets follow that same version
- **AND** a historical-version notice and return-to-latest-published action are available where applicable
- **AND** browsing does not publish, rerelease, or submit a review
#### Scenario: Restore a version from browser history
- **GIVEN** a URL selecting an accessible version
- **WHEN** the reader refreshes or uses browser back/forward
- **THEN** the detail content follows the version represented by the URL
#### Scenario: Read original instructions
- **GIVEN** an accessible version with a root SKILL.md
- **WHEN** the reader opens Skill instructions
- **THEN** rendered and source views show that version's original file content without rewriting it
#### Scenario: Handle missing or unreadable instructions
- **GIVEN** a missing or failed file response
- **WHEN** the reader opens Skill instructions
- **THEN** an explicit empty or retryable error state is shown rather than another version's instructions
#### Scenario: Reset transient reading state
- **GIVEN** an expanded overview or source instruction view
- **WHEN** the selected version changes
- **THEN** transient overview and instruction reading state resets for the new version

View file

@ -7,4 +7,11 @@
- [x] Add web short-description and Markdown-overview inputs.
- [x] Add full inheritance/restore-default/rollback acceptance coverage (published-only frozen inheritance, reset/default-not-copied, yank rollback, approval, promotion, and rerelease).
- [x] Regenerate OpenAPI types and update CLI usage documentation.
- [x] Add detail-page overview projection and View SKILL.md entry.
- [x] Add detail-page overview projection.
- [x] Replace the standalone SKILL.md button with the Skill instructions tab and rendered/source reading.
- [x] Add read-only version selection in the Versions tab, historical-version notice, and return to latest published.
- [x] Add regression coverage for selected-version navigation, unavailable/error responses, instruction reading, and asynchronous keyboard focus.
## Acceptance status
The checklist records implementation and automated coverage, not full PR acceptance. Earlier real-runtime diagnostics identified unresolved presentation inheritance and reviewer-content visibility defects. The detail-navigation follow-up does not mark those scenarios as passed; browser validation and the full presentation acceptance matrix must be reported separately.

View file

@ -0,0 +1,40 @@
/** @vitest-environment jsdom */
import { cleanup, fireEvent, render, screen } from '@testing-library/react'
import { afterEach, describe, expect, it, vi } from 'vitest'
import { SkillInstructions } from './skill-instructions'
const query = vi.hoisted(() => ({ data: '# Original instructions', error: null as unknown, isLoading: false, refetch: vi.fn() }))
vi.mock('@/shared/hooks/use-skill-queries', () => ({ useSkillFile: () => query }))
vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string) => key }) }))
vi.mock('./markdown-renderer', () => ({ MarkdownRenderer: ({ content }: {content: string}) => <article>{content}</article> }))
const props = { namespace: 'team', slug: 'example', version: '1.0.0', available: true, loading: false, error: null, retryFiles: vi.fn(), onLinkClick: vi.fn() }
afterEach(() => { cleanup(); query.error = null; query.isLoading = false; vi.clearAllMocks() })
describe('skill instruction reading', () => {
it('reads original content and toggles source without modifying it', () => {
render(<SkillInstructions {...props} />)
expect(screen.getByRole('article').textContent).toBe(query.data)
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.instructionsSource' }))
expect(screen.getByText(query.data).closest('pre')).toBeTruthy()
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.instructionsRendered' }))
expect(screen.getByRole('article')).toBeTruthy()
})
it('reports load failure and retries the file query', () => {
query.error = new Error('failed')
render(<SkillInstructions {...props} />)
expect(screen.getByRole('alert')).toBeTruthy()
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.instructionsRetry' }))
expect(query.refetch).toHaveBeenCalledOnce()
})
it('retries directory failure rather than substituting README', () => {
render(<SkillInstructions {...props} error={new Error('files failed')} />)
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.instructionsRetry' }))
expect(props.retryFiles).toHaveBeenCalledOnce()
expect(screen.queryByRole('article')).toBeNull()
})
it('distinguishes missing files from loading', () => {
const { rerender } = render(<SkillInstructions {...props} available={false} loading />)
expect(screen.getByRole('status').textContent).toBe('skillDetail.instructionsLoading')
rerender(<SkillInstructions {...props} available={false} />)
expect(screen.getByText('skillDetail.instructionsMissing')).toBeTruthy()
expect(screen.queryByRole('article')).toBeNull()
})
})

View file

@ -0,0 +1,58 @@
import { useState, type MouseEvent } from 'react'
import { useTranslation } from 'react-i18next'
import { useSkillFile } from '@/shared/hooks/use-skill-queries'
import { Button } from '@/shared/ui/button'
import { Card } from '@/shared/ui/card'
import { MarkdownRenderer } from './markdown-renderer'
interface SkillInstructionsProps {
namespace: string
slug: string
version?: string
available: boolean
loading: boolean
error: unknown
retryFiles: () => void
onLinkClick: (href: string, event: MouseEvent<HTMLAnchorElement>) => void
}
export function SkillInstructions({ namespace, slug, version, available, loading, error, retryFiles, onLinkClick }: SkillInstructionsProps) {
const { t } = useTranslation()
const [source, setSource] = useState(false)
const query = useSkillFile(namespace, slug, version, 'SKILL.md', available && !error && !loading)
if (error || query.error) {
return (
<Card className="p-6 space-y-3" role="alert">
<p>{t('skillDetail.instructionsError')}</p>
<Button data-analytics-id="skill.instructions.retry" variant="outline"
onClick={() => error ? retryFiles() : void query.refetch()}>
{t('skillDetail.instructionsRetry')}
</Button>
</Card>
)
}
if (loading || (available && query.isLoading)) {
return <Card className="p-6" role="status">{t('skillDetail.instructionsLoading')}</Card>
}
if (!available) {
return <Card className="p-6">{t('skillDetail.instructionsMissing')}</Card>
}
return (
<Card className="min-w-0 p-4 sm:p-6 space-y-5">
<div className="flex flex-wrap items-center justify-between gap-3 border-b border-border pb-4">
<code className="text-sm text-muted-foreground">SKILL.md · {version}</code>
<Button data-analytics-id="skill.instructions.source.toggle" variant="outline" size="sm"
aria-pressed={source} onClick={() => setSource(!source)}>
{t(source ? 'skillDetail.instructionsRendered' : 'skillDetail.instructionsSource')}
</Button>
</div>
{source ? (
<pre className="max-w-full overflow-x-auto whitespace-pre-wrap break-words text-sm">
<code>{query.data}</code>
</pre>
) : (
<MarkdownRenderer content={query.data ?? ''} onLinkClick={onLinkClick} />
)}
</Card>
)
}

View file

@ -1466,7 +1466,22 @@
"accessDeniedDesc": "You don't have permission to view this skill",
"tabReadme": "README",
"tabOverview": "Overview",
"viewSkillMd": "View SKILL.md",
"versionLoadError": "Could not load this version. Please retry.",
"versionLoading": "Loading version content…",
"tabInstructions": "Skill instructions",
"instructionsError": "Could not load instructions. Please retry.",
"instructionsRetry": "Retry",
"instructionsLoading": "Loading instructions…",
"instructionsMissing": "This version does not contain SKILL.md.",
"instructionsRendered": "Read rendered",
"instructionsSource": "View source",
"versionUnavailable": "Version unavailable or inaccessible: {{version}}",
"viewingUnpublishedVersion": "Previewing unpublished v{{version}}",
"viewingHistoricalVersion": "Viewing historical v{{version}}",
"viewingVersion": "Viewing v{{version}}",
"returnLatestPublished": "Return to latest published",
"viewingThisVersion": "Currently viewing",
"viewThisVersion": "View this version",
"tabFiles": "Files",
"tabVersions": "Versions",
"noReadme": "No README",

View file

@ -1743,7 +1743,22 @@
"accessDeniedDesc": "이 스킬을 볼 권한이 없습니다",
"tabReadme": "README",
"tabOverview": "개요",
"viewSkillMd": "SKILL.md 보기",
"versionLoadError": "버전을 불러오지 못했습니다. 다시 시도하세요.",
"versionLoading": "버전 내용을 불러오는 중…",
"tabInstructions": "스킬 지침",
"instructionsError": "지침을 불러오지 못했습니다. 다시 시도하세요.",
"instructionsRetry": "다시 시도",
"instructionsLoading": "지침을 불러오는 중…",
"instructionsMissing": "이 버전에는 SKILL.md가 없습니다.",
"instructionsRendered": "읽기 보기",
"instructionsSource": "소스 보기",
"versionUnavailable": "접근할 수 없는 버전: {{version}}",
"viewingUnpublishedVersion": "미게시 버전 v{{version}} 미리보기",
"viewingHistoricalVersion": "이전 버전 v{{version}} 보는 중",
"viewingVersion": "v{{version}} 보는 중",
"returnLatestPublished": "최신 게시 버전으로",
"viewingThisVersion": "현재 보는 버전",
"viewThisVersion": "이 버전 보기",
"tabFiles": "파일",
"tabVersions": "버전",
"noReadme": "README 없음",

View file

@ -1533,7 +1533,22 @@
"accessDeniedDesc": "У вас нет прав на просмотр этого скилла",
"tabReadme": "README",
"tabOverview": "Обзор",
"viewSkillMd": "Открыть SKILL.md",
"versionLoadError": "Не удалось загрузить версию. Повторите попытку.",
"versionLoading": "Загрузка содержимого версии…",
"tabInstructions": "Инструкции навыка",
"instructionsError": "Не удалось загрузить инструкции. Повторите попытку.",
"instructionsRetry": "Повторить",
"instructionsLoading": "Загрузка инструкций…",
"instructionsMissing": "В этой версии нет SKILL.md.",
"instructionsRendered": "Режим чтения",
"instructionsSource": "Исходный текст",
"versionUnavailable": "Версия недоступна: {{version}}",
"viewingUnpublishedVersion": "Предпросмотр неопубликованной v{{version}}",
"viewingHistoricalVersion": "Просмотр старой версии v{{version}}",
"viewingVersion": "Просмотр v{{version}}",
"returnLatestPublished": "К последней опубликованной",
"viewingThisVersion": "Открытая версия",
"viewThisVersion": "Открыть версию",
"tabFiles": "Файлы",
"tabVersions": "Версии",
"noReadme": "Нет README",

View file

@ -1464,8 +1464,23 @@
"accessDenied": "访问被拒绝",
"accessDeniedDesc": "您没有权限查看该技能",
"tabReadme": "README",
"tabOverview": "概览",
"viewSkillMd": "查看 SKILL.md",
"tabOverview": "概述",
"versionLoadError": "版本内容加载失败,请重试。",
"versionLoading": "正在加载版本内容…",
"tabInstructions": "技能指令",
"instructionsError": "指令加载失败,请重试。",
"instructionsRetry": "重试",
"instructionsLoading": "正在加载技能指令…",
"instructionsMissing": "此版本未包含 SKILL.md。",
"instructionsRendered": "阅读视图",
"instructionsSource": "查看源码",
"versionUnavailable": "版本不可用或无权访问:{{version}}",
"viewingUnpublishedVersion": "正在预览未发布版本 v{{version}}",
"viewingHistoricalVersion": "正在查看历史版本 v{{version}}",
"viewingVersion": "正在查看 v{{version}}",
"returnLatestPublished": "返回最新已发布版",
"viewingThisVersion": "当前查看",
"viewThisVersion": "查看此版本",
"tabFiles": "文件",
"tabVersions": "版本",
"noReadme": "暂无 README",

View file

@ -4,6 +4,7 @@ import { renderToStaticMarkup } from 'react-dom/server'
import { cleanup, fireEvent, render, screen, waitFor, within } from '@testing-library/react'
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
import type { MouseEvent, ReactNode } from 'react'
import { ApiError } from '@/api/client'
import type { SkillFile } from '@/api/types'
const toastMocks = vi.hoisted(() => ({
@ -1025,8 +1026,91 @@ describe('SkillDetailPage', () => {
render(<SkillDetailPage />)
expect(screen.getByText('markdown:# Selected overview')).toBeTruthy()
expect(screen.queryByText('markdown:# Demo')).toBeNull()
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.viewSkillMd' }))
expect(screen.getByRole('dialog').textContent).toContain('preview:SKILL.md')
fireEvent.click(screen.getByRole('tab', { name: 'skillDetail.tabInstructions' }))
expect(screen.getByText(/SKILL.md ·/)).toBeTruthy()
expect(screen.queryByRole('button', { name: 'skillDetail.viewSkillMd' })).toBeNull()
})
it('selects a version from its tab without publishing and preserves return context', () => {
useSkillVersionsMock.mockReturnValue({ data: [
{ id: 10, version: '1.0.0', status: 'PUBLISHED' },
{ id: 11, version: '0.9.0', status: 'PUBLISHED' },
] })
render(<SkillDetailPage />)
fireEvent.click(screen.getByRole('tab', { name: 'skillDetail.tabVersions' }))
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.viewThisVersion' }))
expect(navigateMock).toHaveBeenCalledWith({ to: '/space/$namespace/$slug', params: routeParams, search: { returnTo: '/dashboard/skills', version: '0.9.0' } })
expect(document.activeElement).toBe(screen.getByRole('tab', { name: 'skillDetail.tabOverview' }))
expect(screen.getByRole('tab', { name: 'skillDetail.tabOverview' }).getAttribute('aria-selected')).toBe('true')
})
it('shows a historical context and returns to the latest published version', () => {
searchMock.value.version = '0.9.0'
useSkillVersionsMock.mockReturnValue({ data: [
{ id: 10, version: '1.0.0', status: 'PUBLISHED' },
{ id: 11, version: '0.9.0', status: 'PUBLISHED' },
] })
render(<SkillDetailPage />)
expect(screen.getByText('skillDetail.viewingHistoricalVersion')).toBeTruthy()
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.returnLatestPublished' }))
expect(navigateMock).toHaveBeenCalledWith(expect.objectContaining({ search: { returnTo: '/dashboard/skills', version: undefined } }))
})
it('does not display another version when the requested version is unavailable', () => {
searchMock.value.version = '99.0.0'
useSkillVersionDetailMock.mockReturnValue({ error: Object.assign(new ApiError('not found', 404), { status: 404 }) })
render(<SkillDetailPage />)
expect(screen.getByRole('alert').textContent).toContain('skillDetail.versionUnavailable')
expect(screen.queryByText('markdown:# Demo')).toBeNull()
expect(screen.queryByRole('tab')).toBeNull()
})
it('can read an older version absent from the first page of versions', () => {
searchMock.value.version = '0.1.0'
useSkillVersionDetailMock.mockReturnValue({ data: { id: 1, version: '0.1.0', status: 'PUBLISHED', parsedMetadataJson: JSON.stringify({ overviewOverride: '# Old readable introduction' }) } })
render(<SkillDetailPage />)
expect(screen.getByText('markdown:# Old readable introduction')).toBeTruthy()
expect(screen.queryByText('skillDetail.versionUnavailable')).toBeNull()
})
it('distinguishes transient version errors from unavailable versions and offers retry', () => {
searchMock.value.version = '0.1.0'
const refetch = vi.fn()
useSkillVersionDetailMock.mockReturnValue({ error: Object.assign(new ApiError('temporary', 500), { status: 500 }), refetch })
render(<SkillDetailPage />)
expect(screen.queryByText('skillDetail.versionUnavailable')).toBeNull()
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.instructionsRetry' }))
expect(refetch).toHaveBeenCalledOnce()
})
it('restores overview focus after the selected version finishes loading', () => {
useSkillVersionsMock.mockReturnValue({ data: [
{ id: 10, version: '1.0.0', status: 'PUBLISHED' },
{ id: 11, version: '0.9.0', status: 'PUBLISHED' },
] })
const { rerender } = render(<SkillDetailPage />)
fireEvent.click(screen.getByRole('tab', { name: 'skillDetail.tabVersions' }))
fireEvent.click(screen.getByRole('button', { name: 'skillDetail.viewThisVersion' }))
searchMock.value.version = '0.9.0'
useSkillVersionDetailMock.mockReturnValue({ isLoading: true })
rerender(<SkillDetailPage />)
expect(screen.getByRole('status').textContent).toBe('skillDetail.versionLoading')
useSkillVersionDetailMock.mockReturnValue({ isLoading: false, data: { id: 11, version: '0.9.0', status: 'PUBLISHED' } })
rerender(<SkillDetailPage />)
expect(document.activeElement).toBe(screen.getByRole('tab', { name: 'skillDetail.tabOverview' }))
})
it('returns to overview when route history changes the selected version', () => {
useSkillVersionsMock.mockReturnValue({ data: [
{ id: 10, version: '1.0.0', status: 'PUBLISHED' },
{ id: 11, version: '0.9.0', status: 'PUBLISHED' },
] })
const { rerender } = render(<SkillDetailPage />)
fireEvent.click(screen.getByRole('tab', { name: 'skillDetail.tabFiles' }))
searchMock.value.version = '0.9.0'
rerender(<SkillDetailPage />)
expect(screen.getByRole('tab', { name: 'skillDetail.tabOverview' }).getAttribute('aria-selected')).toBe('true')
expect(screen.getByText('skillDetail.viewingHistoricalVersion')).toBeTruthy()
})
it('opens a file preview when overview markdown relative link matches a package file', () => {

View file

@ -3,6 +3,7 @@ import { useTranslation } from 'react-i18next'
import { Link, useParams, useNavigate, useRouterState, useSearch } from '@tanstack/react-router'
import { useMutation, useQueryClient } from '@tanstack/react-query'
import { ArrowLeft, ArrowUpCircle, Boxes, ChevronDown, ChevronUp, Clock, Folder, Globe, Lock, RefreshCw, ShieldCheck, Terminal, User, Users } from 'lucide-react'
import { SkillInstructions } from '@/features/skill/skill-instructions'
import { MarkdownRenderer } from '@/features/skill/markdown-renderer'
import { SkillVisibilityDialog } from '@/features/skill/skill-visibility-dialog'
import { SkillAvatar } from '@/features/skill/skill-avatar'
@ -198,23 +199,44 @@ export function SkillDetailPage() {
?? publishedVersions[0]
const ownerPreviewVersion = skill ? getOwnerPreviewVersion(skill) : null
const requestedVersion = search.version
const selectedVersion = versions?.some(version => version.version === requestedVersion)
? requestedVersion
: headlineVersion?.version ?? versions?.[0]?.version
const selectedVersionEntry = versions?.find((version) => version.version === selectedVersion) ?? versions?.[0]
const selectedVersion = requestedVersion ?? headlineVersion?.version ?? versions?.[0]?.version
const selectedMetadata = selectedVersion === ownerPreviewVersion?.version ? ownerPreviewVersion
: selectedVersion === publishedVersion?.version ? publishedVersion
: selectedVersion === headlineVersion?.version ? headlineVersion : null
const { data: selectedVersionDetail } = useSkillVersionDetail(qns, qslug, selectedVersion, skillReady)
const { data: selectedVersionDetail, error: versionDetailError, isLoading: versionDetailLoading, refetch: retryVersionDetail } = useSkillVersionDetail(qns, qslug, selectedVersion, skillReady)
const unavailableVersion = Boolean(requestedVersion && versionDetailError instanceof ApiError && [403, 404].includes(versionDetailError.status))
const selectedVersionEntry = versions?.find((version) => version.version === selectedVersion)
?? (selectedVersionDetail ? { ...selectedVersionDetail, downloadAvailable: false, syncRevision: undefined } : undefined)
const historicalMetadata = getVersionPresentation(selectedVersionDetail?.parsedMetadataJson)
const selectedDisplayName = selectedMetadata?.displayName ?? historicalMetadata.displayName ?? skill?.displayName
const selectedSummary = selectedMetadata?.summary ?? historicalMetadata.summary ?? skill?.summary
const showingUnpublishedPreview = selectedVersionEntry != null && selectedVersionEntry.status !== 'PUBLISHED'
const { data: files } = useSkillFiles(qns, qslug, selectedVersion, skillReady)
const { data: files, isLoading: filesLoading, error: filesError, refetch: retryFiles } = useSkillFiles(qns, qslug, selectedVersion, skillReady && !unavailableVersion)
const documentationPath = resolveDocumentationFilePath(files)
const { data: readme, error: readmeError } = useSkillReadme(qns, qslug, selectedVersion, documentationPath, skillReady)
const { data: readme, error: readmeError } = useSkillReadme(qns, qslug, selectedVersion, documentationPath, skillReady && !unavailableVersion)
const renderedDocumentation = historicalMetadata.overview ?? readme
useEffect(() => {
setIsOverviewExpanded(false)
setPreviewDialogOpen(false)
setPreviewNode(null)
}, [namespace, slug, selectedVersion])
const overviewTabRef = useRef<HTMLButtonElement>(null)
const focusOverviewAfterSwitch = useRef(false)
useEffect(() => {
if (focusOverviewAfterSwitch.current && overviewTabRef.current && !versionDetailLoading) {
overviewTabRef.current.focus()
focusOverviewAfterSwitch.current = false
}
}, [selectedVersion, versionDetailLoading])
const [tabState, setTabState] = useState({ version: selectedVersion, value: 'readme' })
const activeTab = tabState.version === selectedVersion ? tabState.value : 'readme'
const showVersion = (version?: string) => {
focusOverviewAfterSwitch.current = true
overviewTabRef.current?.focus()
setTabState({ version: selectedVersion, value: 'readme' })
void navigate({ to: '/space/$namespace/$slug', params: { namespace, slug }, search: { ...search, version } })
}
const { data: previewContent, isLoading: isLoadingPreview, error: previewError } = useSkillFile(
qns,
qslug,
@ -860,6 +882,32 @@ export function SkillDetailPage() {
)
}
if (requestedVersion && versionDetailError && !unavailableVersion) {
return (
<Card className="p-6 space-y-4" role="alert">
<p>{t('skillDetail.versionLoadError')}</p>
<Button variant="outline" data-analytics-id="skill.version.retry" onClick={() => void retryVersionDetail()}>
{t('skillDetail.instructionsRetry')}
</Button>
</Card>
)
}
if (requestedVersion && versionDetailLoading) {
return <Card className="p-6" role="status">{t('skillDetail.versionLoading')}</Card>
}
if (unavailableVersion) {
return (
<Card className="p-6 space-y-4" role="alert">
<p>{t('skillDetail.versionUnavailable', { version: requestedVersion })}</p>
{publishedVersion && (
<Button variant="outline" data-analytics-id="skill.version.latest" onClick={() => showVersion(publishedVersion.version)}>
{t('skillDetail.returnLatestPublished')}
</Button>
)}
</Card>
)
}
if (skillDeleted) {
return null
}
@ -981,20 +1029,19 @@ export function SkillDetailPage() {
)}
</div>
<Tabs defaultValue="readme">
<TabsList>
<TabsTrigger data-analytics-id="skill.overview.tab" value="readme">{t('skillDetail.tabOverview')}</TabsTrigger>
{(requestedVersion || showingUnpublishedPreview) && <div role="status" className="mb-4 flex flex-wrap items-center justify-between gap-3 rounded-xl border border-border bg-secondary/30 px-4 py-3 text-sm">
<span>{t(unavailableVersion ? 'skillDetail.versionUnavailable' : showingUnpublishedPreview ? 'skillDetail.viewingUnpublishedVersion' : selectedVersion !== publishedVersion?.version ? 'skillDetail.viewingHistoricalVersion' : 'skillDetail.viewingVersion', { version: selectedVersion })}</span>
{publishedVersion && selectedVersion !== publishedVersion.version && <Button variant="outline" size="sm" data-analytics-id="skill.version.latest" onClick={() => showVersion(publishedVersion.version === headlineVersion?.version ? undefined : publishedVersion.version)}>{t('skillDetail.returnLatestPublished')}</Button>}
</div>}
<Tabs value={activeTab} onValueChange={(value) => setTabState({ version: selectedVersion, value })}>
<TabsList className="max-w-full flex-wrap h-auto">
<TabsTrigger ref={overviewTabRef} data-analytics-id="skill.overview.tab" value="readme">{t('skillDetail.tabOverview')}</TabsTrigger>
<TabsTrigger data-analytics-id="skill.instructions.tab" value="instructions">{t('skillDetail.tabInstructions')}</TabsTrigger>
<TabsTrigger data-analytics-id="skill.files.tab" value="files">{t('skillDetail.tabFiles')}</TabsTrigger>
<TabsTrigger data-analytics-id="skill.versions.tab" value="versions">{t('skillDetail.tabVersions')}</TabsTrigger>
</TabsList>
<TabsContent value="readme" className="mt-6">
{files?.find(file => file.filePath === 'SKILL.md') && (
<Button type="button" variant="outline" className="mb-4" onClick={() => {
const skillFile = files.find(file => file.filePath === 'SKILL.md')
if (skillFile) handleFileClick(createPackageFilePreviewNode(skillFile))
}}>{t('skillDetail.viewSkillMd')}</Button>
)}
{renderedDocumentation ? (
<Card className="p-8 space-y-4">
{!historicalMetadata.overview && documentationPath ? (
@ -1060,6 +1107,9 @@ export function SkillDetailPage() {
)}
</TabsContent>
<TabsContent value="instructions" className="mt-6">
<SkillInstructions key={`${namespace}/${slug}/${selectedVersion}`} namespace={qns} slug={qslug} version={selectedVersion} available={!unavailableVersion && Boolean(files?.some(file => file.filePath === 'SKILL.md'))} loading={Boolean(filesLoading)} error={filesError} retryFiles={() => void retryFiles()} onLinkClick={(href, event) => handlePackageMarkdownLinkClick(href, event, 'SKILL.md')} />
</TabsContent>
<TabsContent value="files" className="mt-6">
{files && files.length > 0 ? (
<FileTree analyticsId="skill.file.open" files={files} onFileClick={handleFileClick} />
@ -1076,7 +1126,7 @@ export function SkillDetailPage() {
<div className="space-y-0 divide-y divide-border/40">
{versions.map((version) => (
<div key={version.id} className="py-5 first:pt-0 last:pb-0">
<div className="flex items-start justify-between gap-4 mb-2">
<div className="flex flex-col sm:flex-row sm:items-start sm:justify-between gap-4 mb-2">
<span className="font-semibold font-heading text-foreground flex items-center gap-2 flex-wrap min-w-0">
<span className="px-2.5 py-0.5 rounded-full bg-primary/10 text-primary text-sm font-mono">
{version.syncRevision ? t('review.githubRevisionValue', { count: version.syncRevision }) : `v${version.version}`}
@ -1095,7 +1145,8 @@ export function SkillDetailPage() {
</span>
)}
</span>
<div className="flex items-center gap-3 flex-shrink-0">
<div className="flex flex-wrap items-center gap-3">
<Button size="sm" variant="outline" disabled={version.version === selectedVersion} data-analytics-id="skill.version.view" onClick={() => showVersion(version.version)}>{t(version.version === selectedVersion ? 'skillDetail.viewingThisVersion' : 'skillDetail.viewThisVersion')}</Button>
<span className="text-sm text-muted-foreground">
{formatLocalDateTime(version.publishedAt, i18n.language)}
</span>
@ -1368,7 +1419,7 @@ export function SkillDetailPage() {
)}
</Card>
{publishedVersion && canInteract && (
{selectedVersionEntry && isVersionInstallable && canInteract && (
<Card className="p-5 space-y-4">
<div className="flex items-center gap-2">
<Terminal className="w-4 h-4 text-muted-foreground" />
@ -1380,7 +1431,7 @@ export function SkillDetailPage() {
<InstallCommand analyticsId="skill.command.copy"
namespace={namespace}
slug={slug}
version={publishedVersion.version} skillhubAnalyticsId="skill.command.skillhub.select" clawhubAnalyticsId="skill.command.clawhub.select"
version={selectedVersionEntry.version} skillhubAnalyticsId="skill.command.skillhub.select" clawhubAnalyticsId="skill.command.clawhub.select"
/>
</Card>
)}