AGENTS.md git:20261028.84c2258A

Immutable. This exact content never changes and is served at /api/v1/blob/6ac25947142ba471.

# 项目级 Agent 规则 · AI-Short-Drama-Studio

> 本文件是项目级注入（每会话自动进入）：只管「本项目特有信息 + 承载指针」，通用义务不复述（单一权威=注入核心）。由工作流「项目承载检查」创建（2026-10-12）。

## 回指（强制字段）
- 完整纪律（判级/红线/必问/开工四步/GATE/检索端口）权威=注入核心与 SKILL.md；按需以 Skill 工具加载「shisan-xinuo-workflow」（注册名），本文件在场但 Skill 未在场 → 先加载再继续。
- 会话末：更新 `memory/agent-log.md`（流水区+状态段）后离开——不更新=交接断链。

## 迷你流程骨架（注入核心缺席时的最小执行序）
- 开工四步：复述 → 承载检查 → 记忆对齐（读 agent-log 状态段一屏）→ 判级（L1 直做 / L2 记录做 / L3 先问）。
- 每轮首产物=复述（新任务全量三行；追加/继续一行）；状态行 `Context: state=… L=… confirm=…`。
- 收尾：GATE 单行 12 字段；agent-log 流水一行+状态段刷新。
- 红线三条：密钥绝不落盘｜重大改动先回滚点｜不假实现（未验证显式标注）。

## 项目纪律（本项目特有）
- **仓库定位**：公开技能仓库——发布物=技能本体（`SKILL.md` / `references/` / `scripts/` / `README.md` / `LICENSE`）；`memory/` 为本地承载（已从版本控制排除），`docs/` 为开发导航。
- **版本与提交**：版本号以 `SKILL.md` front-matter `version` 为准（历史变更记 `SKILL.md` 的「更新记录」节，不再单独维护 CHANGELOG 文件）；提交遵守仓库惯例 `<类型>(<范围>):〈动词开头描述〉`（如 `feat(skill): v1.6.0 …`，类型前缀跟随历史 feat/fix/docs/refactor/chore）；push=对外发布（L3，须用户确认）。
- **验证基线**：改动技能后跑二十脚本自检 `python scripts/validate_storyboard.py --selftest`（另十九件 check_refs/init_project/make_grid/archive_old_docx/sync_entity/check_double_root/check_seams/fix_table_pagination/style_code_blocks/qa_batch/manifest/trim_clips/concat_clips/gen_script/check_scene_plates/gen_scene_sheet/lint_prompt/studio/short_plan 同法）全过再提交；`make_grid.py` 需 Pillow，`check_seams.py` 需 numpy/Pillow（实景抽帧另需 ffmpeg，无则跳过），`style_code_blocks.py` 需 python-docx。CI（`.github/workflows/selftest.yml`）在 push 时自动跑同样二十件 + `examples/demo-multi-ep/` 端到端回归（qa_batch/trim_clips/concat_clips 在无 ffmpeg 环境自动跳过实拍部分）。
- **技能实体同步面**：本工作区=开发源；本机技能实体 `<SKILL_ROOT>/ai-short-drama-studio` 为静态复制（非 git）。发版后同步用 `python scripts/sync_entity.py <实体目录>` 一键完成——自动备份（回滚点落本机备份目录，可用 `--backup-dir` 指定）→ 差异扫描 → 同步 → md5 复核；`--dry-run` 预演。排除项=承载与仓库级资产（AGENTS.md/docs/memory/.github/examples/.git/__pycache__，列表维护在脚本顶部 EXCLUDE 常量），不入实体。已于 2026-10-21 同步至 v1.16.0（v1.14.0 → v1.16.0，技能面 35 件 md5 全等、双根全硬链；新增 scene-plates 文档与 check_scene_plates/gen_scene_sheet/style_code_blocks 三脚本，manifest/qa_batch 增 scene_state，sync_entity 修复子目录缓存排除）。本机为双根部署（`.zcode` 与 `.agents` 两处，硬链同源）。双根场景下，sync_entity 对新增文件会在两侧各自复制而断链——同步后跑 `python scripts/check_double_root.py <左根> <右根> --fix` 补齐（只修内容相同非硬链；内容不一致只报告）。
- **v2.0.0 工作室化重构（2026-10-27）**：骨架由「三路线」改为「五工位流水线」，新增 `references/studio-workflow.md` 与 `scripts/studio.py`（init/status/check/board）；视觉规格留档 `docs/design-specs/studio-board.md`。
- **v2.1.0 双形态（2026-10-27）**：新增短视频形态（`studio.py init --form short`）、`scripts/short_plan.py` 口播时长预算机检、`references/short-video-studio.md` 短片工艺；通用机制四条（单镜 1.5s 下限 / 否定配正向清单 / 追问四失效防御 / 发布包装属交付）进铁律，两种形态共用。实体已同步至 v2.0.0，v2.1.0 **待同步**。
- 权威源顺序：注入核心 → shisan-xinuo-workflow SKILL.md → 本文件 → `docs/project-info.md`。

## 项目承载（已就绪）
- `memory/agent-log.md`：一档制四区（状态段/教训区/偏好段/流水区；本地留档，不入库）。
- `docs/project-info.md`：六节索引（模块表带关键词锚定列，细则 #275）。