3.7 KiB
3.7 KiB
开发资料入口
本目录面向人类开发者与 AI 编程代理。技术人员与编程 AI 以本目录为主读路径；references/ 是 CLI / Action / Schema 契约细节，根目录市场四 Tab 面向最终用户。
新技能全流程（先看这张表）
按顺序做；细节与约束见 DEVELOPMENT.md 对应章节（不替代下文深度规范，只作导航）。
| 步骤 | 做什么 | 详见 |
|---|---|---|
| 1 | 拿到仓库：① 项目经理在 自建 Gitea（git.jc2009.com，非 Gitea 官网）开仓并授权后 git clone；或 ② 本地已有 skill-template 时用 scaffold / 复制出新目录（遵守 Git 红线） |
DEVELOPMENT.md §1、§4 |
| 2 | 按 NAMING.md 确认 slug；先填 REQUIREMENTS.md，再写业务代码 |
REQUIREMENTS.md、NAMING.md |
| 3 | 替换标识与占位，按四象限 / examples 实现 scripts/service/ |
DEVELOPMENT.md §4～§14 |
| 4 | 配置 developer_ids（开发自测必做）：开发期技能在匠厂默认不公开；不加则开发者自己也装测不了。从宿主设置复制用户 ID 写入 SKILL.md |
DEVELOPMENT.md §6「关于 developer_ids」 |
| 5 | 本地 python tests/run_tests.py -v 通过后执行 release.ps1；看 Gitea CI |
DEVELOPMENT.md §15 |
| 6 | 匠厂安装后，按 actions.json 已声明的全部入口自测（新建任务、数据管理含 toolbar/row/batch、定时任务、任务中心、技能详情等） |
DEVELOPMENT.md §15；SKILL_ACTION_RUNTIME.md |
脚手架与 Git 防串库：../tools/README.md（scaffold_skill.ps1）。业务仓也可直接从自建 Gitea clone，见 DEVELOPMENT.md §4 来源 A。
公开公共仓（可 clone 学习，可扩展登记）： SHARED_REPOS.md — 当前含 skill-template、account-manager、jiangchang-platform-kit。
深度规范阅读顺序
开始定制 skill 前，建议按以下顺序阅读：
SHARED_REPOS.md— 公共仓库目录（模板 / 账号管理 / platform-kit 等，可扩展）REQUIREMENTS.md— 需求文档模板与验收标准NAMING.md— slug / 仓库名命名规范（复制模板前必读）DEVELOPMENT.md— 完整开发步骤与目录规范TESTING.md— 测试分层、隔离数据根与档位开关LOGGING.md— 日志分层、必打节点、敏感信息红线（涉及长任务、RPA、外部系统时必读）ADAPTER.md— 涉及外部系统对接时RPA.md— 涉及浏览器 / 桌面 / 手机自动化时CONFIG.md—.env规范与 bootstrap 机制DATA_PATHS.md— 下载/导入/导出等本地文件路径标准（涉及文件读写时必读）SKILL_ACTION_RUNTIME.md— Skill Action sync/async、任务中心、Agent 禁令、队列 pick（涉及 RPA / 长任务 / 数据管理按钮 / Cron / Agent 时必读）RUNTIME.md— 共享 runtime、数据路径、发布打包与编码约定
Agent 调用契约见 ../references/CLI.md、../references/SCHEMA.md、../references/ACTIONS.md。
用户市场四 Tab 见根目录 README.md / TUTORIAL.md / DEMO.md / CHANGELOG.md，不要写进本目录。