6.7 KiB
6.7 KiB
公共仓库目录(可扩展)
本页是技能开发用到的公开公共仓唯一登记处,面向技术人员与 AI 编程代理。
- 仓均在公司自建 Gitea:https://git.jc2009.com/(基于开源 Gitea 自建,不是 Gitea 官网)。
- 技术人员一般可直接访问、随时
git clone到本地,用于研究、学习、对照与跟进更新。 - 当前登记 3 项;以后新增公开公共仓时,只在本页按类型加行,不必改散落长文。
深度规范仍在 RPA.md、RUNTIME.md、ADAPTER.md、DEVELOPMENT.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 | 共享 SDK(jiangchang_skill_core 等);技能发布可复用 CI 也在此仓 |
本地常见路径(仅作对照,以你机器为准):
D:\OpenClaw\client-commons\skill-templateD:\OpenClaw\client-commons\account-managerD:\OpenClaw\client-jiangchang\jiangchang-platform-kit
2.1 skill-template
| 项 | 说明 |
|---|---|
| Clone 为了什么 | 读 development/、跟模板版本、用 tools/scaffold_skill 开新技能 |
| 怎么用 | 来源 B:scaffold;或学完后在业务仓开发。规范以本仓为准 |
| 红线 | 不要在模板仓写业务;业务仓 origin 不得指向本仓;不得保留 .openclaw-skill-template |
| 深入 | 本目录 README.md、DEVELOPMENT.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_dir(ensure-web / pick-web) |
| 红线 | 禁止业务技能 import 其内部 rpa_helpers / 散落存密码(见 POLICY-RPA-001);对方文档若写「同进程 rpa_helpers」,以本模板约束为准 |
| 深入 | 对方仓 references/INTEGRATION.md、CLI.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_core(config / logging / activity·SRCP / rpa / sibling_bridge 等)、跟版本、贡献共享 API |
| 怎么用(业务技能) | 运行时由宿主共享 venv 提供;技能内 import jiangchang_skill_core...。SKILL.md 的 platform_kit_min_version 是兼容声明 |
| 红线 | 不要把 jiangchang-platform-kit / playwright 写入技能 requirements.txt;不要在技能仓 vendor jiangchang_skill_core/(POLICY-RUNTIME-002) |
| 深入 | 对方仓 README.md;本模板 RUNTIME.md、LOGGING.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. 以后如何新增一条公共仓(维护约定)
- 确认公开可访问,URL 使用
https://git.jc2009.com/...(勿写 Gitea 官网)。 - 选定或新增 §1 类型。
- 在 §2 登记表加一行;必要时增加
§2.x短节(消费方式 + 红线 + clone 示例)。 - 若改变业务技能硬约束,同步
POLICY_MATRIX.md/ 相关深度文档。 - 不要只在某个业务技能 README 里私藏链接而不登记本页。
6. 相关链接
- 开发入口:
README.md - 运行时:
RUNTIME.md - 网页 RPA / 账号:
RPA.md、ADAPTER.md - 脚手架:
../tools/README.md