# 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 交对了卡也被判错」）。