Imported from BaSui01/AI-Novel-Agent-Studio (AGENTS.md). Install upstream with npx skills add BaSui01/AI-Novel-Agent-Studio. Copyright stays with the author.

Trellis Instructions

These instructions are for AI assistants working in this project.

This project is managed by Trellis. The working knowledge you need lives under .trellis/:

.trellis/workflow.md — development phases, when to create tasks, skill routing
.trellis/spec/ — package- and layer-scoped coding guidelines (read before writing code in a given layer)
.trellis/workspace/ — per-developer journals and session traces
.trellis/tasks/ — active and archived tasks (PRDs, research, jsonl context)

If a Trellis command is available on your platform (e.g. /trellis:finish-work, /trellis:continue), prefer it over manual steps. Not every platform exposes every command.

If you're using Codex or another agent-capable tool, additional project-scoped helpers may live in:

.agents/skills/ — reusable Trellis skills
.codex/agents/ — optional custom subagents

Managed by Trellis. Edits outside this block are preserved; edits inside may be overwritten by a future trellis update.

Snow CLI × Trellis（项目侧说明，非托管块）

本段写在  之外，不会被 trellis update 覆盖。全局人格见 ~/.snow/ROLE-*.md（system 侧）；本文件 AGENTS.md 是项目工作区规则（contextInject 注入）。

身份分层

文件	位置	层级	用途
ROLE	`~/.snow/ROLE-*.md`	system / 全局	Snow 人格与硬规则，与 Trellis 无关
AGENTS.md	项目根	项目 / contextInject	工作区规则；Trellis 只托管 START…END 块
`.snow/SNOW.md`	项目 `.snow/`	项目文档	class-1 宿主行为、工具表、会话身份

本仓库 Snow 适配清单（现代路径，无 legacy JSON）

Agents：.snow/agents/*.md 自动发现（trellis-implement / trellis-check / trellis-research）
Skills：.snow/skills/trellis-*/SKILL.md
Hooks：.snow/hooks/ → onSessionStart / onUserMessage / beforeSubAgentStart（class-1 上下文注入，脚本 write-trellis-context.py；onStop 已随 0.6.11 移除）
Commands：.snow/commands/trellis-*.json（/trellis-continue、/trellis-commit、/trellis-finish-work、/trellis-finish…）
开关：.snow/settings.json 中 contextInject.enabled: true
会话自动提交：.trellis/config.yaml → session_auto_commit: false（.trellis/ .snow/ .agent/ .agents/ .codex/ 已整体 gitignore 本地化，脚本不触碰 git；journal / archive 仍写磁盘）
禁止：不要再使用 / 重建 sub-agents.trellis.json 类 legacy merge 文件

主会话派发约定

派发 implement/check/research 时，prompt 第一行写：

Active task: <path from task.py current>

implement/check 子 agent 禁止 git commit / push / merge。

提交分层（Snow）

产品代码：主会话在质量门通过后自动按逻辑分批提交（product_auto_commit: true，不 push）；仅提交明确属于当前任务的文件，归属不明时停止确认
任务归档 / journal：产品提交成功后自动执行 /trellis-finish-work（task_auto_archive: true）；session_auto_commit: false 下脚本仅写磁盘归档与 journal，不执行 git stage/commit
噪音路径（log / pycache / workspace 临时文件）已 gitignore，勿 stage

调试注入：SNOW_DEBUG_HOOKS=1，查看 .snow/log/hooks-inject.txt 与 .snow/log/trellis-context.txt。

Context7 文档查询规则

涉及第三方库或 API 的文档、代码生成、安装、升级、配置与兼容性问题时，优先使用全局 ctx7 CLI 获取最新且版本匹配的官方资料，不依赖模型记忆猜测接口。
先运行 ctx7 library <name> "<具体问题>" 解析 Context7 library ID；再运行 ctx7 docs <libraryId> "<具体问题>" 查询文档。已知准确 library ID 时可直接执行第二步。
查询中应包含项目实际使用的版本、运行环境和目标行为；实现前以返回的签名、示例和迁移说明为准，并与仓库锁文件及现有代码交叉验证。
ctx7 未登录、限流、无匹配库或执行失败时，明确说明失败原因，随后回退到该库的官方文档或仓库源码；不得静默改用非官方教程作为权威依据。
不自动运行 ctx7 setup、ctx7 login，也不写入或回显 Context7 API Key，除非用户明确授权。