开发资料入口

本目录面向人类开发者与 AI 编程代理。技术人员与编程 AI 以本目录为主读路径；references/ 是 CLI / Action / Schema 契约细节，根目录市场四 Tab 面向最终用户。

新技能全流程（先看这张表）

按顺序做；细节与约束见 DEVELOPMENT.md 对应章节（不替代下文深度规范，只作导航）。

| 步骤 | 做什么 | 详见 |

|------|--------|------|

| 1 | 拿到仓库：① 项目经理在 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 | 匠厂技能市场安装后，按声明测：新建任务(Agent) / 数据管理 / 定时任务 / 任务中心(async) | DEVELOPMENT.md §15；契约见 SKILL_ACTION_RUNTIME.md |

脚手架与 Git 防串库：../tools/README.md（scaffold_skill.ps1）。

开始定制 skill 前，建议按以下顺序阅读：

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、数据路径、发布打包与编码约定

用户市场四 Tab 见根目录 README.md / TUTORIAL.md / DEMO.md / CHANGELOG.md，不要写进本目录。