muse-agent-example/CLAUDE.md

2.5 KiB
Raw Blame History

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/ 内容不得进入上下文。
  • 每次生成后向用户报:依据了什么、产出在哪、伏笔动作;等用户裁决。

语言

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