开发资料入口
本目录面向人类开发者与 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 | 先读宿主产品入口：对话 / 数据管理 / 定时任务平级；何时走哪个；为本技能填入口定位表 | PRODUCT_SURFACES.md |
| 2b | 用户市场文档：说明 Tab ≠ 教程 Tab；教程按三入口写；与 §0.1 / actions 对齐 | TUTORIAL_SURFACES.md |
| 3 | 先读 AI + RPA 总纲；界面技能先完成元素拾取/element map，再按浏览器、桌面或手机读分端手册 | AI_RPA.md、RPA_ELEMENT_LOCATING.md |
| 4 | 按 NAMING.md 确认 slug；先填 REQUIREMENTS.md（含入口定位表），再写业务代码 |
REQUIREMENTS.md、NAMING.md |
| 5 | 替换标识与占位，按四象限 / examples 实现 scripts/service/ |
DEVELOPMENT.md §4～§14 |
| 6 | 配置 developer_ids（开发自测必做）：开发期技能在匠厂默认不公开；不加则开发者自己也装测不了。从宿主设置复制用户 ID 写入 SKILL.md |
DEVELOPMENT.md §6「关于 developer_ids」 |
| 7 | 本地单测（mock）通过后，按业务默认 real_rpa 真实跑通；再 release.ps1；看 Gitea CI。mock 通 ≠ 完成 |
ADAPTER.md；DEVELOPMENT.md §15 |
| 8 | 匠厂安装后，按入口定位表已挂的入口自测，并看用户体验（进度、失败提示、有头 RPA 等） | DEVELOPMENT.md §15；PRODUCT_SURFACES.md；SKILL_ACTION_RUNTIME.md |
| 9 | 交活验收（第三方）：对照 CHECKLIST.md 验收；报告写入仓库根目录 acceptance-reports/ |
CHECKLIST.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 前，建议按以下顺序阅读：
PRODUCT_SURFACES.md— 宿主产品入口：对话 / 数据管理 / 定时任务平级；何时走哪个；入口定位表 1b.TUTORIAL_SURFACES.md— 用户说明 / 教程契约：README≠TUTORIAL；三入口结构；skill-detail 不可作主路径AI_RPA.md— AI Agent + RPA 总纲：职责边界、合规红线、风控、操作节奏与完整闭环ACCOUNT_MANAGER.md— 浏览器账号标准：一账号一 Profile、租约、多账号、数据查看、验收与排障SHARED_REPOS.md— 公共仓库目录（模板 / 账号管理 / platform-kit 等，可扩展）REQUIREMENTS.md— 需求文档模板与验收标准（含入口定位表）NAMING.md— slug / 仓库名命名规范（复制模板前必读）DEVELOPMENT.md— 完整开发步骤与目录规范TESTING.md— 测试分层、隔离数据根与档位开关LOGGING.md— 日志分层、必打节点、敏感信息红线（涉及长任务、RPA、外部系统时必读）ADAPTER.md— 涉及外部系统对接时RPA.md— 涉及浏览器 / 桌面 / 手机自动化时的会话、风控和工程总纲RPA_ELEMENT_LOCATING.md— 所有界面技能必读：真实拾取、element map、唯一性、降级和 AI 编程约束- 按执行端选读：
RPA_BROWSER.md/RPA_DESKTOP.md/RPA_MOBILE.md CONFIG.md—.env规范与 bootstrap 机制DATA_PATHS.md— 下载/导入/导出等本地文件路径标准（涉及文件读写时必读）SKILL_ACTION_RUNTIME.md— Skill Action sync/async、任务中心、Agent 禁令、队列 pick（涉及 RPA / 长任务 / 数据管理按钮 / Cron / Agent 时必读）RUNTIME.md— 共享 runtime、数据路径、发布打包与编码约定CHECKLIST.md— 交活验收清单（第三方视角）；报告输出到../acceptance-reports/
Agent 调用契约见 ../references/CLI.md、../references/SCHEMA.md、../references/ACTIONS.md。
用户市场四 Tab 见根目录 README.md / TUTORIAL.md / DEMO.md / CHANGELOG.md，不要写进本目录。