SuperAPI AI 工具集

articraft-authoring

通用与其它

查看项目

更新于 10-16 00:21

技能介绍

用途:当用户要求 Codex 创建、编辑、修复、改进、检查或定稿 Articraft 资产或记录时使用本技能。

主要能力与三种编写模式:原生 Articraft 生成,适合需要 Articraft 管理的运行元数据、成本核算、轮次计数或完整智能体轨迹的场景,需要相应提供方 API 密钥;无密钥 Codex 生成,适合不想配置提供方 API 密钥的用户,在 Articraft 内部 harness 中使用 --provider codex-cli,仍由 Articraft 掌控循环、工具、编译反馈、轮次与编译尝试计数、记录持久化和轨迹;外部 Codex 编写,仅在用户明确要求 Codex 在内部 harness 之外手动编辑 model.py 时使用,会创建外部智能体记录且有意不保留 Articraft 内部轨迹。

使用方式:从仓库根目录执行 uv sync --group dev 与 uv run articraft init 完成初始化,可用 --data-dir 或 ARTICRAFT_DATA_DIR 指定数据目录。新建记录可用 uv run articraft generate "<prompt>",无密钥模式加 --provider codex-cli --model <codex-model-id>,图像条件生成再加 --image <reference-image>;外部草稿用 uv run articraft external init --agent codex "<prompt>",命令会输出 record_id 与 record_dir,只编辑该生成记录的活动修订。编辑已有记录应使用 uv run articraft fork <record-id> "<edit request>",不要手动复制记录文件夹。

质量与验证:编写几何前需阅读 agent/prompts/sections/designer_common.md 与 link_naming.md,外部编写前阅读 EXTERNAL_AGENT_DATA.md,并参考 sdk/_docs/ 与 sdk/_examples/。资产应结构连通、无漂浮部件,具有有意义的用户可见关节、语义化链接名称、可见机构与真实材质,并在 run_tests() 中加入针对提示的检查。原生与无密钥 Codex 运行会在生成时调用 compile_model,必要时可用 uv run articraft compile <record-id> 重新编译或检查;外部草稿需反复编译并更新活动 model.py 直至通过。

定稿与限制:外部记录用 uv run articraft external finalize <record-id> 定稿以写入 records_manifest.jsonl,仅在用户要求时加 --category-slug <slug>,并保留 creator.mode=external_agent、creator.agent=codex、creator.trace_available=false。禁止手动创建记录目录、编造记录元数据、复制记录文件夹、写入轨迹或绕过 CLI。其他细节资料未提供。