| English | 中文 |
本页是新增和修订技能的编写清单。执行注册与宿主发现另见注册规范。编写说明不授权数据访问、下载、模型运行、安装或发布。
按任务职责和适用阶段确定归属目录。采用 skills/<category>/<stage>/<capability>/：类别表示操作类型，阶段与方法库的 01–04 或 shared 一致。优先采用指定的主阶段；无明确主阶段的通用能力放共享目录，其他阶段通过引用使用，不复制。每个技能围绕一个清晰任务，避免在不同目录重复维护同一流程；编写前先阅读相关技能和方法。
通用编写规范不列举具体模型、框架或技术类别，也不将其作为目录规则。具体名称、依赖与调用示例放在对应技能及分类导航中。
第二步仅在已明确声明且经审查的清单能力内提供具体合成输入及计算代码。标明合成数值与单位、实际脚本/适配器状态，并验证支持的计算；其他概念条目仍不可执行，新增导航不授权真实数据访问、批量执行或工具注册。
英文入口使用 SKILL.md，中文使用 SKILL_ZH.md。其他文档保留默认文件名作为英文版，中文增加 _ZH.md。两版顶部各有一组相互切换链接；内容、能力状态、示例、日期和边界同步维护，不在段落或表格中逐句混写。
工具编号、命令、旗标、配置键、数据字段、路径、来源标识和专名保持原样。用于匹配的中文原始表头属于来源字面值，不能当正文翻译。解释性注释可翻译，但不能改变执行行为。
宿主正常发现只使用默认 SKILL.md；中文版不是第二个技能或工具。存在同语言参考时优先链接，否则保留真实参考，不虚构译本。本轮入口整理不包含历史长篇参考资料。
文件头必须包含稳定的 name 与针对任务的 description。新名称使用英文小写字母、数字和连字符，不含私人信息。既有公开编号保留，需变更时明确迁移，不静默重命名。
新建或实质修订的操作入口同时声明 metadata.version 和 compatibility，分别表示技能语义版本与支持的运行或宿主条件。两版保持稳定名称、版本和兼容条件一致。不为满足新检查器而给全部历史入口补填字段或重命名仓库目录。目录路径与公开标识可以不同；分发时保留明确映射并包含必要资源。宿主安装仍是独立动作。
正文组织应讲清以下内容：
| 内容 | 必须说明 |
|---|---|
| 用途与触发 | 解决什么任务，何时改用相关流程 |
| 当前能力 | 已实现适配器、人工流程、模板或参考，以及已有真实工具编号 |
| 输入输出 | 格式、逻辑路径、单位、时空范围、字段及映射 |
| 前置条件 | 依赖、版本、登录权限与人工准备 |
| 操作流程 | 选择、准备、调用、检查和交接步骤 |
| 失败与停止条件 | 依赖或权限错误、任务状态不明、部分输出及安全重试检查 |
| 代理边界 | 授权范围、读写联网副作用、凭据分离及原件保护 |
| 验证与证据 | 已测内容、日期版本、合成与真实检查区别，以及未验证项 |
不把整份手册复制进入口。条件性操作细节放参考资料，通用科学解释放方法库。
项目、methods 和 skills 的顶层 README 介绍稳定的研究步骤、覆盖范围和阅读入口。具体能力清单与对应关系由分类导航、methods/index.yaml 和工具注册表维护，避免在这些总览 README 重复列出易变的工具、数量或就绪状态表。
让最短可用路径能够操作：提供完整配置示例或字段映射、真实命令或 API 调用，以及预期结果与检查。环境设置和详细选项统一放在链接的操作参考中。人工或模板能力说明实际软件操作和适配字段，不为补齐示例编造包装器；仅概念入口只描述选择与交接，不添加代码。Methods 按研究问题、来源或测量含义、方法选择、不确定性及解释展开，运行说明归技能。
| 资源 | 用途 |
|---|---|
SKILL.md / SKILL_ZH.md |
任务选择、流程和行为边界 |
methods/ |
科学方法、来源、误差、规范化与质量规则的唯一正文 |
技能 references/ |
工具接口、操作步骤与验证示例 |
scripts/ |
已审查的确定性实现 |
templates/ |
需要适配的代码，未实现前不作为执行器入口 |
examples/ |
合成或通用任务参数，不含私人路径或秘密 |
agents/openai.yaml |
可选宿主展示信息，不是执行注册 |
数据来源需说明原生产者与实际提供者、产品身份、版本、覆盖、单位、时间语义、缺失、质量规则及有日期的原始依据。唯一正文放方法库，由技能链接。真实获取示例记录带时区的实际操作时间，不给未执行步骤填写时间。
| 对象 | 登记来源 | 登记证明什么 |
|---|---|---|
| 技能 | 默认文件头及宿主支持的发现位置 | 可发现的指导，仍需实机核对 |
| 宿主展示 | agents/openai.yaml |
展示字段，不完成登录或创建函数 |
| 数据集 | 确有声明需要时的 datasets.yaml |
数据目录信息，不证明获取成功 |
| 工具 | catalog/tools/*.yaml |
工具元数据及声明的执行支持 |
| 方法映射 | methods/index.yaml |
步骤、技能和工具的文档关联，不授予执行权限 |
参考技能可以没有数据集或工具编号，不为展示虚构它们。可执行工具还需要审查执行器策略与适配器，并提供有效合成测试；仅加声明不能执行任意代码。已实现适配器使用真实编号及统一执行入口，保留注册规范中的历史标识差异。
仓库外三个已存在根目录相互独立：AIRMOSAIC_ASSETS_DIR 存数据结果，AIRMOSAIC_CONFIG_DIR 存非秘密设置，AIRMOSAIC_AUTH_DIR 存浏览器状态。凭据留在秘密管理器，或由明确授权的官方客户端使用本人已有凭据机制，不读取、复制或暴露秘密。模型发行包留在仓库外，新结果使用独立任务目录。
说明维护只用接口和合成输入，不读取既有原始数据。共享文档、示例和日志不得包含用户名、密码、密钥、会话、私人主机、机器专用绝对路径、签名链接或个人任务引用。明确参考流程没有落实的运行保护；行为说明不是操作系统隔离。
用限定范围的静态检查器核对所选入口的元数据、标识、本地引用及支持的脚本语法，再用有效合成测试验证修改行为。具体命令和支持的元数据格式归操作入口维护。静态检查不执行被检查资源，解析成功不等于操作或科学验证。明确说明不支持的资源类型及未验证的依赖状态。根据既往任务证据维护技能时遵循改进契约，产出的技能仍以本编写规范为权威。
通用科学设计放在 methods/shared/，通用数据与技能组合放在 workflows/，经审查的执行操作放在技能中。叙述和定义都不等于已发现技能或已实现引擎，见目录说明。
| 要回答的问题 | 归属 | 内容与边界 |
|---|---|---|
| 为什么选这个方法？ | methods/ |
科学定义、变量角色、假设、识别条件、质量标准及解释限制 |
| 计算机如何执行一项有边界的操作？ | skills/ |
输入输出契约、依赖、参数、审查过的脚本、调用、失败与检查 |
| 如何组合数据和已有技能？ | workflows/ |
通用顺序、分支选择、交接字段、DAG 设计环节和可执行或人工状态；引用技能代码，不复制实现 |
| 围绕什么科学问题开展哪些实验？ | projects/ |
假设、固定数据引用、比较组、验收证据与人工复核 |
同一主题可以跨层互相引用，但权威内容只维护一处：科学假设放方法，执行行为放技能，组合交接放工作流，研究选择放项目。以 DAG 为例：方法解释识别条件，技能检查声明的图，工作流把设计放到估计之前，项目记录本问题采用的图和估计目标。未实现执行引擎时，工作流 YAML 只是说明，不因命名而注册执行。通用演示结果属于支持该操作的技能中经过审查、被忽略的结果目录；研究结果属于外部项目根，内部布局遵循适配器契约自选。
目录对应是研究阶段与能力职责的对应，不要求文件逐个同名，也不要求将框架、方法与通用任务合并成一个技能。方法库保持科学解释；真实技能路径、编号与工具关系在方法映射和工具声明中维护。
配置模板统一在 config/examples/，通用科学设计在 methods/shared/，数据与技能组合在 workflows/，具体案例与实验依据在对应 projects/<number_topic>/。方法库只保留阶段目录、共享方法及必要索引，不另设配置示例或平行路径目录。