diff --git a/docs/archive/.gitignore b/docs/archive/.gitignore new file mode 100644 index 00000000..42981ad4 --- /dev/null +++ b/docs/archive/.gitignore @@ -0,0 +1,2 @@ +node_modules/ +.vitepress/cache/ diff --git a/docs/archive/.vitepress/config.ts b/docs/archive/.vitepress/config.ts new file mode 100644 index 00000000..c42158dd --- /dev/null +++ b/docs/archive/.vitepress/config.ts @@ -0,0 +1,75 @@ +import { defineConfig } from 'vitepress' + +export default defineConfig({ + title: '项目档案', + description: 'SkillHub 项目归档浏览', + lang: 'zh-CN', + + search: { + provider: 'local' + }, + + themeConfig: { + nav: [ + { text: '首页', link: '/' }, + { text: '时间线', link: '/timeline/2026/2026-04' }, + { text: '叙事', link: '/narratives/origin' }, + { text: '来源', link: '/sources/commits/2026-04-25-repository-commit-history' } + ], + + sidebar: { + '/': [ + { + text: '项目档案', + items: [ + { text: '首页', link: '/' }, + { text: '档案概述', link: '/README' }, + { + text: '叙事', + items: [ + { text: '项目起源', link: '/narratives/origin' }, + { text: '仓库历程', link: '/narratives/repository-history' } + ] + }, + { + text: '时间线', + items: [ + { text: '2026-03', link: '/timeline/2026/2026-03' }, + { text: '2026-04', link: '/timeline/2026/2026-04' } + ] + }, + { + text: '来源', + items: [ + { text: '仓库提交历史', link: '/sources/commits/2026-04-25-repository-commit-history' } + ] + }, + { + text: '元信息', + items: [ + { text: '分类法', link: '/_meta/taxonomy' }, + { text: '贡献指南', link: '/_meta/contribution-guide' }, + { text: '脱敏策略', link: '/_meta/redaction-policy' }, + { text: '变更记录', link: '/_meta/changelog' } + ] + }, + { + text: '索引说明', + items: [ + { text: '里程碑', link: '/milestones/README' }, + { text: '决策', link: '/decisions/README' }, + { text: '贡献者', link: '/contributors/README' }, + { text: '沟通', link: '/communications/README' }, + { text: '发文', link: '/publications/README' }, + { text: 'GitHub', link: '/github/README' }, + { text: '来源', link: '/sources/README' }, + { text: '收件箱', link: '/inbox/README' }, + { text: '模板', link: '/templates/README' } + ] + } + ] + } + ] + } + } +}) diff --git a/docs/archive/README.md b/docs/archive/README.md new file mode 100644 index 00000000..7b6c5c16 --- /dev/null +++ b/docs/archive/README.md @@ -0,0 +1,74 @@ +# SkillHub 项目档案 + +## 目的 + +`docs/archive/` 是 SkillHub 的长期项目档案库。 + +它用于保存: + +- 项目的整体生命周期与关键里程碑 +- 与项目相关的内部和外部发文 +- 重要产品与工程决策背后的上下文 +- 核心贡献者之间的交流记录或摘要 +- 能支持后续文档编写的来源证据 + +这个档案库有意与 `docs/` 下已有的产品、架构和面向用户的文档分开。现有设计文档和交付文档仍然是实现层面的主记录,而档案库负责补充历史背景、交叉链接和证据链。 + +## 信息模型 + +档案采用三层 Markdown 结构: + +1. 叙事层:讲述项目故事和主要阶段。 +2. 索引层:组织里程碑、时间线、贡献者、发文与 GitHub 记录。 +3. 来源层:保存链接、摘要、截图、提交引用、聊天摘要等证据。 + +## 目录说明 + +- `_meta/`:分类法、维护规则、脱敏策略、档案变更记录 +- `inbox/`:尚未归类材料的临时落点 +- `timeline/`:按年和月份组织的时间记录 +- `milestones/`:带有背景和影响说明的重要项目节点 +- `narratives/`:综合整理后的项目叙事 +- `decisions/`:重要决策的档案化摘要 +- `contributors/`:核心贡献者画像与贡献线索 +- `communications/`:会议纪要、聊天摘要、访谈摘要 +- `publications/`:内部和外部的文章、公告、提及记录 +- `github/`:经过整理的 issue、PR 和 release 追踪 +- `sources/`:证据记录、链接、截图、提交摘要 +- `templates/`:新建档案条目时可复用的 Markdown 模板 + +## 推荐工作流 + +1. 先把原始链接、截图、笔记或引用材料放进 `inbox/`。 +2. 为后续可能引用的材料创建或更新 `sources/` 条目。 +3. 把事件补入对应月份的 `timeline/` 文件。 +4. 当上下文足够丰富时,再整理进 `milestones/`、`narratives/`、`contributors/` 或 `decisions/`。 + +## 命名规则 + +- 时间线文件:`YYYY/YYYY-MM.md` +- 里程碑文件:`YYYY-MM-DD-short-topic.md` +- 决策文件:`YYYY-MM-DD-short-decision.md` +- 发文文件:`YYYY-MM-DD-channel-short-title.md` +- 贡献者文件:`name.md` +- 来源文件:`YYYY-MM-DD-source-type-short-topic.md` + +## 初始入口 + +以下文档适合作为第一轮档案整理的起点: + +- [产品方向](../00-product-direction.md) +- [系统架构](../01-system-architecture.md) +- [交付路线图](../10-delivery-roadmap.md) +- [Issue 自动化设计](../2026-04-08-issue-automation-design.md) +- [第 1 阶段计划](../superpowers/plans/2026-03-11-phase1-foundation-auth.md) +- [第 2 阶段设计](../superpowers/specs/2026-03-12-phase2-namespace-skill-core-design.md) + +## 当前状态 + +这套档案框架已经完成第一版播种,但按设计它仍然是不完整的。随着项目演进,后续很可能会出现新的板块、新的文档类型,以及更细的索引方式。 + +当前信号最强的历史记录: + +- [仓库历程叙事](./narratives/repository-history.md) +- [仓库提交历史来源](./sources/commits/2026-04-25-repository-commit-history.md) diff --git a/docs/archive/_meta/changelog.md b/docs/archive/_meta/changelog.md new file mode 100644 index 00000000..ab30d4b4 --- /dev/null +++ b/docs/archive/_meta/changelog.md @@ -0,0 +1,8 @@ +# 档案变更记录 + +## 2026-04-25 + +- 创建 `docs/archive/` 初始框架 +- 补充分类法、贡献规则与脱敏指引 +- 为 `2026-03` 和 `2026-04` 播种时间线文件 +- 新增来源、里程碑、决策、沟通、发文和贡献者模板 diff --git a/docs/archive/_meta/contribution-guide.md b/docs/archive/_meta/contribution-guide.md new file mode 100644 index 00000000..de2a80f5 --- /dev/null +++ b/docs/archive/_meta/contribution-guide.md @@ -0,0 +1,56 @@ +# 档案贡献指南 + +## 目标 + +档案库应当容易扩展,而不是一开始就要求贡献者把所有事情都想清楚。推荐的写法是: + +- 条目小而清晰,并且互相有链接 +- 日期明确 +- 来源引用直接可见 +- 尽量减少重复 + +## 新增材料 + +1. 如果材料还没准备好归类,先放进 `inbox/`。 +2. 当一份材料未来可能被引用时,创建对应的 `sources/` 条目。 +3. 更新相应月份的 `timeline/` 文件。 +4. 只有在“综合整理”本身有价值时,才把材料提升到 `milestones/`、`decisions/`、`contributors/` 或 `narratives/`。 + +## 编辑规则 + +- 优先补充带来源的事实,不要凭记忆写大段概述。 +- 一个文件只聚焦一个主题。 +- 尽量链接已有文档、PR、issue 或提交,而不是复制大段原文。 +- 如果确实需要新的档案分类,先更新 `_meta/taxonomy.md`。 + +## 如何处理不完整信息 + +- 用 `status: seed` 表示第一版骨架,且已有可验证锚点。 +- 用 `status: draft` 表示内容还不完整,但已经可以阅读。 +- 用 `status: curated` 表示结构和证据已经足够扎实,可被后续复用。 + +## 适用范围 + +适合进入档案的内容: + +- 一个重要想法首次出现的时刻 +- 改变方向、范围、架构或工作流的里程碑 +- 能解释某个选择为何发生的贡献者讨论 +- 影响项目传播或认知的外部提及 + +除非确有需要,否则不建议完整保存以下内容: + +- 没有摘要的原始聊天导出 +- 冗长 PR 描述的重复拷贝 +- 文章全文复制 +- 低信号的运维噪音 + +## 复核清单 + +在把一条记录视为稳定之前,请检查: + +- 日期是否明确 +- 文件类型是否正确 +- 是否至少有一条具体来源 +- 敏感信息是否已经脱敏或改写为摘要 +- 文件是否链接到了档案中的下一处相关内容 diff --git a/docs/archive/_meta/redaction-policy.md b/docs/archive/_meta/redaction-policy.md new file mode 100644 index 00000000..66053d23 --- /dev/null +++ b/docs/archive/_meta/redaction-policy.md @@ -0,0 +1,36 @@ +# 脱敏策略 + +## 原则 + +档案应当尽量保留上下文,但不要暴露不必要的敏感细节。 + +## 默认做法 + +- 优先保存聊天摘要,而不是逐字转录。 +- 保留决策、分歧、理由和结果。 +- 去掉密钥、凭证、令牌、私有 URL 和个人联系方式。 +- 去掉与项目记录无关的个人细节。 + +## 沟通记录 + +在归档贡献者沟通内容时: + +- 记录日期或日期范围 +- 在合适的情况下使用公开项目身份来标注参与者 +- 摘要化记录议题、讨论选项、最终决定和后续动作 +- 只保留支撑摘要所必需的最小引用片段 + +## 敏感主题 + +以下内容建议使用 `confidentiality: restricted`: + +- 尚未公开的产品策略 +- 内部人事或组织安排细节 +- 私有的安全或运维事件 +- 含有客户或合作方私密信息的讨论 + +## 外部发文 + +- 保存链接、元数据、简要摘要和与项目的相关性 +- 不要把整篇文章镜像到仓库里 +- 如果确实需要截图,请放在 `sources/screenshots/` 下并建立引用 diff --git a/docs/archive/_meta/taxonomy.md b/docs/archive/_meta/taxonomy.md new file mode 100644 index 00000000..d9545ffd --- /dev/null +++ b/docs/archive/_meta/taxonomy.md @@ -0,0 +1,100 @@ +# 档案分类法 + +## 文档类型 + +frontmatter 中使用一个主 `type`: + +- `timeline`:按时间顺序记录事件 +- `milestone`:带有背景和影响说明的重要项目节点 +- `narrative`:跨多个事件综合整理出的叙事 +- `decision`:关键决策的档案化摘要 +- `publication`:内部或外部的发文记录 +- `communication`:会议纪要、聊天摘要或访谈摘要 +- `contributor`:贡献者画像或贡献线索记录 +- `source`:为其他档案条目提供支撑的证据记录 +- `index`:导航页 +- `template`:可复用的条目模板 + +## 保密级别 + +使用一个 `confidentiality` 值: + +- `public`:可以在团队外公开发布 +- `internal`:面向仓库贡献者和维护者 +- `restricted`:包含敏感的贡献者、产品或运维上下文 + +如果拿不准,默认使用 `internal`。 + +## 来源类型 + +来源记录中的 `source_type` 使用以下值之一: + +- `commit` +- `pull-request` +- `issue` +- `release` +- `article` +- `announcement` +- `meeting-note` +- `chat-summary` +- `interview` +- `screenshot` +- `demo` +- `document` + +## 推荐标签 + +使用简短标签帮助交叉链接: + +- product +- architecture +- auth +- namespace +- publishing +- search +- governance +- docs +- automation +- release +- contributor +- external-coverage +- internal-communication + +## 必备 Frontmatter 字段 + +所有非模板类条目都应包含: + +```yaml +--- +id: unique-id +type: source +status: draft +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: internal +tags: [] +--- +``` + +## 可选 Frontmatter 字段 + +以下字段在有需要时补充: + +- `people` +- `teams` +- `source_type` +- `source_url` +- `source_path` +- `related_docs` +- `related_prs` +- `related_issues` +- `related_commits` +- `related_sources` +- `summary` + +## 交叉引用规则 + +- 把 `sources/` 视为证据层。 +- 把 `timeline/`、`milestones/`、`decisions/` 和 `narratives/` 视为摘要层。 +- 优先使用链接,而不是重复复制正文。 +- 当某个文件提出历史性判断时,至少补上一条支持它的来源或仓库文档链接。 diff --git a/docs/archive/communications/README.md b/docs/archive/communications/README.md new file mode 100644 index 00000000..dfb1d511 --- /dev/null +++ b/docs/archive/communications/README.md @@ -0,0 +1,11 @@ +# 沟通记录 + +这个目录用于保存能帮助解释项目历史的沟通摘要。 + +子目录说明: + +- `meetings/`:结构化会议纪要或会议摘要 +- `chat-summaries/`:包含决策和行动项的聊天摘要 +- `interviews/`:与维护者或贡献者相关的访谈记录 + +优先保存摘要,而不是原始逐字稿。确有需要时,再从 `sources/` 链接原始证据。 diff --git a/docs/archive/contributors/README.md b/docs/archive/contributors/README.md new file mode 100644 index 00000000..f2371fcf --- /dev/null +++ b/docs/archive/contributors/README.md @@ -0,0 +1,19 @@ +# 贡献者 + +这个目录用于保存以贡献者为中心的档案记录。 + +适合收录的内容: + +- 核心贡献者画像及其主要工作线索 +- 长周期负责范围的总结 +- 某些功能或治理议题如何在不同人和不同时间之间流转 + +推荐字段: + +- 公开项目身份 +- 首次可见贡献日期 +- 主要负责领域 +- 重要决策或里程碑 +- 相关 PR、issue、文档和沟通记录 + +新建条目时请参考 `../templates/contributor.md`。 diff --git a/docs/archive/decisions/README.md b/docs/archive/decisions/README.md new file mode 100644 index 00000000..b8f635e1 --- /dev/null +++ b/docs/archive/decisions/README.md @@ -0,0 +1,12 @@ +# 决策记录 + +这个目录用于保存那些塑造了产品或实现方式的决策摘要。 + +它们不是 `docs/` 下主设计文档的替代品,而是更短的历史视角,用来回答: + +- 这个决策在什么时候变得可见 +- 它在解决什么问题 +- 曾考虑过哪些方案 +- 它对后续产生了什么影响 + +可从 `../templates/decision.md` 开始撰写。 diff --git a/docs/archive/github/README.md b/docs/archive/github/README.md new file mode 100644 index 00000000..05066111 --- /dev/null +++ b/docs/archive/github/README.md @@ -0,0 +1,16 @@ +# GitHub 档案索引 + +这个目录用于整理高信号的 GitHub 历史。 + +子目录说明: + +- `issues/`:实质性改变范围、路线图或运作方式的 issue +- `prs/`:代表里程碑、转折点或关键实现波次的 PR +- `releases/`:发布说明与上线节点 + +整理原则: + +- 除非确有必要,否则不要镜像完整 GitHub 讨论串 +- 重点说明某个 PR 或 issue 为什么重要 +- 链接到规范的 GitHub URL 或本地设计文档 +- 当记录需要证据层细节时,放到 `sources/` 中 diff --git a/docs/archive/inbox/README.md b/docs/archive/inbox/README.md new file mode 100644 index 00000000..fbf34ebb --- /dev/null +++ b/docs/archive/inbox/README.md @@ -0,0 +1,12 @@ +# 收件箱 + +这个目录是档案原始材料的临时落点,适合存放那些还没有完成整理和归类的内容。 + +例如: + +- 等待分类的文章链接 +- 粗略会议笔记 +- 还没建立来源记录的截图 +- 为后续综合整理而先收集的 PR 或 issue 链接 + +当材料稳定到可以被引用时,把它移入 `sources/`,并同步更新对应的 `timeline/` 条目。 diff --git a/docs/archive/index.md b/docs/archive/index.md new file mode 100644 index 00000000..e80fb145 --- /dev/null +++ b/docs/archive/index.md @@ -0,0 +1,28 @@ +--- +layout: home + +hero: + name: 项目档案 + text: SkillHub 归档浏览 + tagline: 项目生命周期、决策、叙事与来源的长期档案库 + actions: + - theme: brand + text: 叙事 + link: /narratives/origin + - theme: alt + text: 时间线 + link: /timeline/2026/2026-04 + - theme: alt + text: 来源 + link: /sources/commits/2026-04-25-repository-commit-history + +features: + - title: 叙事 + details: 项目起源、仓库历程等综合叙事 + - title: 时间线 + details: 按月组织的事件记录 + - title: 里程碑与决策 + details: 关键节点和重要决策的档案化摘要 + - title: 来源 + details: 支撑档案内容的证据链与原始记录 +--- diff --git a/docs/archive/milestones/README.md b/docs/archive/milestones/README.md new file mode 100644 index 00000000..b9e2f0c1 --- /dev/null +++ b/docs/archive/milestones/README.md @@ -0,0 +1,12 @@ +# 里程碑 + +这个目录用于记录那些比时间线条目更值得展开说明的重要项目节点。 + +一个里程碑文件应当解释: + +- 发生了什么变化 +- 这件事为什么重要 +- 有哪些来源支撑这个判断 +- 它对后续造成了什么影响 + +可从 `../templates/milestone.md` 模板开始。 diff --git a/docs/archive/narratives/origin.md b/docs/archive/narratives/origin.md new file mode 100644 index 00000000..8b951e25 --- /dev/null +++ b/docs/archive/narratives/origin.md @@ -0,0 +1,38 @@ +--- +id: narrative-origin +type: narrative +status: seed +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: internal +tags: [narrative, origin, product] +--- + +# 项目起源 + +## 当前工作性摘要 + +从现有材料来看,SkillHub 将自己定位为企业级、自托管、面向可复用智能体技能的注册中心。最早一批相对稳定的书面材料,基本都围绕三个互相联动的目标展开: + +- 让技能能够在组织内部被发布和发现 +- 保留治理能力、审计能力和命名空间边界 +- 在合适的地方保持对既有技能打包方式和 CLI 习惯的兼容 + +## 早期强锚点 + +- [README_zh](../../../README_zh.md) +- [产品方向](../../00-product-direction.md) +- [系统架构](../../01-system-architecture.md) +- [交付路线图](../../10-delivery-roadmap.md) + +## 后续待补问题 + +- 项目最初是由什么内部需求或痛点触发的 +- 在当前仓库记录之前,是否存在更早的原型或讨论 +- 哪些贡献者塑造了第一版产品定义 + +## 下一步综合整理目标 + +- 为最早冻结的产品方向建立一个里程碑条目 +- 把关于“起源”的判断连接到最早的 issue、提交或设计说明 +- 收集到外部介绍文章后,把它们补进这里 diff --git a/docs/archive/narratives/repository-history.md b/docs/archive/narratives/repository-history.md new file mode 100644 index 00000000..b021285b --- /dev/null +++ b/docs/archive/narratives/repository-history.md @@ -0,0 +1,127 @@ +--- +id: narrative-repository-history +type: narrative +status: curated +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: internal +tags: [narrative, history, timeline, commits] +related_docs: + - docs/archive/sources/commits/2026-04-25-repository-commit-history.md + - docs/archive/timeline/2026/2026-03.md + - docs/archive/timeline/2026/2026-04.md + - docs/00-product-direction.md + - docs/10-delivery-roadmap.md +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: + - docs/archive/sources/commits/2026-04-25-repository-commit-history.md +summary: 基于完整提交历史整理出的高层项目历程,覆盖到 2026-04-24。 +--- + +# 仓库历程 + +## 范围 + +这份叙事基于 `2026-04-25` 时 `HEAD` 可达的完整 Git 历史整理而成:总计 `734` 个提交,覆盖时间从 `2026-03-11` 到 `2026-04-24`。 + +简要来说,SkillHub 不是按缓慢、薄层的方式长出来的。它是在一个高度压缩的时间窗口里,同时完成了设计、实现、工作流搭建、发布准备和快速硬化。第一个月基本确定了产品边界,也搭起了大部分系统表面;第二个月则明显转向文档、运维韧性、兼容性和真实使用场景下的打磨。 + +主要来源: + +- [仓库提交历史来源](../sources/commits/2026-04-25-repository-commit-history.md) + +## 阶段一:启动与压缩式成型 + +`2026-03-11` 到 `2026-03-13` + +仓库一开始就呈现出异常密集的创建节奏。`2026-03-11` 落下初始提交,随后紧接着完成项目更名、Maven 多模块后端结构、Spring Boot 入口、认证与 RBAC 基础,以及最早一版前端脚手架。 + +到了 `2026-03-12`,提交流从“简单骨架”迅速扩展成几乎完整的一张产品相位图。仅在这一天,仓库里就已经落下了: + +- 命名空间与技能领域模型 +- 包解析与校验 +- 对象存储抽象 +- 审核与提升服务 +- 社交能力 +- Device Flow 支持 +- ClawHub 兼容层 +- 管理员 API +- 运行时镜像发布 +- README 和架构文档的大幅更新 + +这一天的重要性在于,它确立了项目后续一个反复出现的模式:设计文档与实现紧密靠拢,完整功能线往往以成组的方式落地,而不是拆成彼此无关的小碎片。 + +## 阶段二:产品化、治理与硬化 + +`2026-03-14` 到 `2026-03-20` + +在第一轮搭骨架之后,仓库开始明显转向产品硬化。这个阶段虽然充满了大量 `fix`,但它们并不是随机清理,而是在把系统真正推过一系列具体工作流: + +- 预发环境与 PR 工作流 +- release compose 与运行时引导脚本打磨 +- 落地页、i18n 和导航完善 +- 命名空间治理与生命周期管理 +- 举报流程与治理中心 UI +- 审核与提升边界修正 +- 搜索调优与语义重排基础 +- 围绕认证、指标和下载行为的安全加固 +- 构建与测试入口统一 + +这也是项目对外身份逐渐变清晰的时期。README 被反复改写,中文文档加入,集成指引出现,PR 合并开始在历史里形成明显节奏。项目在 `2026-03-19` 达到一个明确节点:`chore(release): v0.1.0`。 + +## 阶段三:v0.1.0 之后的能力扩展 + +`2026-03-23` 到 `2026-03-31` + +`v0.1.0` 发布后,仓库并没有降速,反而开始横向扩展。接下来一波可见变化,让平台逐步从“核心注册中心可用”走向“围绕注册中心的生态开始成形”: + +- 站内通知 +- 多扫描器安全扫描能力 +- 文件浏览侧栏、预览与审计 UI +- Scanner 的 Redis 和对象存储修复 +- 工作流和开发流程改进 +- 技能分享 +- 更宽松的包类型支持 +- 发布部署面继续扩展 +- Unicode slug 支持 + +这一阶段还显示出比最初启动期更广的贡献者参与面。 + +## 阶段四:文档成熟与真实使用场景稳定化 + +`2026-04-01` 到 `2026-04-24` + +4 月的重心已经明显不再是单纯扩展功能面,而是让产品更好地被运行、被验证、被使用。主要线索包括: + +- 双语 VitePress 文档站点 +- 更清晰的运行时和 Kubernetes 部署指引 +- 更强的 e2e 与 PR 校验流程 +- 面向中国开发者的专项说明 +- issue 分诊自动化 +- 针对搜索、审核、认证、校验和存储的大量反复修正 +- 发布预检警告确认流程 +- `UPLOADED` 这样的新生命周期语义 +- 密码重置和 SMTP 支持 +- GitLab OAuth Provider 支持 +- S3 惰性建桶与重试处理 +- 用于更新既有技能的 Dashboard 体验优化 + +4 月的提交结构意味着维护者已经在持续碰到真实边界场景,并围绕这些边界把产品不断收紧。搜索可见性、兼容层行为、发布流程和存储语义,都出现了多轮纠正。 + +## 提交流透露出的项目信号 + +这里面最显眼的有三个模式。 + +第一,项目诞生于一次高度压缩的实现冲刺。大多数仓库会在“薄骨架”状态里停留更久,而 SkillHub 几乎是立刻进入全栈功能建设。 + +第二,提交历史呈现出很强的跨职能特征。UI、认证、文档、治理、兼容性和运维是一起生长的,项目从一开始就不只是一个“后端注册中心”。 + +第三,历史很快转向协作化。早期提交主要集中在少数贡献者手中,随后逐步转向更明确的 PR 协作节奏,仓库也几乎同步开始沉淀流程知识、文档和自动化。 + +## 相关记录 + +- [2026-03 时间线](../timeline/2026/2026-03.md) +- [2026-04 时间线](../timeline/2026/2026-04.md) +- [项目起源](./origin.md) diff --git a/docs/archive/package.json b/docs/archive/package.json new file mode 100644 index 00000000..0e172cd6 --- /dev/null +++ b/docs/archive/package.json @@ -0,0 +1,13 @@ +{ + "name": "archive-site", + "private": true, + "type": "module", + "scripts": { + "dev": "vitepress dev", + "build": "vitepress build", + "preview": "vitepress preview" + }, + "devDependencies": { + "vitepress": "^1.6.3" + } +} diff --git a/docs/archive/publications/README.md b/docs/archive/publications/README.md new file mode 100644 index 00000000..9a385144 --- /dev/null +++ b/docs/archive/publications/README.md @@ -0,0 +1,19 @@ +# 发文记录 + +这个目录用于保存与 SkillHub 相关的文章、公告、发布帖、社区提及及其他文字材料。 + +子目录说明: + +- `internal/`:团队或组织内部渠道 +- `external/`:公开帖子、媒体报道、博客文章、第三方提及 + +每条发文记录建议包含: + +- 日期 +- 渠道 +- 作者或发布方 +- 链接 +- 摘要 +- 与项目档案的相关性 + +新建条目时请参考 `../templates/publication.md`。 diff --git a/docs/archive/publications/external/2026-03-11-jimmysong-ai-oss-landscape.md b/docs/archive/publications/external/2026-03-11-jimmysong-ai-oss-landscape.md new file mode 100644 index 00000000..4b251e65 --- /dev/null +++ b/docs/archive/publications/external/2026-03-11-jimmysong-ai-oss-landscape.md @@ -0,0 +1,50 @@ +--- +id: publication-2026-03-11-jimmysong-ai-oss-landscape +type: publication +status: published +date: 2026-03-11 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://jimmysong.io/ai/skillhub/ +people: [Jimmy Song] +tags: [external-coverage, ai-ecosystem, third-party-validation] +related_docs: [] +related_sources: [source-2026-03-11-jimmysong-skillhub] +summary: SkillHub 被收录进 Jimmy Song 的 AI 开源软件全景图,标志着项目获得第三方生态认可 +--- + +# SkillHub 被收录进 AI OSS Landscape + +## 渠道 + +Jimmy Song 的 AI 开源软件全景图(AI OSS Landscape)项目 + +## 作者或发布方 + +Jimmy Song - 云原生和 AI 领域的技术布道者 + +## 摘要 + +2026 年 3 月 11 日,SkillHub 被正式收录进 Jimmy Song 维护的 AI 开源软件全景图项目。这是一个结构化的项目介绍页面,将 SkillHub 定位为"开源的企业级 agent 技能注册中心",并归类在 Dev Tools 和 CLI 类别下。 + +页面详细介绍了 SkillHub 的核心特性、使用场景和技术架构,包括: +- 自托管部署能力 +- 企业级治理功能 +- 命名空间与 RBAC +- 可插拔存储后端 +- 完整的技术栈信息 + +## 与 SkillHub 的相关性 + +这是 SkillHub 项目的重要里程碑: + +1. **第三方验证**:首次被纳入权威的 AI 开源生态全景图,获得外部认可 +2. **定位确认**:明确了 SkillHub 在企业级 AI agent 技能管理领域的独特价值 +3. **可见性提升**:通过知名技术布道者的平台提高项目曝光度 +4. **生态整合**:将 SkillHub 置于更广泛的 AI 开源工具生态中 + +## 来源链接 + +- [Jimmy Song AI OSS Landscape - SkillHub](https://jimmysong.io/ai/skillhub/) +- [档案来源记录](../../sources/articles/2026-03-11-jimmysong-skillhub-intro.md) diff --git a/docs/archive/publications/external/2026-04-14-youtube-international.md b/docs/archive/publications/external/2026-04-14-youtube-international.md new file mode 100644 index 00000000..b6b5f452 --- /dev/null +++ b/docs/archive/publications/external/2026-04-14-youtube-international.md @@ -0,0 +1,64 @@ +--- +id: publication-2026-04-14-youtube-international +type: publication +status: published +date: 2026-04-14 +updated: 2026-04-25 +confidentiality: public +source_type: video +source_url: https://www.youtube.com/watch?v=8OiW9qVLML4 +people: [CoderWanFeng] +tags: [external-coverage, youtube, international, english, video] +related_docs: [] +related_sources: [source-2026-04-14-coderwanfeng-youtube-skillhub] +summary: CoderWanFeng 在 YouTube 发布首个英文视频介绍 SkillHub,标志着项目开始触达国际开发者社区 +--- + +# SkillHub 首个国际化视频报道 + +## 渠道 + +YouTube + +## 作者或发布方 + +CoderWanFeng + +## 摘要 + +2026 年 4 月 14 日,CoderWanFeng 在 YouTube 发布了标题为 "SkillHub Open-Source: AI Agent Skills for Enterprise Teams" 的英文视频,这是 SkillHub 的首个面向国际受众的视频报道。 + +视频发布时间(4 月 14 日)早于多篇微信文章,属于较早期的报道之一。截至 4 月 25 日,视频已有 85 次观看。 + +## 与 SkillHub 的相关性 + +### 国际化传播的开端 + +这是 SkillHub 首次以英文形式在国际平台上被介绍,标志着项目开始尝试触达国际开发者社区。 + +虽然观看量不大(85 次),但作为首个英文视频报道,具有开创性意义。 + +### 定位清晰 + +视频标题直接点明了 SkillHub 的核心定位: +- **Open-Source**:开源属性 +- **AI Agent Skills**:技能管理 +- **Enterprise Teams**:企业级、团队协作 + +这种定位方式简洁明了,适合国际受众快速理解项目价值。 + +### 创作者背景 + +CoderWanFeng 是活跃的技术内容创作者,同时在微信等国内平台也有影响力。选择在 YouTube 发布英文内容,说明创作者有意识地帮助 SkillHub 进行国际化传播。 + +### 传播策略启示 + +这个视频的出现提示了几个可能的传播方向: +1. 国际化传播需要英文内容支持 +2. 视频形式可能比文字更适合跨语言传播 +3. 需要更多国际平台的曝光(YouTube、Reddit、Hacker News 等) + +## 来源链接 + +- [YouTube 视频](https://www.youtube.com/watch?v=8OiW9qVLML4) +- [档案来源记录](../../sources/articles/2026-04-14-coderwanfeng-youtube-skillhub.md) diff --git a/docs/archive/publications/external/2026-04-wechat-media-coverage.md b/docs/archive/publications/external/2026-04-wechat-media-coverage.md new file mode 100644 index 00000000..59d19256 --- /dev/null +++ b/docs/archive/publications/external/2026-04-wechat-media-coverage.md @@ -0,0 +1,126 @@ +--- +id: publication-2026-04-wechat-media-coverage +type: publication +status: published +date: 2026-04-01 +updated: 2026-04-25 +confidentiality: public +source_type: media-coverage +source_url: +people: [小G, JackCui, 沉默王二, 小林, AI产品阿颖, 阿枫科技] +tags: [external-coverage, wechat, media-wave, community-response] +related_docs: [] +related_sources: [source-2026-04-01-githubdaily-skillhub, source-2026-04-02-jackcui-skillhub, source-2026-04-chenmoer-skillhub, source-2026-04-xiaolincoding-skillhub, source-2026-04-aiying-skillhub, source-2026-04-afengkeji-skillhub] +summary: 2026 年 4 月,SkillHub 在微信技术圈形成集中报道潮,6 位技术自媒体从不同角度介绍项目,覆盖安全、部署、企业应用等多个维度 +--- + +# 2026 年 4 月微信技术圈报道潮 + +## 渠道 + +微信公众号 + +## 发布方 + +GitHubDaily、JackCui、沉默王二、小林coding、AI产品阿颖、阿枫科技 + +## 摘要 + +2026 年 4 月,SkillHub 在微信技术圈形成了一波集中的媒体报道。从 4 月 1 日 GitHubDaily 首发,到 4 月 2 日 JackCui 跟进,再到 4 月中下旬多位技术自媒体相继发文,形成了较为密集的传播节奏。 + +这批报道覆盖了不同的视角和侧重点,共同构成了 SkillHub 在国内技术社区的首轮传播。 + +## 报道特点分析 + +### 时间线 + +- **4 月 1 日**:GitHubDaily 首发,完整功能演示 +- **4 月 2 日**:JackCui 跟进,深度安全分析 +- **4 月中下旬**:沉默王二、小林coding、AI产品阿颖、阿枫科技集中发文 + +### 视角分类 + +**功能演示型**(GitHubDaily、沉默王二、小林coding) +- 完整的部署到使用流程 +- 核心功能逐一演示 +- 面向想要快速上手的用户 + +**安全分析型**(JackCui) +- 从 Claude Code 源码泄露事件切入 +- 深度分析 Skill 投毒的三种攻击模式 +- 将 SkillHub 定位为安全管控方案 +- 类比 PC 时代的安全蛮荒期 + +**实战经验型**(AI产品阿颖、阿枫科技) +- 真实使用场景和痛点 +- 小团队视角的实际体验 +- 强调知识管理和团队协作价值 + +### 内容深度 + +**最详尽**:沉默王二 +- 覆盖全流程 +- 安全扫描机制详解 +- CLI 使用指南 +- 技术栈分析 +- 简历写法建议 + +**最深入**:JackCui +- Skill 投毒攻击模式分析 +- 历史类比(PC 安全蛮荒期) +- 分层建议(个人/小团队/企业) + +**最接地气**:AI产品阿颖、阿枫科技 +- 真实使用动机 +- 亦庄大会偶遇后当天部署 +- 小团队实际痛点 + +### 共同主题 + +所有报道都强调了以下几点: +1. **私有化部署**:数据主权和安全可控 +2. **企业级定位**:区别于公开 Skill 平台 +3. **审核机制**:质量把关和安全保障 +4. **多平台兼容**:一次发布,多端复用 +5. **开源精神**:科大讯飞的格局 + +## 与 SkillHub 的相关性 + +### 传播效果 + +这波报道形成了较好的传播效果: +- 覆盖了微信技术圈的主要 KOL +- 不同视角满足不同读者需求 +- 沉默王二文章发布时 GitHub 已达 1.5K Star + +### 定位确认 + +报道共同确认了 SkillHub 的核心定位: +- "AI Agent 世界里的 npm"(沉默王二) +- "企业级 Agent Skill 商店"(多篇) +- "组织沉淀经验的正确方式"(AI产品阿颖) + +### 痛点验证 + +报道验证了 SkillHub 解决的核心痛点: +- Skill 版本混乱,不知道谁在用哪个版本 +- 手动分发效率低,无法规模化 +- 安全风险无法管控 +- 团队知识无法有效沉淀 + +### 用户画像 + +从报道中可以看出目标用户群体: +- 有 10+ 人的技术团队 +- 需要内部 Skill 共享和管理 +- 对数据安全有要求 +- 希望建立知识管理体系 + +## 来源链接 + +- [GitHubDaily 报道](../../sources/articles/2026-04-01-githubdaily-skillhub.md) +- [JackCui 报道](../../sources/articles/2026-04-02-jackcui-skillhub.md) +- [沉默王二 报道](../../sources/articles/2026-04-chenmoer-skillhub.md) +- [小林coding 报道](../../sources/articles/2026-04-xiaolincoding-skillhub.md) +- [AI产品阿颖 报道](../../sources/articles/2026-04-aiying-skillhub.md) +- [阿枫科技 报道](../../sources/articles/2026-04-afengkeji-skillhub.md) diff --git a/docs/archive/sources/README.md b/docs/archive/sources/README.md new file mode 100644 index 00000000..fa01a8b0 --- /dev/null +++ b/docs/archive/sources/README.md @@ -0,0 +1,16 @@ +# 来源记录 + +`sources/` 是档案的证据层。 + +这里用于保存那些可能被其他页面引用的结构化记录: + +- 文章与公告 +- 聊天摘要或聊天记录引用 +- 提交摘要 +- 截图或演示材料 + +建议遵循这样一条原则: + +- 如果另一个档案页面写了“这件事发生过”或“这件事很重要”,通常都应该能在这里、仓库文档里,或 GitHub 记录里找到支撑它的依据 + +新建条目时请参考 `../templates/source.md`。 diff --git a/docs/archive/sources/articles/2026-03-11-jimmysong-skillhub-intro.md b/docs/archive/sources/articles/2026-03-11-jimmysong-skillhub-intro.md new file mode 100644 index 00000000..3e481a5e --- /dev/null +++ b/docs/archive/sources/articles/2026-03-11-jimmysong-skillhub-intro.md @@ -0,0 +1,70 @@ +--- +id: source-2026-03-11-jimmysong-skillhub +type: source +status: published +date: 2026-03-11 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://jimmysong.io/ai/skillhub/ +people: [Jimmy Song] +tags: [external-coverage, ai-oss-landscape, enterprise-registry] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: Jimmy Song 在其 AI OSS Landscape 项目中收录了 SkillHub,这是首个将 SkillHub 纳入 AI 开源生态全景图的第三方报道 +--- + +# Jimmy Song AI OSS Landscape 收录 SkillHub + +## 这是什么 + +Jimmy Song 在其维护的 AI 开源软件全景图(AI OSS Landscape)项目中,将 SkillHub 作为独立条目收录,归类在 "Dev Tools" 和 "CLI" 类别下。 + +这是一个结构化的项目介绍页面,包含项目概览、核心特性、使用场景和技术亮点等完整信息。 + +## 为什么重要 + +- 这是 SkillHub 首次被纳入第三方维护的 AI 开源生态全景图 +- Jimmy Song 是云原生和 AI 领域的知名技术布道者,其全景图项目具有较高的行业影响力 +- 该收录为 SkillHub 在企业级 AI agent 技能管理领域的定位提供了外部验证 +- 页面提供了结构化的项目信息,便于潜在用户快速了解 SkillHub 的价值主张 + +## 关键事实 + +### 项目定位 +- 描述为 "open-source, enterprise-grade agent skill registry" +- 强调企业级、自托管、治理能力 + +### 核心特性摘要 +- 自托管部署(Docker/Kubernetes) +- 语义化版本管理 +- 团队命名空间与 RBAC +- 评审与治理流程 +- CLI 与 REST API +- 可插拔存储后端 +- 国际化支持 + +### 技术栈 +- 后端:Spring Boot 3.2.3、Java 21、PostgreSQL 16、Redis 7 +- 前端:React 19、TypeScript、Vite、TanStack Router/Query +- 运维:Prometheus + Grafana、Kubernetes + +### 使用场景 +- 企业内部技能包集中管理 +- 为 OpenClaw、AstronClaw、Loomy 等平台提供注册后端 +- 多团队协作与分层治理 +- 大规模 Kubernetes 环境下的技能仓库 + +### 页面元数据 +- 收录日期:2026-03-11 +- 最后更新:2026-03-11T12:17:05Z +- 许可证:Apache License 2.0 +- 标签:Dev Tools、CLI、Application + +## 相关链接 + +- [Jimmy Song AI OSS Landscape - SkillHub](https://jimmysong.io/ai/skillhub/) +- [SkillHub GitHub 仓库](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/articles/2026-04-01-githubdaily-skillhub.md b/docs/archive/sources/articles/2026-04-01-githubdaily-skillhub.md new file mode 100644 index 00000000..e45a4ad6 --- /dev/null +++ b/docs/archive/sources/articles/2026-04-01-githubdaily-skillhub.md @@ -0,0 +1,70 @@ +--- +id: source-2026-04-01-githubdaily-skillhub +type: source +status: published +date: 2026-04-01 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://mp.weixin.qq.com/s/JVXPMNrCC3b3fcvZ32WYkA +people: [小G] +tags: [external-coverage, wechat, githubdaily, deployment, namespace] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: GitHubDaily 公众号发布 SkillHub 开源介绍,详细演示部署、命名空间、发布审核、搜索、API Token 等核心功能 +--- + +# GitHubDaily:SkillHub,开源了! + +## 基本信息 + +- 公众号:GitHubDaily +- 作者:小G +- 发布日期:2026 年 4 月 1 日 +- 地区:广东 + +## 文章摘要 + +文章以"给 AI 装 Skill 就像以前装插件"为切入点,指出随着 Skill 技能包大量涌现,企业面临迭代管理、权限分配、数据安全三大痛点,引出科大讯飞开源的 SkillHub 作为解决方案。 + +文章将 SkillHub 定位为"技能商店",支持私有化部署,数据完全自主可控,并兼容 ClawHub CLI 协议。 + +## 核心内容 + +### 一条命令,直接运行 +```bash +curl -fsSL https://raw.githubusercontent.com/iflytek/skillhub/main/scripts/runtime.sh | sh -s -- up +``` +安装完成后访问 `http://localhost` 即可看到 SkillHub 首页。 + +### 命名空间:成员管理,权限分配 +每个团队拥有独立空间,技术和产品团队互不干扰,支持公开或仅团队可见两种可见性。 + +### 发布技能:一键上传到空间 +上传 `.zip` 文件即可发布,普通成员发布需管理员审核,版本号自动生成,支持"申请提升到全局"。 + +### 审核流:进入团队前的最后一关 +管理员在审核中心查看待审核列表,可浏览技能文件内容并给出评估建议。 + +### 搜索发现:找技能跟搜代码一样快 +支持按相关性、下载量、最新三个维度排序,可勾选"只看已收藏"快速过滤。 + +### API Token:接入 CI/CD,自动化发布 +支持 7 天、30 天、90 天、永不过期或自定义有效期,Token 以 `sk_` 为前缀,创建后仅展示一次。 + +### 一次发布,多平台复用 +已支持 OpenClaw、AstronClaw、Loomy、astron-agent 等平台。 + +## 结语观点 + +> ClawHub、skills.sh 这些公开技能平台,已经验证了技能共享这件事的价值。但公开技能平台天然解决不了团队内部的需求,私有技能的治理,是这些平台覆盖不到的地方。 + +> SkillHub,可以说是这个方向上,现阶段最为完善的开源解决方案之一。 + +## 相关链接 + +- [原文链接](https://mp.weixin.qq.com/s/JVXPMNrCC3b3fcvZ32WYkA) +- [SkillHub GitHub](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/articles/2026-04-02-jackcui-skillhub.md b/docs/archive/sources/articles/2026-04-02-jackcui-skillhub.md new file mode 100644 index 00000000..16c8cb12 --- /dev/null +++ b/docs/archive/sources/articles/2026-04-02-jackcui-skillhub.md @@ -0,0 +1,70 @@ +--- +id: source-2026-04-02-jackcui-skillhub +type: source +status: published +date: 2026-04-02 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://mp.weixin.qq.com/s/5RzZZWLx6c1NRtz-6ii6SQ +people: [JackCui] +tags: [external-coverage, wechat, security, skill-poisoning, enterprise] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: JackCui 从 Claude Code 源码泄露事件和 Skill 投毒安全风险切入,引出 SkillHub 作为企业级安全管控方案,深度分析了 Skill 投毒的三种攻击模式 +--- + +# JackCui:SkillHub,开源了! + +## 基本信息 + +- 公众号:JackCui +- 作者:JackCui +- 发布日期:2026 年 4 月 2 日 +- 地区:北京 + +## 文章摘要 + +文章以 Claude Code 源码泄露事件为背景,深入分析了 AI 工具生态中的安全风险,尤其是 **Skill 投毒**问题,并将 SkillHub 的审核机制定位为应对这一威胁的企业级解决方案。 + +这是所有报道中安全视角最深入的一篇,具有较高的技术参考价值。 + +## 核心内容 + +### Skill 投毒的三种攻击模式 + +**第一:恶意逻辑藏在自然语言里,极其隐蔽** +攻击者在 skill 的 `description` 字段中嵌入隐藏的 prompt injection 指令,LLM 在选择工具时会读取 description,恶意指令可能被当作系统级指示执行。 + +**第二:分发链条松散,信任体系几乎为零** +社区里大量 skill 通过 GitHub repo、论坛等方式传播,没有审核、没有签名、没有沙箱隔离,全凭社区口碑。 + +**第三:可以做到"延迟触发",测试根本防不住** +前 99 次调用都正常,检测到特定条件(如 `production` 关键词、AWS credentials 文件存在)时才激活恶意行为。 + +### 历史类比:AI 时代的"蛮荒年代" +文章将当前 AI 工具生态类比为 2000 年前后个人电脑刚普及时的安全蛮荒期,认为行业必然会重走 PC 安全的老路,建议主动建立安全基础设施而非等待"熊猫烧香"爆发。 + +### SkillHub 作为解决方案 +- 私有化部署,数据完全自主可控 +- 内置完整审核工作流,管理员集中审核 +- 把"每个人自己甄别安全性"的不可能任务,变成"少数专业人员集中审核"的可控任务 + +### 分层建议 +- **个人开发者**:用社区 skill 时至少花两分钟看完整 prompt 定义 +- **小团队**:一条命令用 Docker 跑起来,把内部常用 skill 收拢统一管理 +- **企业**:认真规划命名空间、审核流程和 CI/CD 集成,纳入 DevOps 体系 + +## 结语观点 + +> 代码有 Git 仓库管,容器镜像有 Docker Hub 分发,而团队自己的 AI 技能库管理,现在才处于起步阶段。 + +> 我们不需要等到 AI 时代的"熊猫烧香"真正爆发了,才开始重视这件事。 + +## 相关链接 + +- [原文链接](https://mp.weixin.qq.com/s/5RzZZWLx6c1NRtz-6ii6SQ) +- [SkillHub GitHub](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/articles/2026-04-14-coderwanfeng-youtube-skillhub.md b/docs/archive/sources/articles/2026-04-14-coderwanfeng-youtube-skillhub.md new file mode 100644 index 00000000..936a1691 --- /dev/null +++ b/docs/archive/sources/articles/2026-04-14-coderwanfeng-youtube-skillhub.md @@ -0,0 +1,44 @@ +--- +id: source-2026-04-14-coderwanfeng-youtube-skillhub +type: source +status: published +date: 2026-04-14 +updated: 2026-04-25 +confidentiality: public +source_type: video +source_url: https://www.youtube.com/watch?v=8OiW9qVLML4 +people: [CoderWanFeng] +tags: [external-coverage, youtube, video, english, enterprise] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: CoderWanFeng 在 YouTube 发布英文视频介绍 SkillHub,面向国际受众,发布于 2026 年 4 月 14 日,85 次观看 +--- + +# CoderWanFeng:SkillHub Open-Source: AI Agent Skills for Enterprise Teams + +## 基本信息 + +- 频道:CoderWanFeng(YouTube) +- 发布日期:2026 年 4 月 14 日 +- 观看次数:85 次(截至 2026-04-25) +- 视频链接:https://www.youtube.com/watch?v=8OiW9qVLML4 + +## 内容摘要 + +CoderWanFeng 在 YouTube 发布了一段英文视频,介绍 SkillHub 作为企业级 AI Agent 技能管理平台的开源方案。这是目前已知的唯一一篇面向国际受众的英文视频报道。 + +视频标题为 "SkillHub Open-Source: AI Agent Skills for Enterprise Teams",定位清晰,直接面向企业用户群体。 + +## 意义 + +- SkillHub 的首个英文视频报道,有助于触达国际开发者社区 +- CoderWanFeng 是活跃的技术内容创作者,同时在微信等国内平台也有影响力 +- 视频发布时间(4 月 14 日)早于多篇微信文章,属于较早期的报道之一 + +## 相关链接 + +- [YouTube 视频](https://www.youtube.com/watch?v=8OiW9qVLML4) +- [SkillHub GitHub](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/articles/2026-04-afengkeji-skillhub.md b/docs/archive/sources/articles/2026-04-afengkeji-skillhub.md new file mode 100644 index 00000000..3f841502 --- /dev/null +++ b/docs/archive/sources/articles/2026-04-afengkeji-skillhub.md @@ -0,0 +1,63 @@ +--- +id: source-2026-04-afengkeji-skillhub +type: source +status: published +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://mp.weixin.qq.com/s/ZVTXhK_l1HYPNLHKB_axgQ +people: [阿枫科技] +tags: [external-coverage, wechat, small-team, use-case, open-source-spirit] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: 阿枫科技 以小团队视角分享自建 Skill 市场的实际体验,强调 SkillHub 对中大型企业的提效价值,并称赞科大讯飞"给中大型企业开发的平台却选择免费开源,格局相当大" +--- + +# 阿枫科技:科大讯飞开源了个狠东西,Skillhub 真的太实用了! + +## 基本信息 + +- 公众号:阿枫科技 +- 作者:阿枫科技 +- 发布日期:2026 年 4 月(具体日期未显示) + +## 文章摘要 + +作者以小团队(十来号人)的视角,分享了自建 Skill 市场的实际动机和体验。文章从"想把自己写的大纲 Skill 分享给团队成员,但每次手动发文件太麻烦"这一具体场景出发,引出 SkillHub 作为解决方案。 + +## 核心内容 + +### 使用动机 +> 我前两天总结了一下我写大纲的技巧,搞出了一个大纲 Skill,想要发给团队成员使用。但我发现还要把文件一个一个地给他们发,很是有点麻烦。一次两次还好,但我后面肯定还会经常做一些对工作有帮助的 Skill,每次都手动推送,效率太低了。所以我就直接搭建了一个只属于我们团队的 Skill 市场。 + +### 与 ClawHub 的对比 +> 经常用小龙虾的同学,应该都用过 Clawhub 下载技能吧?Skillhub 和它有点类似。但区别在于,我们自建的技能平台只允许团队成员使用,可以很好地保护我们的团队隐私。 + +### 部署体验 +```bash +curl -fsSL https://raw.githubusercontent.com/iflytek/skillhub/main/scripts/runtime.sh | sh -s -- up +``` +运行完毕后会给出访问地址,直接访问即可打开已部署好的平台。 + +### 功能评价 +- 首页支持模糊搜索 +- 技能详情页包含概述、安装依赖、文件目录,下载安装入口在右下角 +- 只有经过管理员授权的账号才能下载 +- 上传技能需经管理员审核后发布 +- 界面简洁,"该有的功能一个都不少" + +### 对中大型企业的价值 +> 如果你的企业规模超过百人,那 Skillhub 就更有价值了。在这上百名成员中,可能随时会有人突发奇想,做出一个对团队工作流非常有帮助的技能。如果正常报给领导……可能小一周都过去了。但如果团队里有了这样的平台,普通成员把技能上传后,只要通过审核,就可以发布。快的话,可能一个小时内,同事们就能用上这个技能了。 + +## 结语观点 + +> 给中大型企业开发的平台,却选择了免费开源,说实话格局还是相当大的,也算是为国产 Agent 生态的发展贡献了一份不小的力量。 + +## 相关链接 + +- [原文链接](https://mp.weixin.qq.com/s/ZVTXhK_l1HYPNLHKB_axgQ) +- [SkillHub GitHub](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/articles/2026-04-aiying-skillhub.md b/docs/archive/sources/articles/2026-04-aiying-skillhub.md new file mode 100644 index 00000000..692b8b23 --- /dev/null +++ b/docs/archive/sources/articles/2026-04-aiying-skillhub.md @@ -0,0 +1,66 @@ +--- +id: source-2026-04-aiying-skillhub +type: source +status: published +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://mp.weixin.qq.com/s/L5aVbOEi2v9-66tbD465lg +people: [AI产品阿颖] +tags: [external-coverage, wechat, team-use-case, knowledge-management, skill-asset] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: AI产品阿颖 从团队实际使用 Skill 的痛点出发,将 SkillHub 定位为"组织沉淀经验的正确方式",分享了在亦庄大会上得知该项目并当天部署试用的真实经历 +--- + +# AI产品阿颖:这个神级开源项目,解决了 Skill 的最大痛点。 + +## 基本信息 + +- 公众号:AI产品阿颖 +- 作者:AI产品阿颖 +- 发布日期:2026 年 4 月(具体日期未显示) + +## 文章摘要 + +作者从团队实际使用 Skill 的痛点出发,将 SkillHub 定位为"组织沉淀经验的正确方式"。文章以第一人称叙述了在亦庄卡兹克大会茶歇时得知 SkillHub、当天回公司部署试用的真实经历,视角真实接地气。 + +## 核心内容 + +### 团队使用 Skill 的痛点 +作者以筹备 AI Maker Summit 深圳场为例,说明团队内部定制 Skill 的价值: +- 新人培训靠手把手,经验随人员流失 +- Skill 不是让人去读的,是让 Agent 去跑的,把隐性知识变成可执行能力 +- 多人多版本,不知道谁有什么、谁在用哪个版本 +- 不可能把团队 Skill 放到 ClawHub 上公开 + +### 发现 SkillHub 的经过 +> 昨天在亦庄参加卡兹克的大会,茶歇的时候碰到一个老朋友。聊到 Skill 共享这个痛点,他说你可以看看 SkillHub,一个开源项目,科大讯飞团队做的,专门解决这个问题。下午回到公司,麻溜装上试了试。 + +### 部署方式 +```bash +curl -fsSL https://raw.githubusercontent.com/iflytek/skillhub/main/scripts/runtime.sh | sh -s -- up +``` +也可以直接把 GitHub 地址发给 Claude Code 或 Codex,让 AI 帮忙完成安装。 + +### 核心功能体验 +- 命名空间:按部门隔离,支持权限管理 +- 上传审核:上传后需管理员审核,系统自动标出可能有问题的地方 +- 版本管理:统一放 SkillHub,更新了就是更新了,大家拿到的都是同一份 +- Token 登录:权限控制体系,需登录才能使用 + +### 对 SkillHub 价值的判断 +> 往长远看,Skill 一定会成为企业最重要的资产。但这个资产之前一直是散的。今天这个开源项目,算是把最后一块拼图给补上了。 + +## 结语观点 + +> 接下来我准备把它部署到公司局域网,把这段时间常用的 Skill 都放进去。以后团队要用什么,直接从 SkillHub 上找就行。 + +## 相关链接 + +- [原文链接](https://mp.weixin.qq.com/s/L5aVbOEi2v9-66tbD465lg) +- [SkillHub GitHub](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/articles/2026-04-chenmoer-skillhub.md b/docs/archive/sources/articles/2026-04-chenmoer-skillhub.md new file mode 100644 index 00000000..e4b72a42 --- /dev/null +++ b/docs/archive/sources/articles/2026-04-chenmoer-skillhub.md @@ -0,0 +1,86 @@ +--- +id: source-2026-04-chenmoer-skillhub +type: source +status: published +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://mp.weixin.qq.com/s/KL92y4eytpa9C5Q1FnH6Ww +people: [沉默王二] +tags: [external-coverage, wechat, deep-dive, security-scan, cli, resume] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: 沉默王二对 SkillHub 进行深度体验,覆盖部署、发布、发现、治理、安全扫描、CLI 使用全流程,并给出简历写法建议,GitHub 已达 1.5K Star +--- + +# 沉默王二:科大讯飞官宣开源,有点猛啊。SkillHub 免折腾,三分钟给 AI Agent 搭建技能商店。 + +## 基本信息 + +- 公众号:沉默王二 +- 作者:沉默王二 +- 发布日期:2026 年 4 月(具体日期未显示) +- GitHub Star 数:1.5K(文章发布时) + +## 文章摘要 + +沉默王二对 SkillHub 进行了全流程深度体验,将其定位为"AI Agent 世界里的 npm 或 Docker Hub"。文章覆盖了从部署到 CLI 使用的完整链路,是所有报道中内容最详尽的一篇,并附有简历写法建议。 + +## 核心内容 + +### 定位 +> 科大讯飞这次干的漂亮。他们开源了一个叫 SkillHub 的项目,定位是"企业级 Agent Skill 商店"。说人话就是:给 AI Agent 造了一个 npm,或者说是 Docker Hub,但专门为 Skills 设计。 + +### 一键部署 +```bash +curl -fsSL https://raw.githubusercontent.com/iflytek/skillhub/main/scripts/runtime.sh | sh -s -- up +``` +整个过程约两三分钟,无需配置数据库、安装依赖、修改配置文件。 + +### Skill 包格式 +核心格式为 `SKILL.md`,包含 frontmatter(元数据)和 body(内容)两部分,与 Hugo、Jekyll 等静态博客引擎格式一致。 + +### 安全扫描机制(详解) +文章专门用一节详解了安全扫描流程: +1. **结构校验**:验证 SKILL.md 是否存在、frontmatter 是否合法、必填字段是否完整 +2. **代码质量扫描**:静态分析工具检查代码风格、潜在 bug、复杂度,不实际执行代码 +3. **安全漏洞检测**:检查命令注入风险、路径穿越风险、敏感信息硬编码,标注风险等级(高/中/低) +4. **依赖链扫描**:递归检查依赖链中的已知漏洞,类似 `npm audit` 机制 + +### CLI 使用指南 +```bash +# 测试兼容发现端点 +curl http://localhost:8080/.well-known/clawhub.json + +# 搜索技能 +npx clawhub search ifly + +# 查看详情 +npx clawhub inspect ifly-pdf-image-ocr + +# 直接安装(指定 registry) +npx clawhub install ifly-pdf-image-ocr --registry http://localhost:3001 +``` + +### 技术栈 +- 后端:Spring Boot 3.2.3、Java 21 +- 存储:PostgreSQL + Redis +- 存储插件:本地文件系统、MinIO、AWS S3、阿里云 OSS、腾讯云 COS + +### 简历写法建议 +文章给出了将 SkillHub 使用经验写入简历的具体模板,定位为"企业级 AI 技能管理平台(基于 SkillHub 私有部署)"。 + +## 结语观点 + +> 科大讯飞这次开源 SkillHub,是站在了"企业级"这个细分赛道上。企业需要什么?私有部署、权限管理、审核流程、数据主权。这些需求,公有平台满足不了,但 SkillHub 满足得了。 + +> SkillHub 已经 1.5K Star 了,如果你也在做企业 AI 平台,建议去看一眼源码,一定能给你很多很多启发。 + +## 相关链接 + +- [原文链接](https://mp.weixin.qq.com/s/KL92y4eytpa9C5Q1FnH6Ww) +- [SkillHub GitHub](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/articles/2026-04-xiaolincoding-skillhub.md b/docs/archive/sources/articles/2026-04-xiaolincoding-skillhub.md new file mode 100644 index 00000000..32cd58ad --- /dev/null +++ b/docs/archive/sources/articles/2026-04-xiaolincoding-skillhub.md @@ -0,0 +1,69 @@ +--- +id: source-2026-04-xiaolincoding-skillhub +type: source +status: published +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: public +source_type: article +source_url: https://mp.weixin.qq.com/s/z5F9mr0hyqFoKGZ-5yC9cw +people: [小林] +tags: [external-coverage, wechat, xiaolincoding, private-deploy, multi-platform] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: 小林coding 介绍 SkillHub,重点强调私有化部署对数据主权的保护和多平台兼容降低迁移成本两大核心价值,并演示了用 Claude Code 自动发布 Skill 的完整流程 +--- + +# 小林coding:SkillHub,这个开源神器火了! + +## 基本信息 + +- 公众号:小林coding +- 作者:小林 +- 发布日期:2026 年 4 月(具体日期未显示) + +## 文章摘要 + +小林 coding 从企业 Skill 管理痛点切入,重点阐述了 SkillHub 的两大核心价值:私有化部署保护数据主权、多平台兼容降低迁移成本。文章还演示了用 Claude Code 自动生成并发布 Skill 的完整流程。 + +## 核心内容 + +### 两大核心价值 + +**私有化部署** +> 所有的技能文件、审核记录还有团队的调用日志,全都牢牢锁在你们自己的服务器上。外面的人根本摸不到你们的核心业务逻辑。这就从根源上解决了企业对数据泄露的隐私焦虑。 + +**多平台兼容** +> SkillHub 就像一个打通生态的中央大仓库。只需在本地环境配好注册中心地址,无论你们平时是用 Claude Code,还是 OpenClaw,甚至其他的 Agent 平台,都能直接通过命令行搜到并安装你们的私有技能。一次发布就能全平台无缝调用。 + +### 部署方式 +```bash +make dev-all +``` +首次拉取镜像后,打开本地 3000 端口即可访问,整个过程约三分钟。 + +### 组织架构与团队隔离 +命名空间支持按部门隔离,支持所有者、管理员、普通成员三种角色权限。 + +### 用 Claude Code 自动发布 Skill +文章演示了完整的 AI 辅助发布流程: +1. 让 Claude Code 生成一个美术设计 Skill +2. 让 Claude Code 生成一个发布流程 Skill +3. 让 Claude Code 将美术设计 Skill 自动上传到 SkillHub + +### 审核与安全扫描 +系统后台会立刻进行异步安全扫描,检查代码质量和安全漏洞,管理员查看扫描报告后再决定是否批准发布。 + +## 结语观点 + +> 这次科大讯飞的 SkillHub 最强大的底牌在于生态兼容性和对企业数据主权的保护。 + +> 如果你的团队刚好也在头疼 AI 技能的管理和共享问题,我强烈建议你拿 SkillHub 跑一跑。 + +## 相关链接 + +- [原文链接](https://mp.weixin.qq.com/s/z5F9mr0hyqFoKGZ-5yC9cw) +- [SkillHub GitHub](https://github.com/iflytek/skillhub) diff --git a/docs/archive/sources/commits/2026-04-25-repository-commit-history.md b/docs/archive/sources/commits/2026-04-25-repository-commit-history.md new file mode 100644 index 00000000..dbd3d0f0 --- /dev/null +++ b/docs/archive/sources/commits/2026-04-25-repository-commit-history.md @@ -0,0 +1,127 @@ +--- +id: source-2026-04-25-repository-commit-history +type: source +status: curated +date: 2026-04-25 +updated: 2026-04-25 +confidentiality: internal +source_type: commit +source_path: git history at HEAD +people: [vsxd, yun-zhi-ztl, dongmucat, XiaoSeS, wowo-zZ, xiose, wowo] +tags: [source, commits, timeline, contributors] +related_docs: + - docs/archive/narratives/repository-history.md + - docs/archive/timeline/2026/2026-03.md + - docs/archive/timeline/2026/2026-04.md +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: 覆盖 2026-03-11 到 2026-04-24 的第一阶段仓库提交历史来源记录。 +--- + +# 仓库提交历史 + +## 范围 + +这份来源记录汇总了 `2026-04-25` 时 `HEAD` 可达的完整 Git 历史。 + +- 提交总数:`734` +- 非合并提交:`624` +- 合并提交:`110` +- 可见时间范围:`2026-03-11` 到 `2026-04-24` + +## 活跃度快照 + +- `2026-03`:`632` 个提交 +- `2026-04`:`102` 个提交 + +当前历史中最密集的提交日为: + +- `2026-03-12`:`89` 个提交 +- `2026-03-13`:`70` 个提交 +- `2026-03-15`:`69` 个提交 +- `2026-03-19`:`67` 个提交 +- `2026-03-14`:`60` 个提交 + +这说明项目的启动阶段被压缩得非常厉害:设计、实现、工作流搭建和产品成形,几乎都在前十天内集中落地。 + +## 贡献者分布 + +以 `HEAD` 为准,非合并提交数量最高的贡献者为: + +- `vsxd`:`208` +- `yun-zhi-ztl`:`194` +- `dongmucat`:`68` +- `XiaoSeS`:`31` +- `wowo-zZ`:`30` +- `xiose`:`27` +- `FenjuFu`:`12` +- `Xudong Sun`:`10` +- `wowo`:`9` + +早期提交流高度集中在 `vsxd` 和 `yun-zhi-ztl` 身上,随后逐渐扩展成更分布式的多人协作格局。 + +## 提交前缀扫描 + +以下统计来自对非合并提交标题前缀的扫描: + +- `fix`:`267` +- `feat`:`163` +- `docs`:`57` +- `test`:`33` +- `refactor`:`17` +- `chore`:`25` + +这个比例强烈说明,仓库从最初搭建阶段很快就进入了稳定性修复和产品硬化阶段。 + +## 主题扫描 + +按关键字扫描非合并提交标题后,最显眼的重复主题如下: + +- `web_ui`:`141` +- `skill`:`119` +- `auth`:`84` +- `review_governance`:`77` +- `docs`:`72` +- `search`:`46` +- `storage_io`:`38` +- `compat_cli`:`27` +- `scanner_security`:`16` +- `notification`:`5` + +这和仓库中可见的产品形态是对得上的:提交历史并不只是后端导向,而是很快扩展到 UI、治理、文档、兼容性和运维体验。 + +## 发布与协作标记 + +提交标题中可见的发布标记包括: + +- `2026-03-13`:`chore(release): cut v0.1.0-beta.2` +- `2026-03-13`:`chore(release): v0.1.0-beta.7` +- `2026-03-19`:`chore(release): v0.1.0` + +可见的 PR 合并标记从 `2026-03-13` 开始,一直持续到 `2026-04-24`。这表明项目很早就从“自举式实现”转向了更明确的 PR 协作节奏。 + +## 提交流中的强里程碑锚点 + +- `2026-03-11`:初始提交以及项目更名为 SkillHub +- `2026-03-12`:Phase 计划,以及后端、前端、审核、CLI、兼容层、管理端和运维的大量工作在同一天集中落下 +- `2026-03-15` 到 `2026-03-20`:生命周期管理、命名空间治理、安全加固、语义搜索、文档站点、资料审核和标签系统相关工作 +- `2026-03-19`:`v0.1.0` +- `2026-03-23` 到 `2026-03-31`:通知、扫描系统、文件浏览侧栏、发布部署扩展、分享能力与 Unicode slug +- `2026-04-01` 到 `2026-04-24`:双语文档站点、部署指南、PR e2e、issue 自动化、发布警告确认、密码重置、GitLab OAuth,以及反复出现的搜索/存储/审核硬化 + +## 方法 + +这份记录基于 shell 对仓库历史的扫描整理而成,所用命令大致如下: + +```bash +git rev-list --count HEAD +git rev-list --count --no-merges HEAD +git rev-list --count --merges HEAD +git shortlog -sn --no-merges HEAD +git log --reverse --date=short --pretty=format:'%ad|%h|%an|%s' +git log --date=short --pretty=format:'%ad' | cut -c1-7 | sort | uniq -c +``` + +这份文件是更高层项目历程叙事背后的证据层。 diff --git a/docs/archive/templates/README.md b/docs/archive/templates/README.md new file mode 100644 index 00000000..12708329 --- /dev/null +++ b/docs/archive/templates/README.md @@ -0,0 +1,21 @@ +# 模板 + +本目录包含项目档案各类条目的模板文件,用于统一归档格式。 + +## 可用模板 + +| 模板 | 文件 | 用途 | +|------|------|------| +| 时间线条目 | [timeline-entry.md](./timeline-entry.md) | 记录特定时间段的事件 | +| 里程碑 | [milestone.md](./milestone.md) | 记录项目关键节点 | +| 决策 | [decision.md](./decision.md) | 记录重要决策及其背景 | +| 贡献者 | [contributor.md](./contributor.md) | 记录项目贡献者信息 | +| 沟通摘要 | [communication-summary.md](./communication-summary.md) | 记录会议、讨论等沟通内容 | +| 发文 | [publication.md](./publication.md) | 记录对外发布的内容 | +| 来源 | [source.md](./source.md) | 记录档案信息的来源 | + +## 使用方法 + +1. 复制对应模板到目标目录 +2. 按模板中的占位符填写内容 +3. 确保填写 frontmatter 中的必填字段(`id`、`type`、`status`) diff --git a/docs/archive/templates/communication-summary.md b/docs/archive/templates/communication-summary.md new file mode 100644 index 00000000..b8c2b0fe --- /dev/null +++ b/docs/archive/templates/communication-summary.md @@ -0,0 +1,30 @@ +--- +id: communication-YYYY-MM-DD-topic +type: communication +status: draft +date: YYYY-MM-DD +updated: YYYY-MM-DD +confidentiality: internal +source_type: chat-summary +people: [] +tags: [] +related_docs: [] +related_prs: [] +related_issues: [] +related_sources: [] +summary: +--- + +# 沟通摘要 + +## 参与者 + +## 背景 + +## 关键点 + +## 决策或结果 + +## 后续动作 + +## 来源引用 diff --git a/docs/archive/templates/contributor.md b/docs/archive/templates/contributor.md new file mode 100644 index 00000000..99a95358 --- /dev/null +++ b/docs/archive/templates/contributor.md @@ -0,0 +1,28 @@ +--- +id: contributor-name +type: contributor +status: draft +date: YYYY-MM-DD +updated: YYYY-MM-DD +confidentiality: internal +people: [name] +tags: [contributor] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: +--- + +# 贡献者姓名 + +## 概览 + +## 最早可见痕迹 + +## 主要工作线索 + +## 重要里程碑 + +## 相关证据 diff --git a/docs/archive/templates/decision.md b/docs/archive/templates/decision.md new file mode 100644 index 00000000..16a30b05 --- /dev/null +++ b/docs/archive/templates/decision.md @@ -0,0 +1,27 @@ +--- +id: decision-YYYY-MM-DD-topic +type: decision +status: draft +date: YYYY-MM-DD +updated: YYYY-MM-DD +confidentiality: internal +people: [] +tags: [] +related_docs: [] +related_prs: [] +related_issues: [] +related_sources: [] +summary: +--- + +# 决策标题 + +## 问题 + +## 选择的方向 + +## 证据 + +## 曾提及的备选方案 + +## 影响 diff --git a/docs/archive/templates/milestone.md b/docs/archive/templates/milestone.md new file mode 100644 index 00000000..6a1697c5 --- /dev/null +++ b/docs/archive/templates/milestone.md @@ -0,0 +1,30 @@ +--- +id: milestone-YYYY-MM-DD-topic +type: milestone +status: draft +date: YYYY-MM-DD +updated: YYYY-MM-DD +confidentiality: internal +people: [] +tags: [] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: +--- + +# 里程碑标题 + +## 摘要 + +## 背景 + +## 发生了什么变化 + +## 证据 + +## 后续影响 + +## 待解问题 diff --git a/docs/archive/templates/publication.md b/docs/archive/templates/publication.md new file mode 100644 index 00000000..01c0d8c8 --- /dev/null +++ b/docs/archive/templates/publication.md @@ -0,0 +1,27 @@ +--- +id: publication-YYYY-MM-DD-channel-topic +type: publication +status: draft +date: YYYY-MM-DD +updated: YYYY-MM-DD +confidentiality: internal +source_type: article +source_url: +people: [] +tags: [] +related_docs: [] +related_sources: [] +summary: +--- + +# 发文标题 + +## 渠道 + +## 作者或发布方 + +## 摘要 + +## 与 SkillHub 的相关性 + +## 来源链接 diff --git a/docs/archive/templates/source.md b/docs/archive/templates/source.md new file mode 100644 index 00000000..cadecd41 --- /dev/null +++ b/docs/archive/templates/source.md @@ -0,0 +1,29 @@ +--- +id: source-YYYY-MM-DD-topic +type: source +status: draft +date: YYYY-MM-DD +updated: YYYY-MM-DD +confidentiality: internal +source_type: document +source_url: +source_path: +people: [] +tags: [] +related_docs: [] +related_prs: [] +related_issues: [] +related_commits: [] +related_sources: [] +summary: +--- + +# 标题 + +## 这是什么 + +## 为什么重要 + +## 关键事实 + +## 相关链接 diff --git a/docs/archive/templates/timeline-entry.md b/docs/archive/templates/timeline-entry.md new file mode 100644 index 00000000..a3819c5b --- /dev/null +++ b/docs/archive/templates/timeline-entry.md @@ -0,0 +1,7 @@ +## YYYY-MM-DD + +简短事件摘要。 + +来源: + +- [标题](path-or-url) diff --git a/docs/archive/timeline/2026/2026-03.md b/docs/archive/timeline/2026/2026-03.md new file mode 100644 index 00000000..ac303212 --- /dev/null +++ b/docs/archive/timeline/2026/2026-03.md @@ -0,0 +1,112 @@ +--- +id: timeline-2026-03 +type: timeline +status: curated +date: 2026-03-31 +updated: 2026-04-25 +confidentiality: internal +tags: [timeline, foundation, architecture] +--- + +# 2026-03 + +## 摘要 + +2026 年 3 月是仓库的创建月份,也是当前历史中实现最密集的一段时期。提交流显示,这个月一共发生了 `632` 个提交,涵盖初始仓库搭建、设计和阶段计划、全栈功能建设、发布准备、治理工作、安全与搜索硬化,以及首个稳定发布标记。 + +配套记录: + +- [仓库历程](../../narratives/repository-history.md) +- [仓库提交历史](../../sources/commits/2026-04-25-repository-commit-history.md) + +## 关键事件 + +### 2026-03-11 + +仓库从初始提交、早期项目文档、项目更名为 SkillHub,以及第一批后端骨架提交开始。 + +同日,SkillHub 被收录进 Jimmy Song 的 AI 开源软件全景图(AI OSS Landscape),这是项目首次获得第三方生态认可。 + +来源: + +- commit `b36b375b`:初始提交 +- commit `dfa66bbf`:项目更名为 SkillHub +- [第 1 阶段计划](../../../superpowers/plans/2026-03-11-phase1-foundation-auth.md) +- [Jimmy Song AI OSS Landscape 收录](../../publications/external/2026-03-11-jimmysong-ai-oss-landscape.md) + +### 2026-03-12 至 2026-03-13 + +这是整个仓库历史里最显著的一次加速点。大量提交在这两天里同时落下了第 2 阶段和第 3 阶段的基础能力,覆盖命名空间管理、技能发布与查询流程、审核与提升、社交能力、Device Flow、ClawHub 兼容层、管理员 API、运行时镜像,以及多份实现计划和设计说明。 + +同一时间窗口里,也出现了最早的 beta 发布标记: + +- `2026-03-13`: `chore(release): cut v0.1.0-beta.2` +- `2026-03-13`: `chore(release): v0.1.0-beta.7` + +来源: + +- [第 2 阶段计划](../../../superpowers/plans/2026-03-12-phase2-namespace-skill-core.md) +- [第 3 阶段计划](../../../superpowers/plans/2026-03-12-phase3-review-cli-social.md) +- [第 4 阶段计划](../../../superpowers/plans/2026-03-12-phase4-ops-polish.md) +- [第 2 阶段设计](../../../superpowers/specs/2026-03-12-phase2-namespace-skill-core-design.md) +- [第 3 阶段设计](../../../superpowers/specs/2026-03-12-phase3-review-cli-social-design.md) +- [第 4 阶段设计](../../../superpowers/specs/2026-03-12-phase4-ops-polish-design.md) +- commit `62d9d885`:`v0.1.0-beta.2` +- commit `14d86c29`:`v0.1.0-beta.7` + +### 2026-03-14 至 2026-03-18 + +仓库在这一阶段从“纯搭建”转向“产品化和硬化”。这个时间窗口中的显著主题包括: + +- staging 与 PR 工作流改进 +- 开发工作流文档 +- 命名空间治理设计与实现 +- 生命周期管理、举报流程和治理中心相关工作 +- 认证、安全与可见性边界修正 +- 落地页、导航栏、i18n 和 dashboard 打磨 +- 公共文档与双语文档建设 +- 搜索与语义排序调优 +- 资料审核与匿名下载控制 + +来源: + +- [开发工作流](../../../dev-workflow.md) +- [命名空间治理计划](../../../superpowers/plans/2026-03-16-namespace-governance.md) +- [命名空间治理设计](../../../superpowers/specs/2026-03-16-namespace-governance-design.md) +- [OpenClaw 集成说明](../../../openclaw-integration.md) + +### 2026-03-19 + +首个稳定发布标记在这一天出现:`chore(release): v0.1.0`。同一天也能看到资料审核、搜索改进、代码文档补充、通知系统设计文档,以及审核流程细化等工作。 + +来源: + +- commit `9bad6a38`:`v0.1.0` +- [通知系统设计](../../../superpowers/specs/2026-03-19-notification-system-design.md) + +### 2026-03-20 + +标签系统的设计与实现开始变得可见,档案也因此能够把平台的“治理 + 元数据”方向描述得更清楚。 + +来源: + +- [技能标签系统设计](../../../2026-03-20-skill-label-system-design.md) + +### 2026-03-23 至 2026-03-31 + +`v0.1.0` 之后的一段时间,产品继续向外扩展,新增或加强了通知、安全扫描、文件预览与审计 UI、scanner 部署、技能分享、更宽松的包支持,以及 Unicode slug 处理。 + +来源: + +- commit `6e8b257a`:站内通知 +- commit `3bc97ff1`:安全扫描系统 +- commit `ee33505b`:文件浏览侧栏和安全审计 UI +- commit `1b7bd066`:技能分享按钮 +- commit `c23d0bbc`:发布部署中加入 scanner 服务 +- commit `5842a022`:Unicode skill slug + +## 后续候选工作 + +- 为 `v0.1.0` 和 scanner 上线建立里程碑文件 +- 把 3 月的治理和通知文档与落地它们的 PR 关联起来 +- 为启动期维护者建立贡献者记录 diff --git a/docs/archive/timeline/2026/2026-04.md b/docs/archive/timeline/2026/2026-04.md new file mode 100644 index 00000000..c473acca --- /dev/null +++ b/docs/archive/timeline/2026/2026-04.md @@ -0,0 +1,124 @@ +--- +id: timeline-2026-04 +type: timeline +status: curated +date: 2026-04-30 +updated: 2026-04-25 +confidentiality: internal +tags: [timeline, docs, workflow, release] +--- + +# 2026-04 + +## 摘要 + +2026 年 4 月显示出仓库已经从快速扩展功能面,转入文档成熟、工作流自动化、兼容性修复,以及围绕真实用户路径进行反复硬化的阶段。当前历史中,这个月共有 `102` 个提交。 + +配套记录: + +- [仓库历程](../../narratives/repository-history.md) +- [仓库提交历史](../../sources/commits/2026-04-25-repository-commit-history.md) + +## 关键事件 + +### 2026-04-01 至 2026-04-02 + +公开文档面在这两天继续扩大:用户手册更新、双语 VitePress 文档站、简化后的 runtime 指引,以及 Kubernetes 部署指南陆续出现。与此同时,e2e 和 PR 校验流程也被加强。 + +同期,GitHubDaily(4 月 1 日)和 JackCui(4 月 2 日)相继发布微信文章介绍 SkillHub,是最早的一批外部媒体报道。JackCui 的文章从 Claude Code 源码泄露事件切入,深度分析了 Skill 投毒安全风险,将 SkillHub 的审核机制定位为企业级安全管控方案。 + +来源(外部报道): + +- [GitHubDaily:SkillHub,开源了!](../../sources/articles/2026-04-01-githubdaily-skillhub.md) +- [JackCui:SkillHub,开源了!](../../sources/articles/2026-04-02-jackcui-skillhub.md) + +来源: + +- commit `50a6c4b7`:基于真实 API 的 Web e2e 和 PR e2e 工作流 +- commit `3e4a4bc4`:普通用户手册改进 +- commit `12333540`:双语 VitePress 文档站 +- commit `37c25c3f`:简化 runtime 脚本用法 +- commit `c0f79007`:Kubernetes 部署指南 +- [交付路线图](../../../10-delivery-roadmap.md) + +### 2026-04-07 至 2026-04-10 + +项目在这一窗口继续收紧文档、安全、审核、搜索行为和贡献者工作流。同时,issue 分诊自动化和 PR 批量部署支持也在这一阶段出现,说明维护者已经开始为更高吞吐的协作节奏优化仓库。 + +来源: + +- commit `f2b45259`:面向中国开发者的排障指南 +- commit `441dc9e0`:未授权 metrics 与 compat 路径加固 +- commit `739e21e0`:命名空间成员显示用户名 +- commit `66acc6e5`:GitHub 奖励表单、脚本和 actions +- commit `8f694ddc`:issue 分诊自动化 MVP +- commit `689e698b`:PR 批量测试部署工作流 +- commit `3e1b5738`:S3 presigner `forcePathStyle` 修复 +- [PR 批量测试运行时](../../../pr-batch-test-runtime.md) + +### 2026-04-08 + +issue 分诊自动化在这一天被写成了聚焦型设计文档,说明维护者已经把“仓库运作规模化”和“未来 agent 辅助工作流”当成一个明确方向来思考。 + +来源: + +- [Issue 自动化设计](../../../2026-04-08-issue-automation-design.md) + +### 2026-04-12 + +最近一轮提交集中在发布流程和存储修复上,这说明项目正在围绕真实用户路径持续硬化。 + +来源: + +- commit `2def67b0`:将发布前检查放宽为“警告 + 确认”流程 +- commit `348eb4e7`:将 S3 bucket 校验延后到首次访问时 + +### 2026-04-13 至 2026-04-15 + +技能生命周期和审核模型在这几天继续扩展:加入 `UPLOADED` 支持,兼容 `DRAFT`,补充密码重置能力,增强命名空间感知的发布兼容性,并对审核与发布流程进行了多轮稳定化。 + +同期,CoderWanFeng 在 YouTube 发布英文视频介绍 SkillHub(4 月 14 日),是目前已知的首个面向国际受众的英文视频报道。 + +来源(外部报道): + +- [CoderWanFeng YouTube 视频](../../sources/articles/2026-04-14-coderwanfeng-youtube-skillhub.md) + +来源: + +- commit `532d0450`:`UPLOADED` 生命周期支持 +- commit `1184e00a`:命名空间感知的 ClawHub 发布 +- commit `38ebb131`:密码重置和 SMTP 支持 +- commit `b26fe6a3`:预检警告确认流程 +- commit `9801b549`:`SUPER_ADMIN` 平台角色支持 +- commit `3c4c33ad`:匿名访问公开技能详情 + +### 2026-04-17 至 2026-04-24 + +4 月下旬的重点则是发布流程辅助、OAuth 扩展、S3 重试行为、搜索可见性纠正,以及面向更新既有技能的 Dashboard 打磨。 + +来源: + +- commit `5bf87506`:AI 生成发布说明 +- commit `7be6a369`:GitLab OAuth Provider 支持 +- commit `1d0d6be8`:GitLab OAuth 发布配置示例 +- commit `37aa3662`:惰性建桶重试 +- commit `1e9d22b5`:可重试的 S3 上传 body 暂存 +- commit `230b9151`:Dashboard 中”更新技能”按钮与发布预填 +- commit `df85ea0e`:保留空查询下的发现结果 + +### 2026-04 外部报道(日期待确认) + +4 月期间,沉默王二、小林 coding、AI产品阿颖、阿枫科技相继发布微信文章介绍 SkillHub,形成了一波集中的外部媒体报道。其中沉默王二的文章最为详尽,覆盖全流程并附有简历写法建议,文章发布时 GitHub 已达 1.5K Star。 + +来源(外部报道): + +- [沉默王二:科大讯飞官宣开源,有点猛啊](../../sources/articles/2026-04-chenmoer-skillhub.md) +- [小林coding:SkillHub,这个开源神器火了!](../../sources/articles/2026-04-xiaolincoding-skillhub.md) +- [AI产品阿颖:这个神级开源项目,解决了 Skill 的最大痛点。](../../sources/articles/2026-04-aiying-skillhub.md) +- [阿枫科技:科大讯飞开源了个狠东西,Skillhub 真的太实用了!](../../sources/articles/2026-04-afengkeji-skillhub.md) + +## 后续候选工作 + +- 在 `github/prs/` 下补一条覆盖 4 月硬化周期的 PR 时间线 +- 为文档站点上线和 issue 自动化落地建立里程碑文件 +- 把 GitLab OAuth 与密码重置工作接入后续认证叙事 diff --git a/docs/archive/timeline/README.md b/docs/archive/timeline/README.md new file mode 100644 index 00000000..5cc7010d --- /dev/null +++ b/docs/archive/timeline/README.md @@ -0,0 +1,15 @@ +# 时间线 + +时间线是整个档案的时间主骨架。 + +## 规则 + +- 每个月保持一个文件 +- 只记录值得保留的重要事件 +- 每个事件都应至少指向一个来源或现有仓库文档 +- 这里尽量写得简洁,较长的解释留给 `milestones/` 或 `narratives/` + +## 当前覆盖范围 + +- [2026-03](./2026/2026-03.md) +- [2026-04](./2026/2026-04.md)