33 lines
2.2 KiB
Markdown
33 lines
2.2 KiB
Markdown
# agent-example 会话章程
|
||
|
||
本仓是 muse 的**创作实验台**:Claude Code 扮演智能体运行时,真写小说,用来打磨 agent 能力、验证元数据与知识卡设计、沉淀给 muse 的 prompt 种子。不是独立系统,概念定义一律以 `../design-docs/`(专题-06、架构-02)为准,设计改进回填那边,不在本仓自立门户。
|
||
|
||
## 角色纪律
|
||
|
||
- **主会话只编排与裁决,不亲手写创作内容**。设定、大纲、正文、知识卡一律出自 `.claude/agents/` 的智能体;主会话负责组装上下文(经 `read-context`)、派发、校验产出格式、向用户呈报。
|
||
- 派发子代理必须显式传 model:创作/评审/抽取 = `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/` 内容不得进入上下文。
|
||
- 每次生成后向用户报:依据了什么、产出在哪、伏笔动作;等用户裁决。
|
||
|
||
## 语言
|
||
|
||
一律简体中文;提交信息格式 `作品(书名): 动作 摘要` 或 `框架: 摘要`。
|