Files
skill-template/development/SHARED_REPOS.md
chendelian 8101b5ac01
All checks were successful
技能自动化发布 / release (push) Successful in 11s
docs: add extensible SHARED_REPOS catalog for public commons
2026-07-20 10:30:36 +08:00

6.7 KiB
Raw Blame History

公共仓库目录(可扩展)

本页是技能开发用到的公开公共仓唯一登记处,面向技术人员与 AI 编程代理。

  • 仓均在公司自建 Giteahttps://git.jc2009.com/(基于开源 Gitea 自建,不是 Gitea 官网)。
  • 技术人员一般可直接访问、随时 git clone 到本地,用于研究、学习、对照与跟进更新。
  • 当前登记 3 项;以后新增公开公共仓时,只在本页按类型加行,不必改散落长文。

深度规范仍在 RPA.mdRUNTIME.mdADAPTER.mdDEVELOPMENT.md;本页只做指路 + 边界


1. 类型(可扩展)

类型 id 含义 典型消费方式
skill-template 业务技能作者脚手架与规范源 clone 学习;scaffold / 复制出新业务仓;不要在模板仓写业务
sibling-skill 与业务技能并列安装的公开基础设施技能 clone 学契约;运行时经 CLI / 封装客户端 调用
python-sdk 共享 Python 库(源码仓 + 宿主共享 venv 安装) clone 读实现 / 贡献;运行时 import禁止 vendor 进技能仓
asset-bundle (预留)共享媒体/资源包等 按该仓说明拉取或由 kit/宿主解析
tooling 预留发布脚本、脚手架、CI 辅助等 clone 使用或引用其 workflow

新增类型时:先在本表加一行类型说明,再在 §2 登记表增加实例。


2. 当前登记表

短名 类型 Gitea唯一入口 一句话职责
skill-template skill-template https://git.jc2009.com/client-commons/skill-template 新业务技能的开发模板、目录规范与发布约定
account-manager sibling-skill https://git.jc2009.com/client-commons/account-manager 账号 / 凭据 / 浏览器 Profile / 租约的统一入口
jiangchang-platform-kit python-sdk https://git.jc2009.com/client-jiangchang/jiangchang-platform-kit 共享 SDKjiangchang_skill_core 等);技能发布可复用 CI 也在此仓

本地常见路径(仅作对照,以你机器为准):

  • D:\OpenClaw\client-commons\skill-template
  • D:\OpenClaw\client-commons\account-manager
  • D:\OpenClaw\client-jiangchang\jiangchang-platform-kit

2.1 skill-template

说明
Clone 为了什么 development/、跟模板版本、用 tools/scaffold_skill 开新技能
怎么用 来源 Bscaffold或学完后在业务仓开发。规范以本仓为准
红线 不要在模板仓写业务;业务仓 origin 不得指向本仓;不得保留 .openclaw-skill-template
深入 本目录 README.mdDEVELOPMENT.md
git clone https://git.jc2009.com/client-commons/skill-template.git

2.2 account-manager

说明
Clone 为了什么 读 CLI / references/INTEGRATION.md、平台表、租约与错误码;排 NO_ACCOUNT / LEASE_CONFLICT
怎么用(业务技能) scripts/service/account_client.py(或等价)subprocess 调 CLI;网页 RPA 须先拿到 profile_dirensure-web / pick-web
红线 禁止业务技能 import 其内部 rpa_helpers / 散落存密码(见 POLICY-RPA-001);对方文档若写「同进程 rpa_helpers」以本模板约束为准
深入 对方仓 references/INTEGRATION.mdCLI.md;本模板 RPA.md §0.2、ADAPTER.md
git clone https://git.jc2009.com/client-commons/account-manager.git

2.3 jiangchang-platform-kit

说明
Clone 为了什么 jiangchang_skill_coreconfig / logging / activity·SRCP / rpa / sibling_bridge 等)、跟版本、贡献共享 API
怎么用(业务技能) 运行时由宿主共享 venv 提供;技能内 import jiangchang_skill_core...SKILL.mdplatform_kit_min_version 是兼容声明
红线 不要jiangchang-platform-kit / playwright 写入技能 requirements.txt不要在技能仓 vendor jiangchang_skill_core/POLICY-RUNTIME-002
深入 对方仓 README.md;本模板 RUNTIME.mdLOGGING.md
git clone https://git.jc2009.com/client-jiangchang/jiangchang-platform-kit.git

私有 PyPI 索引(维护/排障用,日常技能开发通常不必手装):
https://git.jc2009.com/api/packages/client-jiangchang/pypi/simple/


3. 三者关系(别当成三个无关收藏夹)

规范 / 脚手架 ──────────► skill-template本仓
                              │
业务技能 scripts/ ──import──► 宿主共享 venv 中的 platform-kit
         │
         └──CLI──► account-manager兄弟技能要先拿到 profile_dir 等)
  • 写规范、开新仓 → 打开 skill-template
  • 少写公共 Python、进度/RPA 原语 → 用 kit(运行靠宿主;源码可 clone
  • 账号与浏览器 Profile → 用 account-manager(运行靠 CLI源码可 clone

4. 何时该打开哪个仓

场景 优先打开
不知道新技能目录/发布/developer_ids 怎么做 skill-template development/
platform_key、ensure-web、租约、凭证存储 account-manager + 本模板 RPA/ADAPTER
emit / finish / @rpa_step / launch_persistent_browser 实现 jiangchang-platform-kit
技能发布 CI / reusable workflow 从哪来 jiangchang-platform-kit .github/workflows/
「公共东西到底在哪」 本页登记表

5. 以后如何新增一条公共仓(维护约定)

  1. 确认公开可访问URL 使用 https://git.jc2009.com/...(勿写 Gitea 官网)。
  2. 选定或新增 §1 类型
  3. 在 §2 登记表加一行;必要时增加 §2.x 短节(消费方式 + 红线 + clone 示例)。
  4. 若改变业务技能硬约束,同步 POLICY_MATRIX.md / 相关深度文档。
  5. 不要只在某个业务技能 README 里私藏链接而不登记本页。

6. 相关链接