6fe3fd0a10
Claude Code 只发现 .claude/skills/ 的直接子目录，不支持分类二级目录； 磁盘保持平铺，分类只在 _index.md 维护。 - _index.md 重写：47 个 skill 按创作生命周期分 9 域，条目形式为 skill [中文注释]；取消 craft 标签与"运行时 vs 方法论参照"二分， novel-diagnosis 等归入检测评分域；新增跨阶段取用表 - AGENTS.md：合同责任方表由 32 个补齐至 47 个，参照 Skill 以 ° 标记； 命名规则与 11.2 审查问题按两类分别限定适用范围；统一旧术语 - 07-Agent与Skill领域：合同九项、命名、Tool 合同与验收条件按实现性质 限定，补掉取消 craft 豁免后"每个 Skill 输入产出都落库"字面覆盖 纯文本 skill 的漏洞 - humanization/README：删除失联的 skills/write-human-text 整节，真包 已在父仓技能库；同时清除三个未被跟踪的空目录 - README：.claude/skills 描述指向 _index.md，去掉已迁出的离线测试 两类的判据是产不产生系统事实，不是有没有 scripts/：plan-chapter、 expand-scene、polish-prose、rewrite-selection、optimize-content-quality 自身不带 Tool 但产生落库事实，仍是系统能力 Skill。 Co-authored-by: Cursor <cursoragent@cursor.com>
71 lines
3.5 KiB
Markdown
71 lines
3.5 KiB
Markdown
# agent-example
|
||
|
||
`agent-example` 的目标是成为 Muse 的单用户缩小版，以 PostgreSQL 为正式内容权威：ReAct Agent 通过角色 Agent、Skill 和确定性工具，完成长篇小说的作品管理、实体维护、范式复用、规划、写作、审核、用户决策和经验复利。代码与文档在 Git，正式内容在数据库。
|
||
|
||
本项目不包含管理员、多用户、租户、市场、计费和资产交易。完整 Muse 产品、业务和总体架构仍以父仓 [`../design-docs/`](../design-docs/) 为准。
|
||
|
||
## 数据权威
|
||
|
||
核心合同是：
|
||
|
||
```text
|
||
PostgreSQL（muse-example 库） = 正式内容权威（作品 / 章 / 正文 / 实体 / 范式 / 用户决策 / 运行回执 / raw）
|
||
Git = 代码 / Skill / 文档 / DDL 的权威，并可对作品信息与作品文本留痕（历史 / 备份）
|
||
库内向量索引 = 数据库一侧的检索加速，可从库重建
|
||
```
|
||
|
||
正式内容以库为准；Git 留痕不是权威，只读看板只读库，两者冲突时以库为准。可恢复性靠数据库备份，加上 Git 里的代码与 DDL 重建库结构。一切输入和产出都必须落库才能被看板看见。
|
||
|
||
## 三条正交轴
|
||
|
||
```text
|
||
内容：作品 + 实体 + 范式
|
||
流程：上下文组装 -> 创作 -> 质量审核 -> 用户决策 -> 复利
|
||
能力：Agent + Skill + Tool + 数据库存储 + 只读看板
|
||
```
|
||
|
||
领域边界、数据权威和验收合同见 [`.agent/docs/architecture/domains/_index.md`](.agent/docs/architecture/domains/_index.md)。该目录定义目标行为，不代表所有落库写入和只读看板已经完成实现。
|
||
|
||
## 当前工程入口
|
||
|
||
```text
|
||
agent-example/
|
||
├── AGENTS.md # 项目工作入口与规则
|
||
├── CLAUDE.md # 只引用 AGENTS.md 的兼容入口
|
||
├── .agent/ # 跨任务长期知识与领域设计 SoT
|
||
├── .claude/agents/ # 角色 Agent
|
||
├── .claude/skills/ # Skill 合同与确定性工具（分类索引见 _index.md）
|
||
├── meta/schemas/ # 结构本体与本地字段合同
|
||
├── meta/chains/ # 功能链、场景、用途和角色槽位
|
||
├── knowledge/ # 现有参考资产
|
||
├── db/ # PostgreSQL（正式内容权威）的 DDL 与资料
|
||
└── docs/ # 单次任务资料、评测样张和历史执行证据
|
||
```
|
||
|
||
正式内容在 PostgreSQL，不在 `content/` 文件目录。判断有没有某个内容，以库里能不能查到为准；不得把库外文件或临时快照说成正式内容。
|
||
|
||
## 正向创作
|
||
|
||
```text
|
||
用户意图
|
||
-> 读取作品、实体和范式
|
||
-> 冻结角色上下文
|
||
-> 规划/写作 Agent 产生 Shadow 候选
|
||
-> 确定性检查、语义检测和质量审核
|
||
-> 用户原样接受、修改后合并或丢弃
|
||
-> 正式正文（写入库内正文块）
|
||
-> 实体草稿、范式观察和复利验证
|
||
```
|
||
|
||
Gate A/B 是开发期离线能力验收，不是正常用户写一章的生产主流程。评测候选固定不可进入 Canonical。
|
||
|
||
## SoT 顺序
|
||
|
||
1. 父仓 `design-docs/`：完整 Muse 产品、业务和总体架构。
|
||
2. 本仓 `.agent/docs/architecture/domains/`：单用户、数据库为权威的领域边界。
|
||
3. `meta/`：结构本体和功能链登记。
|
||
4. `.claude/agents/` 与 `.claude/skills/`：角色和可执行能力合同。
|
||
5. `docs/`：单次任务过程、评测资料与执行证据，不覆盖稳定 SoT。
|
||
|
||
所有任务从 [`AGENTS.md`](AGENTS.md) 开始。
|