muse-agent-example/CLAUDE.md

agent-example 会话章程

本仓是 muse 的创作实验台：Claude Code 扮演智能体运行时，真写小说，用来打磨 agent 能力、验证元数据与知识卡设计、沉淀给 muse 的 prompt 种子。不是独立系统，概念定义一律以 ../design-docs/（专题-06、架构-02）为准，设计改进回填那边，不在本仓自立门户。

角色纪律

• 主会话只编排与裁决，不亲手写创作内容。设定、大纲、正文、知识卡一律出自 .claude/agents/ 的智能体；主会话负责组装上下文（经 read-context）、派发、校验产出格式、向用户呈报。
• 派发子代理必须显式传 model：创作/评审 = opus，纯机械活 = haiku。
• 清洗与拆书的内容生产 LLM 全部走 New-API MiniMax-M3（创始人 2026-07-13 拍板）：经 llm skill 统一入口调用，主会话只固化提示词/skill 与发起调用，不派 opus/haiku 子代理做这两类内容生产。

双轨纪律（本仓的命根子）

• 智能体产出一律落入工作区，不提交。git status/git diff 就是待审层。
• 确认 = commit，且只能由用户指令触发，走 confirm 工具；丢弃 = restore。主会话与智能体都无权自行 commit 创作内容。
• works/*/评审/ 是运行噪音，已被 .gitignore 挡住，永不入历史。
• 框架文件（agents/skills/meta/README）的改动属维护，可正常提交，但不得与创作内容混在同一个 commit。

开工读序

1. README.md（本仓定位与流程）
2. meta/schemas/README.md（两轴、控制项、实例落点表）
3. 目标作品的 装配.yaml（槽位与知识绑定）与 状态.md（写到哪了）

生成纪律

• 所有 API/工具能力一律封装为 skill（.claude/skills/）：数据库、嵌入、检索、导入、确认、组装全走 skill，主会话与智能体不得裸调外部服务（PG/New-API）或散写一次性工具脚本。skill 形态 = SKILL.md + scripts/*.py 封装（uv .venv + requirements.txt，通用依赖优先）。能力清单见 README §四。
• 组装上下文只走 read-context，按 schema 的 aiContext 裁剪；智能体不得自行翻仓库找上下文。
• 未在 装配.yaml 绑定的 knowledge/ 内容不得进入上下文。
• 每次生成后向用户报：依据了什么、产出在哪、伏笔动作；等用户裁决。

语言

一律简体中文；提交信息格式 作品(书名): 动作 摘要 或 框架: 摘要。

呈报纪律（创始人 2026-07-13 纠正后固化）

• 每次向创始人汇报，第一句先回答「你现在需要做什么」（哪怕是"不需要做任何事"）。
• 内部代号（S1/P2/门①）与英文行话（scaffold/embedding/pass）不得裸用——要么不用，要么当场白话展开。
• 一句话只说一件事；汇报量以 30 秒读完为度，细节留仓库文档给路径。
• 技术机制用白话说清因果，不用黑话压缩（反例：「合同漂移致守卫冤杀」；正例：「提示词教 AI 的字段名和数据库校验的字段名不一致，AI 交对了卡也被判错」）。