方法
一条记录是如何写成、校验并保持更新的
《AI 实操手册》收录的是流程，不是提示词。提示词最多是某一步里的一行；让结果可信的，是围绕它的那一整套信息。
信息模型
- 最终产出
- 做完之后你手上有什么。如果一句话说不清，这条记录就太宽泛了。
- 适用场景 / 不适用场景
- 适配性判断。不适用场景是必填项，因为知道一种方法什么时候不该用，本身就是方法的一部分。
- 开始之前
- 前提条件：你需要先拿到的数据、访问权限、审批以及要对接的人。
- 步骤与检查点
- 三到九步。每一步结尾都有一个检查点，确认通过后再继续。
- 适用环境
- 标注完全支持或部分支持的环境，并附一句说明。没有列出的环境表示未做测试。
- 耗时
- 准备耗时（一次性）与每次运行的耗时，单位为分钟。数值来自复核者的实际运行，是估计值而不是承诺。
- 可能出问题的地方
- 安全说明，每条标注风险类型：准确性、隐私、安全、成本、权利或对人的影响。
- 复核记录
- 状态、版本、上次复核日期与修订记录。是否待复核由目录日期计算得出。
复核状态
- 已复核
- 在记录的复核日期，步骤被完整重跑过一遍。
- 需复核
- 已发布，但它依赖的东西变化很快；依赖它之前请重跑一遍。
- 草稿
- 未发布。草稿会通过校验，但不会进入站点。
如果上次复核距目录日期已超过 180 天，这条记录就会被标记为待复核（目录日期为 2026年3月1日，是固定的演示日期）。这个判断由构建过程计算，没有人手工设置，也从不读取访问者的系统时间。
环境
环境指的是工具的种类，而不是具体品牌，这样即使产品换代，条目也不会失真。
- 对话助手 （对话）
- 模型 API 与脚本 （API）
- 仓库中的编码智能体 （智能体）
- 电子表格 （表格）
- 本机运行的本地模型 （本地）
- 无代码自动化 （自动化）
这里的“演示”是什么意思
本次构建中的每条记录都带 "demo": true，缺少这个字段的条目会被构建直接拒绝。这些流程是认真写的，也力求站得住，但它们的目的是验证格式：它们不是一份完整目录，没有获得任何厂商背书，其中的复核日期与版本历史都是示例记录，而不是真实的编辑日志。示例一律使用虚构输入。
新增一条记录
- 先建一份草稿：
python3 tools/new_skill.py my-skill-id "技能的标题"。它会生成data/skills/my-skill-id.json，自动分配下一个可用编号，状态为draft。 - 把每个字段都填上。运行
python3 build.py --check，它会列出每个问题所在的文件和字段。 - 自己把步骤从头到尾跑一遍。然后把状态改为
reviewed，补上reviewed_on和一条修订记录。 - 发布之前运行
python3 build.py和python3 tools/audit.py。
现在能做到什么，还差什么
本次构建已经具备
- 按任务、难度、环境与领域检索筛选，条件保存在页面地址里。
- 每条记录、每个任务都有独立页面，关闭 JavaScript 也能用。
- 校验会拒绝不完整或前后不一致的条目。
- 已发布目录的 JSON 导出位于 api/skills.json。
需要静态构建之外的能力
- 由署名复核者完成的真实编辑复核，复核日期要经得起核查。
- 读者反馈某一步是否真的有效，这需要后端和一次隐私评估。
- 按工具版本维护的条目，这需要持续维护的兼容性数据源。