框架: skill 分类改为按创作生命周期分域,取消 craft 二分
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>
This commit is contained in:
parent
95a2cac65a
commit
6fe3fd0a10
@ -21,7 +21,9 @@ Agent 与 Skill 领域拥有角色职责、可调用能力合同、确定性工
|
||||
|
||||
## 3. Skill 合同
|
||||
|
||||
每个 `.claude/skills/{name}/SKILL.md` 必须声明:
|
||||
Skill 按实现性质分两类,合同要求不同。**系统能力 Skill** 执行动作并产生落库的系统事实,须声明下列全部九项;自带 `scripts/` 不是判据——以模型判断为主的 Skill 可以不带 Tool,落库由它调用的 Skill 的 `scripts/` 承担。**参照 Skill** 不执行动作、不产生系统事实,也不进 `meta/chains` 登记,只声明第 1、3 项并写明取用边界与不适用场景,第 2、4 至 9 项不适用。两类都是正式 skill,都可在创作生命周期内被角色取用,分类见 `.claude/skills/_index.md`。
|
||||
|
||||
每个系统能力 Skill 的 `.claude/skills/{name}/SKILL.md` 必须声明:
|
||||
|
||||
1. 唯一目的和消费者。
|
||||
2. 输入、输出及 schema/version。
|
||||
@ -33,19 +35,20 @@ Agent 与 Skill 领域拥有角色职责、可调用能力合同、确定性工
|
||||
8. raw、授权、预算和审计边界。
|
||||
9. 开发验证与行为评测由 `harness/manifests/` 登记;`SKILL.md` 不承载测试命令、测试文件路径或测试结论。Skill 运行时需要执行的业务 dry-run/评测操作仍属于运行合同。
|
||||
|
||||
数据库是权威:Skill 对自己读写哪些表负责,声明失败时如何关闭,并确保经手的输入和产出都落库。没落库的输入产出,在系统视角里等于不存在。只读看板只查库渲染,不替 Skill 写任何数据。
|
||||
数据库是权威:系统能力 Skill 对自己读写哪些表负责,声明失败时如何关闭,并确保经手的输入和产出都落库。没落库的输入产出,在系统视角里等于不存在。只读看板只查库渲染,不替 Skill 写任何数据。参照 Skill 不读写库,也不产生需要落库的输入产出。
|
||||
|
||||
### 3.1 命名与稳定标识
|
||||
|
||||
- Skill 名统一使用小写 `动作-对象`,直接说明调用者能执行什么;目录名必须与 frontmatter `name` 完全一致。
|
||||
- 目录名必须与 frontmatter `name` 完全一致,两类 Skill 同样适用。
|
||||
- 系统能力 Skill 名统一使用小写 `动作-对象`,直接说明调用者能执行什么;参照 Skill 名使用小写领域名,说明它讲哪一块方法,不伪装成可执行动作。
|
||||
- 名称不使用 `db`、`llm`、`runtime`、`eval` 这类内部模块缩写,也不使用 `upgrade`、`planning` 这类无法判断具体动作的阶段词。
|
||||
- scenario 与 Skill 名分离:`continuation`、`fine_outline` 等 scenario 由 `meta/chains` 显式映射到动作式 Skill 名,不能假设两者同名。
|
||||
- scenario 与 Skill 名分离:`continuation`、`fine_outline` 等 scenario 由 `meta/chains` 显式映射到动作式 Skill 名,不能假设两者同名;参照 Skill 不进链登记,没有对应 scenario。
|
||||
- 数据库 `source_type`、creator/updater、错误码和备份逻辑键是历史兼容标识;Skill 改名不自动改写这些值。
|
||||
- 一个名称只对应一个目录和一份 `SKILL.md`;改名后不留旧目录、别名 Skill 或重复合同。
|
||||
|
||||
## 4. Tool 合同
|
||||
|
||||
- Tool 放在所属 Skill 的 `scripts/`,不散落一次性脚本。
|
||||
- Tool 放在所属 Skill 的 `scripts/`,不散落一次性脚本;参照 Skill 的 `scripts/` 只放工作表与清单文本,不含 Tool。
|
||||
- 默认从仓库任意工作目录调用,必须自行解析项目根和输入绝对路径,不能依赖调用者先 `cd` 到特定目录。
|
||||
- 机械事实必须结构化输出稳定状态和错误码;人读日志是补充,不是唯一接口。
|
||||
- Tool 不调用模型,除非所属 Skill 明确声明该步骤本质需要模型。
|
||||
@ -86,9 +89,9 @@ ReAct Agent 不能把“扫全库、随意写表”当作通用工具。每次
|
||||
## 8. 验收条件
|
||||
|
||||
1. 一个 Skill 只有一个明确业务目的。
|
||||
2. Skill 目录名与 frontmatter `name` 一致,名称符合 `动作-对象`,scenario 通过链登记映射。
|
||||
3. 每个 Skill 在 SKILL.md 声明数据库读写合同(读哪些表、写哪些表、失败如何关闭)。
|
||||
4. 每个 Skill 的输入与产出都落库,只读看板能查到对应记录。
|
||||
2. Skill 目录名与 frontmatter `name` 一致;系统能力 Skill 名符合 `动作-对象` 且 scenario 通过链登记映射,参照 Skill 用领域名、不进链登记。
|
||||
3. 每个系统能力 Skill 在 SKILL.md 声明数据库读写合同(读哪些表、写哪些表、失败如何关闭)。
|
||||
4. 每个系统能力 Skill 的输入与产出都落库,只读看板能查到对应记录。
|
||||
5. Tool 从不同当前目录调用得到一致结果。
|
||||
6. 角色 Prompt 只声明职责边界(说清不做什么),不包含 adapter、hash、状态机等支架职责。
|
||||
7. 稳定经验能沿“范式 -> Skill/Tool/Agent”升格且不产生重复规则。
|
||||
|
||||
@ -1,85 +1,120 @@
|
||||
# .claude/skills 总目录
|
||||
# .claude/skills 分类总索引
|
||||
|
||||
本目录同时承载两类 skill,请按标签区分:
|
||||
Claude Code 只发现 `.claude/skills/` 的**直接子目录**(目录名 = 调用名),不支持分类二级目录;所以磁盘保持平铺,**分类只在本索引维护**。
|
||||
|
||||
- **【运行时】**:绑定 scenario,由 [`../meta/chains`](../meta/chains) 登记;任务派发时由 `assemble-context` 调用
|
||||
- **【方法论参照】**:craft 试用区,从 7 本写作书蒸馏出的 15 个综合 skill,供 writer 角色和创作环节按需取用。**不落库、无数据库合同、不进 `meta/chains`**
|
||||
本索引按**作品创作生命周期**分域,共 47 个 skill。每个 skill 归它主用的阶段;跨阶段取用见文末。实现性质(有无 `scripts/`、是否落库、是否进 `meta/chains` 登记、是否有 `tests/skills/` 回归)是另一条垂直轴,不在本索引组织,见 [`AGENTS.md`](../../AGENTS.md) 第 3 节与 [`meta/chains/`](../../meta/chains/)。
|
||||
|
||||
craft 15 个综合 skill 的分类、合并与裁剪权威为 [`../craft/MERGE_PLAN.md`](../craft/MERGE_PLAN.md),维护门禁见 [`../craft/scripts/check_craft_skills.py`](../craft/scripts/check_craft_skills.py)。原料层(94 个源单元)保留在 [`../craft/books/`](../craft/books/)。
|
||||
新增、删除或改名 skill 必须同步本索引;涉及合同责任方或链路登记的还须同步 `AGENTS.md` 第 3 节领域表与 `meta/chains/`。
|
||||
|
||||
---
|
||||
|
||||
## 运行时技能(绑链,33 个)
|
||||
## 0 平台底座
|
||||
|
||||
| Skill | 用途 |
|
||||
|---|---|
|
||||
| access-database | 通过唯一受控入口查询或修改 muse-example PostgreSQL,并应用可审计 DDL。主会话或 Skill 需要通用数据库访问时使用;专用导入、嵌入和检索仍走各自 Skill。 |
|
||||
| assemble-context | 按冻结点从 PostgreSQL 读取可信来源,组装可审计上下文,并为 writer、detector、judge、planner 或 extractor 生成最小投影。 |
|
||||
| call-content-model | 通过 New-API 的统一治理入口调用内容模型,执行额度窗口、模型降级、重试和 JSON 提取。 |
|
||||
| capture-ai-flavor-cases | 从已有作品或创作反馈中抽取可复核的 AI 味案例卡,保留来源哈希与位置并产出规则候选。 |
|
||||
| check-content-consistency | 检查正文或细纲候选的结构、事实、角色状态、能力代价、伏笔和证据缺口;只产检测报告。 |
|
||||
| clean-book-text | 识别并删除参考书或旧稿中的广告、水印、作者拉票和乱码噪声,同时保留逐段审计;不改写正文。 |
|
||||
| decide-candidate | 根据用户明确指令接受、合并或丢弃 Shadow 候选,并以受控事务更新 Canonical。 |
|
||||
| deconstruct-book | 从完整存量作品逆向拆出章节细纲、阶段大纲、实体线索和脱敏写作范式。 |
|
||||
| design-story-foundation | 在正式规划前固化作品根设定,按固定三级章节树生成可比较的前期设计候选。 |
|
||||
| diagnose-ai-flavor | 对目标正文跑 active 规则库,产出带精确片段与证据的发现清单,检测完成自动落库;只查不改。 |
|
||||
| embed-knowledge | 使用固定 Qwen3 嵌入模型将知识草稿或实体批量写入 pgvector,并按内容哈希幂等处理。 |
|
||||
| establish-voice-baseline | 作品建立或新角色登场时,把已确认正文与作者样张产出的声音账做结构校验后版本化落库。 |
|
||||
| evaluate-frozen-replay | 将参考作品冻结到 as_of 章号,编排细纲或正文的隔离回放,并生成可审计的逐样本结果。 |
|
||||
| execute-claude-task | 以冻结执行配置在 fresh 沙箱子进程中调用 Claude CLI,并校验模型、期限与结构化输出。 |
|
||||
| expand-scene | 在既有场景内补充动作链、对话潜台词、感官细节和环境互动。 |
|
||||
| extract-chapter-knowledge | 从已接受章节抽取实体、关系、事件和叙事状态草稿,并提出既有知识更新。 |
|
||||
| extract-work-knowledge | 将已完成拆解的作品正文按窗口抽取为 upgrade_book 实体、关系与演变草稿。 |
|
||||
| freeze-context | 将截至指定章号的来源冻结为可重复清单,并校验授权、版本、未来信息泄漏和只读原文装载。 |
|
||||
| import-book | 将参考书或用户旧稿 txt 确定性分章并写入作品、章节、正文 block 和来源档案。 |
|
||||
| maintain-work-extraction | 维护既有 upgrade_book 抽取状态,包括七域备份验证与恢复、全量重抽前重置、失败窗口恢复。 |
|
||||
| optimize-content-quality | 根据独立评分锁定最低质量维度,以单变量方式调整 prompt、上下文或设定并有限重生成。 |
|
||||
| plan-chapter | 根据已确认规划、叙事状态和冻结事实生成下一章结构细纲草稿。 |
|
||||
| plan-story | 按正式 schema 生成或修订作品设定包、大纲、知识卡、状态和装配草稿。 |
|
||||
| polish-prose | 修正候选或既有正文的错字、语病、AI 味、节奏和角色声音;不改变情节事实与场景结构。 |
|
||||
| prevent-ai-flavor | 生成前组装写作上下文合同——active 规则的负约束(附反例)加声音账的正样例与保护项。 |
|
||||
| record-run-evidence | 记录模型调用、运行登记、不可变回执、CAS revision 和受控 raw 证据。 |
|
||||
| review-knowledge-cards | 以三种编辑视角审核公共知识卡的成立性、创作可用性和跨书复用性,并写回 pass、revise 或 reject。 |
|
||||
| revise-ai-flavor | 在诊断产物与作者同意之上执行最小 patch,过硬门、复扫与成对选择校验;没诊断不启动。 |
|
||||
| rewrite-selection | 按用户意见重写指定段落或场景,并校验范围、事实锚和版本;范围外原文不动。 |
|
||||
| score-content-quality | 按独立 rubric 评分在线正文、正文回放或细纲回放,并产生逐维证据和 Gate 裁决输入。 |
|
||||
| search-knowledge | 将创作意图嵌入后从 pgvector 召回知识,并按绑定、状态和 aiContext 权限裁剪结果。 |
|
||||
| write-next-chapter | 按已确认细纲、冻结事实和动态篇幅合同生成下一整章候选;不自行检索、不把候选直接写入 Canonical。 |
|
||||
贯穿全周期的运行支撑,不属于单一创作阶段。
|
||||
|
||||
- [access-database](access-database/SKILL.md) [唯一受控数据库入口:查询、修改 muse-example PostgreSQL,应用可审计 DDL;专用导入、嵌入、检索仍走各自 skill]
|
||||
- [call-content-model](call-content-model/SKILL.md) [内容模型统一治理入口:额度窗口、模型降级、重试与 JSON 提取]
|
||||
- [execute-claude-task](execute-claude-task/SKILL.md) [以冻结执行配置在 fresh 沙箱子进程调用 Claude CLI,校验模型、期限与结构化输出]
|
||||
- [record-run-evidence](record-run-evidence/SKILL.md) [记录模型调用、运行登记、不可变回执、CAS revision 与受控 raw 证据]
|
||||
|
||||
## 1 素材导入与拆解
|
||||
|
||||
把外部作品与用户旧稿变成库内素材、实体线索与脱敏范式。
|
||||
|
||||
- [import-book](import-book/SKILL.md) [参考书或旧稿 txt 确定性分章,写入作品、章节、正文 block 与来源档案]
|
||||
- [clean-book-text](clean-book-text/SKILL.md) [删除广告、水印、作者拉票与乱码噪声并保留逐段审计;不改写正文]
|
||||
- [deconstruct-book](deconstruct-book/SKILL.md) [从完整存量作品逆向拆出章节细纲、阶段大纲、实体线索与脱敏写作范式]
|
||||
- [extract-work-knowledge](extract-work-knowledge/SKILL.md) [已拆解作品正文按窗口抽取为 upgrade_book 实体、关系与演变草稿]
|
||||
- [maintain-work-extraction](maintain-work-extraction/SKILL.md) [维护既有抽取状态:七域备份验证与恢复、全量重抽前重置、失败窗口恢复]
|
||||
|
||||
## 2 知识与上下文供给
|
||||
|
||||
沉淀、检索、冻结并组装可信上下文,是所有生成与检查的事实来源。
|
||||
|
||||
- [embed-knowledge](embed-knowledge/SKILL.md) [固定 Qwen3 嵌入模型将知识草稿或实体批量写入 pgvector,按内容哈希幂等]
|
||||
- [search-knowledge](search-knowledge/SKILL.md) [创作意图嵌入后从 pgvector 召回知识,按绑定、状态与 aiContext 权限裁剪]
|
||||
- [freeze-context](freeze-context/SKILL.md) [按指定章号把来源冻结为可重复清单,校验授权、版本、未来信息泄漏与只读原文装载]
|
||||
- [assemble-context](assemble-context/SKILL.md) [按冻结点组装可审计上下文,为 writer、detector、judge、planner、extractor 生成最小投影]
|
||||
- [extract-chapter-knowledge](extract-chapter-knowledge/SKILL.md) [从已接受章节抽取实体、关系、事件与叙事状态草稿,并提出既有知识更新]
|
||||
- [review-knowledge-cards](review-knowledge-cards/SKILL.md) [以三种编辑视角审核公共知识卡的成立性、创作可用性与跨书复用性,写回 pass/revise/reject]
|
||||
|
||||
## 3 概念与前期设计
|
||||
|
||||
动笔前把点子变成能撑长篇的概念,并固化作品根设定。
|
||||
|
||||
- [concept-design](concept-design/SKILL.md) [把模糊点子升级为能撑长篇的疑问式概念:升级、四问校验、找角度、真实素材交付策略]
|
||||
- [design-story-foundation](design-story-foundation/SKILL.md) [固化作品根设定,按固定三级章节树生成可比较的前期设计候选]
|
||||
|
||||
## 4 结构与规划
|
||||
|
||||
搭骨架、排里程碑、布伏笔与动力,产出大纲与章级细纲。
|
||||
|
||||
- [plan-story](plan-story/SKILL.md) [按正式 schema 生成或修订作品设定包、大纲、知识卡、状态与装配草稿]
|
||||
- [plan-chapter](plan-chapter/SKILL.md) [据已确认规划、叙事状态与冻结事实生成下一章结构细纲草稿]
|
||||
- [story-structure](story-structure/SKILL.md) [按体裁选尺子,搭"四箱+六里程碑"骨架,把开头、启动、转折、加码放对位置]
|
||||
- [story-planning](story-planning/SKILL.md) [把"找故事"挪到动笔前,用廉价的规划稿替换昂贵的重写]
|
||||
- [narrative-momentum](narrative-momentum/SKILL.md) [读者翻页的三个来源:势(不可逆推力链)、金币(沿途小奖励)、钩子(断点未解问题)]
|
||||
- [foreshadow-payoff](foreshadow-payoff/SKILL.md) [伏笔全链路:登记埋设 → 自然生长 → 兑现与高潮]
|
||||
- [story-ending](story-ending/SKILL.md) [结尾回答两问:终局在哪(倒推回响)、终局给读者什么(关起来还是打开)]
|
||||
|
||||
## 5 正文写作与呈现
|
||||
|
||||
生成、扩写、重写与润色正文,以及决定读者怎么看见人物、场景和声音。
|
||||
|
||||
- [write-next-chapter](write-next-chapter/SKILL.md) [按已确认细纲、冻结事实与动态篇幅合同生成整章候选;不自行检索、不直写 Canonical]
|
||||
- [expand-scene](expand-scene/SKILL.md) [在既有场景内补充动作链、对话潜台词、感官细节与环境互动]
|
||||
- [rewrite-selection](rewrite-selection/SKILL.md) [按用户意见重写指定段落或场景,校验范围、事实锚与版本;范围外原文不动]
|
||||
- [polish-prose](polish-prose/SKILL.md) [修正错字、语病、AI 味、节奏与角色声音;不改变情节事实与场景结构]
|
||||
- [scene-craft](scene-craft/SKILL.md) [场景六问:干什么、给多少篇幅、从哪进哪出、镜头多远、细节怎么选、转场怎么不着痕]
|
||||
- [dialogue-craft](dialogue-craft/SKILL.md) [对话是事件不是装饰:该不该用、每段派任务、让人物自己暴露、水下留白]
|
||||
- [character-design](character-design/SKILL.md) [人物五动作:7 变量建人、三层立体、内在恶魔驱动、扁平与圆形定形、原型打底]
|
||||
- [character-presentation](character-presentation/SKILL.md) [让人物被读者自己看见:不宣告、细节装配、内在可见、关系网、性格碰撞、反常瞬间、自己的声音]
|
||||
- [show-and-omission](show-and-omission/SKILL.md) [不把结论递给读者,给能自己得出结论的材料;写出来的是抓手,没写的是分量]
|
||||
- [narration-pov](narration-pov/SKILL.md) [用谁的眼睛看(视角)、站什么立场讲(立场)、讲的过程怎么走(张力与模式)]
|
||||
- [prose-craft](prose-craft/SKILL.md) [语言的可诊断可调节旋钮:节奏、密度、温度、情感出口、抽象层级、风格杠杆]
|
||||
- [theme-and-stance](theme-and-stance/SKILL.md) [主题让读者自己看出来;立场不先行、命运执行不手软、沉重题材用幽默作结构]
|
||||
|
||||
## 6 检测、评分与诊断
|
||||
|
||||
对细纲与正文候选做检查、评分、体检和回放评测,产出裁决输入。
|
||||
|
||||
- [check-content-consistency](check-content-consistency/SKILL.md) [检查结构、事实、角色状态、能力代价、伏笔与证据缺口;只产检测报告]
|
||||
- [score-content-quality](score-content-quality/SKILL.md) [按独立 rubric 评分在线正文、正文回放或细纲回放,产出逐维证据与 Gate 裁决输入]
|
||||
- [optimize-content-quality](optimize-content-quality/SKILL.md) [据独立评分锁定最低质量维度,单变量调整 prompt、上下文或设定并有限重生成]
|
||||
- [evaluate-frozen-replay](evaluate-frozen-replay/SKILL.md) [把参考作品冻结到 as_of 章号,编排细纲或正文的隔离回放,生成可审计逐样本结果]
|
||||
- [novel-diagnosis](novel-diagnosis/SKILL.md) [整体体检三段:维度框架定位 → 五透镜查病灶 → 评审纪律清理结论]
|
||||
|
||||
## 7 去 AI 味与人感
|
||||
|
||||
生成前立约束、生成后查与改,并维护声音账与案例库。
|
||||
|
||||
- [prevent-ai-flavor](prevent-ai-flavor/SKILL.md) [生成前组装写作上下文合同:active 规则负约束(附反例)加声音账正样例与保护项]
|
||||
- [diagnose-ai-flavor](diagnose-ai-flavor/SKILL.md) [跑 active 规则库产出带精确片段与证据的发现清单,检测完成自动落库;只查不改]
|
||||
- [revise-ai-flavor](revise-ai-flavor/SKILL.md) [在诊断产物与作者同意之上执行最小 patch,过硬门、复扫与成对选择校验;没诊断不启动]
|
||||
- [establish-voice-baseline](establish-voice-baseline/SKILL.md) [把已确认正文与作者样张产出的声音账做结构校验后版本化落库]
|
||||
- [capture-ai-flavor-cases](capture-ai-flavor-cases/SKILL.md) [从已有作品或创作反馈抽取可复核 AI 味案例卡,保留来源哈希与位置并产出规则候选]
|
||||
|
||||
## 8 候选主权与落库
|
||||
|
||||
用户决策后把候选变成正式事实,是 Shadow → Canonical 的唯一闸口。
|
||||
|
||||
- [decide-candidate](decide-candidate/SKILL.md) [据用户明确指令接受、合并或丢弃 Shadow 候选,以受控事务更新 Canonical]
|
||||
|
||||
---
|
||||
|
||||
## 方法论参照(craft,15 个)
|
||||
## 跨阶段取用
|
||||
|
||||
### 按领域
|
||||
以下 skill 的主用阶段之外还被其它阶段取用,取用时以本表为准,不改归属:
|
||||
|
||||
| 领域 | Skill | 一句话定位 |
|
||||
|------|-------|-----------|
|
||||
| 概念与前提 | [concept-design](concept-design/SKILL.md) | 把模糊点子变成能撑长篇的疑问式概念:升级、四问校验、找角度、真实素材交付策略 |
|
||||
| 结构与里程碑 | [story-structure](story-structure/SKILL.md) | 先按体裁选尺子,再搭"四箱+六里程碑"骨架,把开头/启动/转折/加码放对位置 |
|
||||
| 动力与钩子 | [narrative-momentum](narrative-momentum/SKILL.md) | 读者翻页的三个来源:势(不可逆推力链)、金币(沿途小奖励)、钩子(断点未解问题) |
|
||||
| 结尾 | [story-ending](story-ending/SKILL.md) | 结尾回答两问:终局在哪(工程:倒推回响),终局给读者什么(姿态:关起来还是打开) |
|
||||
| 伏笔与回收 | [foreshadow-payoff](foreshadow-payoff/SKILL.md) | 伏笔全链路:登记埋设 → 自然生长 → 兑现/高潮 |
|
||||
| 人物设计 | [character-design](character-design/SKILL.md) | 五个动作:建(7变量)、立体(三层)、驱动(内在恶魔)、定形(扁平/圆形)、打底(原型) |
|
||||
| 人物呈现 | [character-presentation](character-presentation/SKILL.md) | 让人物被读者自己看见:不宣告、细节装配、内在可见、关系网、性格碰撞、反常瞬间、自己的声音 |
|
||||
| 场景执行 | [scene-craft](scene-craft/SKILL.md) | 场景六问:干什么、给多少篇幅、从哪进哪出、镜头多远、细节怎么选、转场怎么不着痕 |
|
||||
| 展示与留白 | [show-and-omission](show-and-omission/SKILL.md) | 不把结论递给读者,给读者能自己得出结论的材料;写出来的是抓手,没写的是分量 |
|
||||
| 对话 | [dialogue-craft](dialogue-craft/SKILL.md) | 对话是事件不是装饰:该不该用、每段派任务、让人物自己暴露、水下留白 |
|
||||
| 叙述与视角 | [narration-pov](narration-pov/SKILL.md) | 三件事:用谁的眼睛看(视角)、站什么立场讲(立场)、讲的过程怎么走(张力与模式) |
|
||||
| 主题与立场 | [theme-and-stance](theme-and-stance/SKILL.md) | 主题是读者自己看出来的,不是作者说的;立场不先行,命运执行不手软,沉重题材用幽默作结构 |
|
||||
| 语言与修辞 | [prose-craft](prose-craft/SKILL.md) | 语言的可诊断可调节旋钮:节奏、密度、温度、情感出口、抽象层级、风格杠杆 |
|
||||
| 规划工作流 | [story-planning](story-planning/SKILL.md) | 把"找故事"挪到动笔前,用廉价的规划稿替换昂贵的重写 |
|
||||
| 作品诊断 | [novel-diagnosis](novel-diagnosis/SKILL.md) | 整体体检三段:维度框架定位 → 五透镜查病灶 → 评审纪律清理结论 |
|
||||
|
||||
### 按创作环节取用
|
||||
|
||||
对应本仓创作链(环节合同见上"运行时技能"):
|
||||
|
||||
| 创作环节 | 首选 | 辅助 |
|
||||
|----------|------|------|
|
||||
| 前期设计(design-story-foundation) | concept-design | story-structure(体裁尺子) |
|
||||
| 规划/大纲(plan-story) | story-structure, story-planning | foreshadow-payoff(伏笔台账), narrative-momentum(金币布点) |
|
||||
| 章级细纲(plan-chapter) | scene-craft(场景任务), narrative-momentum(章末钩子) | foreshadow-payoff(埋设/回收位) |
|
||||
| 正文写作(write-next-chapter, expand-scene) | scene-craft, dialogue-craft, character-presentation | show-and-omission, narration-pov, prose-craft |
|
||||
| 润色(polish-prose) | prose-craft | show-and-omission, dialogue-craft |
|
||||
| 审查/评分(score-content-quality, judge) | novel-diagnosis | theme-and-stance(说教检查), character-design(人物体检), story-structure(位置校验) |
|
||||
| 去 AI 味(prevent/diagnose/revise-ai-flavor 家族) | prose-craft(温度与克制), show-and-omission | character-presentation(动作呈现) |
|
||||
| skill | 主用阶段 | 还被取用于 |
|
||||
|---|---|---|
|
||||
| scene-craft | 5 正文写作与呈现 | 4 结构与规划(章级细纲派场景任务) |
|
||||
| narrative-momentum | 4 结构与规划 | 5 正文写作与呈现(章末钩子) |
|
||||
| foreshadow-payoff | 4 结构与规划 | 5 正文写作与呈现(埋设与回收位) |
|
||||
| story-structure | 4 结构与规划 | 3 概念与前期设计(体裁尺子)、6 检测评分(位置校验) |
|
||||
| prose-craft | 5 正文写作与呈现 | 7 去 AI 味(温度与克制) |
|
||||
| show-and-omission | 5 正文写作与呈现 | 7 去 AI 味(不递结论) |
|
||||
| character-presentation | 5 正文写作与呈现 | 7 去 AI 味(动作呈现) |
|
||||
| character-design | 5 正文写作与呈现 | 6 检测评分(人物体检) |
|
||||
| theme-and-stance | 5 正文写作与呈现 | 6 检测评分(说教检查) |
|
||||
| novel-diagnosis | 6 检测评分与诊断 | 5 正文写作与呈现(写前定位病灶) |
|
||||
|
||||
31
AGENTS.md
31
AGENTS.md
@ -23,8 +23,8 @@ SoT 按主题分域,不做跨主题的全局排序。可执行脚本与书面
|
||||
| [`.agent/docs/architecture/domains/`](.agent/docs/architecture/domains/_index.md) | 本仓领域边界、数据权威、落库合同和领域协作的 SoT。 |
|
||||
| [`meta/schemas/`](meta/schemas/) | 23 型结构本体的字段合同;库内 payload 结构以该合同为准。 |
|
||||
| [`meta/chains/`](meta/chains/) | scenario、purpose、功能 skill、角色槽位和保护节点的链路登记。 |
|
||||
| [`.claude/skills/`](.claude/skills/) | 每个 `SKILL.md` 定义项目运行时能力的输入、输出、红线、数据库读写合同和输入产出落库;同目录 `scripts/` 是运行时确定性实现与机械门,开发验证和行为评测入口由 `harness/manifests/` 登记。 |
|
||||
| [`tests/skills/`](tests/skills/) | 项目运行时 Skill 的实现测试、集成测试和 fake pipeline 测试;它们提供回归证据,不拥有运行时合同,也不等同于 Skill 行为评测。 |
|
||||
| [`.claude/skills/`](.claude/skills/) | 每个 `SKILL.md` 定义项目运行时能力的输入、输出、红线、数据库读写合同和输入产出落库;同目录 `scripts/` 是运行时确定性实现与机械门,开发验证和行为评测入口由 `harness/manifests/` 登记。全量 skill 的分类索引是 [`.claude/skills/_index.md`](.claude/skills/_index.md)(磁盘平铺,分类只在索引维护)。 |
|
||||
| [`tests/skills/`](tests/skills/) | 系统能力 Skill 的实现测试、集成测试和 fake pipeline 测试;它们提供回归证据,不拥有运行合同,也不等同于 Skill 行为评测。参照 Skill 不在此回归。 |
|
||||
| [`.agent/`](.agent/_index.md) | 跨任务长期知识;领域设计位于 `docs/architecture/domains/`,新增、删除或重命名必须同步各级 `_index.md`。 |
|
||||
| [`docs/`](docs/) | 单次任务探索、计划、评测资料、样张和历史执行证据;任务完成后把稳定结论蒸馏到 `.agent/`,不得长期拥有领域定义。 |
|
||||
| [`README.md`](README.md) | 项目背景和历史路线概览。目录、阶段、技能数量和存储方式等描述可能陈旧,不得覆盖本文件、`meta/`、skill 或磁盘事实。 |
|
||||
@ -48,9 +48,8 @@ agent-example/
|
||||
│ ├── 表映射.md
|
||||
│ └── 连接信息.md
|
||||
├── humanization/ # 去 AI 味 Skill 能力域(运行时规则/样例以数据库为权威;YAML 为迁移种子/离线夹具)
|
||||
├── craft/ # 小说写作方法论能力域(试用区):原料 books/ + SoT(MERGE_PLAN.md / README.md / scripts/);综合 skill 落在 .claude/skills/
|
||||
├── harness/ # 项目验证与外部评测索引、清单和调度支架
|
||||
├── tests/ # 运行时 Skill 实现测试(按 Skill 归档)
|
||||
├── tests/ # 系统能力 Skill 实现测试(按 Skill 归档)
|
||||
├── knowledge/ # 仓内参考资产;未经绑定、授权不得进入上下文
|
||||
├── docs/ # 设计、评测、样张与历史执行记录
|
||||
├── .venv/ # 本地 Python 运行环境
|
||||
@ -61,23 +60,29 @@ agent-example/
|
||||
|
||||
5 个角色:`writer`、`planner`、`extractor`、`detector`、`judge`。角色身份在 `.claude/agents/*.md`,具体功能合同不复制进角色文件。
|
||||
|
||||
### Skill 领域索引(项目运行时 Skill)
|
||||
### Skill 合同责任方索引
|
||||
|
||||
实际清单以 `.claude/skills/*/SKILL.md` 为准;本表维护合同责任方、协作领域和领域 SoT,不复制各 Skill 的完整合同。每个运行时 Skill 必须登记一个合同责任方(业务领域或平台领域),但可以同时消费或影响多个协作领域;跨域调用、场景关系和保护节点在 `meta/chains/` 登记。合同责任方表示谁维护该 Skill 的稳定能力合同,不表示 Skill 只能属于一个业务领域。
|
||||
实际清单以 `.claude/skills/*/SKILL.md` 为准。全量分类索引(47 个 skill,按作品创作生命周期分 9 域,每条带中文注释)见 [`.claude/skills/_index.md`](.claude/skills/_index.md):Claude Code 只发现 `.claude/skills/` 的直接子目录,磁盘保持平铺,分类只在该索引维护;skill 增删改名必须同步该索引。
|
||||
|
||||
| 合同责任方 / 能力域 | 领域 SoT | 运行时 Skill |
|
||||
本表是另一条轴:登记每个 skill 的合同责任方、协作领域和领域 SoT,不复制各 Skill 的完整合同。每个 skill 必须登记一个合同责任方(业务领域或平台领域),但可以同时消费或影响多个协作领域;跨域调用、场景关系和保护节点在 `meta/chains/` 登记。合同责任方表示谁维护该 Skill 的稳定能力合同,不表示 Skill 只能属于一个业务领域。
|
||||
|
||||
| 合同责任方 / 能力域 | 领域 SoT | Skill |
|
||||
|---|---|---|
|
||||
| 平台运行与证据 | 07-Agent 与 Skill、08-数据权威与可视化 | `access-database`、`call-content-model`、`execute-claude-task`、`record-run-evidence` |
|
||||
| 上下文与知识检索 | 02-实体、04-上下文、08-数据权威与可视化 | `assemble-context`、`embed-knowledge`、`freeze-context`、`search-knowledge` |
|
||||
| 导入、清洗与抽取 | 02-实体、05-创作流程 | `clean-book-text`、`deconstruct-book`、`extract-chapter-knowledge`、`extract-work-knowledge`、`import-book`、`maintain-work-extraction`、`review-knowledge-cards` |
|
||||
| 规划与作品基础 | 05-创作流程 | `design-story-foundation`、`plan-chapter`、`plan-story` |
|
||||
| 写作与候选主权 | 01-作品、05-创作流程 | `decide-candidate`、`expand-scene`、`polish-prose`、`rewrite-selection`、`write-next-chapter` |
|
||||
| 质量与回放评测 | 06-质量与复利、05-创作流程 | `check-content-consistency`、`evaluate-frozen-replay`、`optimize-content-quality`、`score-content-quality` |
|
||||
| 规划与作品基础 | 05-创作流程 | `design-story-foundation`、`plan-chapter`、`plan-story`、`concept-design`°、`story-structure`°、`story-planning`°、`narrative-momentum`°、`foreshadow-payoff`°、`story-ending`° |
|
||||
| 写作与候选主权 | 01-作品、05-创作流程 | `decide-candidate`、`expand-scene`、`polish-prose`、`rewrite-selection`、`write-next-chapter`、`scene-craft`°、`dialogue-craft`°、`character-design`°、`character-presentation`°、`show-and-omission`°、`narration-pov`°、`prose-craft`°、`theme-and-stance`° |
|
||||
| 质量与回放评测 | 06-质量与复利、05-创作流程 | `check-content-consistency`、`evaluate-frozen-replay`、`optimize-content-quality`、`score-content-quality`、`novel-diagnosis`° |
|
||||
| 去 AI 味与人感 | 06-质量与复利、父仓专题-09 | `capture-ai-flavor-cases`、`diagnose-ai-flavor`、`establish-voice-baseline`、`prevent-ai-flavor`、`revise-ai-flavor` |
|
||||
|
||||
`humanization/` 是“去 AI 味与人感”运行时 Skill 家族的能力域:`src/deai/` 是共享实现。规则与样例的运行时权威是 `example_ai_flavor_rule` / `example_ai_flavor_sample`(DDL-111,`humanization/tools/seed_rules_db.py` 种子同步,生产读取失败关闭,不静默回退 Git);案例卡与声音账同样入库。仓内 YAML/JSON 是迁移种子、离线夹具和结构合同;规则生命周期变更经 YAML 评测/激活后同步入库。规则记录不各自注册为 Skill,Skill 负责动作和消费边界。
|
||||
`°` 标记的是**参照 Skill**:不执行动作、不产生系统事实——无数据库读写合同、不落库、不进 `meta/chains/` 登记、不做 `tests/skills/` 回归,`SKILL.md` 与 `references/` 之外不含可执行 Tool,命名用领域名而非 `动作-对象`。未标记的是**系统能力 Skill**:执行动作、产生落库的系统事实,须满足 [07-Agent与Skill领域 §3](.agent/docs/architecture/domains/07-Agent与Skill领域.md) 的完整合同;其中绑创作 scenario 的在 `meta/chains/` 登记,平台与工具类(如 `call-content-model`、`execute-claude-task`、`record-run-evidence`)由主会话或其它 Skill 直接调用,不绑 scenario。
|
||||
|
||||
`craft/` 是小说写作方法论参照库(试用区):7 本写作书的 75 个方法论单元按创作领域全量合并为 15 个综合 skill 包(SKILL.md 入口 + references/ 全量内容 + scripts/ 脚本),落在 `.claude/skills/` 下,供 writer 角色和创作环节按需取用。综合 skill 是方法论参照,不是项目运行时 Skill:不落库、无数据库合同、不进 `meta/chains/`;分类、合并与裁剪的权威在 `craft/MERGE_PLAN.md`,维护门禁见 `craft/scripts/check_craft_skills.py`。
|
||||
**判据是产不产生系统事实,不是有没有 `scripts/`**:`plan-chapter`、`expand-scene`、`polish-prose`、`rewrite-selection`、`optimize-content-quality` 以模型判断为主、自身不带 Tool,落库由它们调用的 Skill 的 `scripts/` 承担,仍是系统能力 Skill。两类都是本仓正式 skill,都可在创作生命周期内被角色取用(参照 Skill 同样参与检测与评审),取用边界只由各自 `SKILL.md` 声明。
|
||||
|
||||
`humanization/` 是“去 AI 味与人感”Skill 家族的能力域:`src/deai/` 是共享实现。规则与样例的运行时权威是 `example_ai_flavor_rule` / `example_ai_flavor_sample`(DDL-111,`humanization/tools/seed_rules_db.py` 种子同步,生产读取失败关闭,不静默回退 Git);案例卡与声音账同样入库。仓内 YAML/JSON 是迁移种子、离线夹具和结构合同;规则生命周期变更经 YAML 评测/激活后同步入库。规则记录不各自注册为 Skill,Skill 负责动作和消费边界。
|
||||
|
||||
15 个参照 Skill 来自 7 本写作书的方法论单元按创作领域合并(`SKILL.md` 入口 + `references/` 全量内容 + `scripts/` 工作表与清单),供 writer、planner、judge 等角色在对应创作阶段按需取用;它们不设维护门禁。蒸馏与裁剪的历史留痕见 `docs/2026-08-19-craft-distillation-trace.md`(原 `craft/` 目录已清理,原料与旧 SoT 由 git 历史保留)。
|
||||
|
||||
Skill 领域列表的新增、删除、改名或主领域调整,必须同时检查 `.claude/skills/`、`meta/chains/README.md` 和相关领域 `_index.md`;不得只改本表造成索引漂移。
|
||||
|
||||
@ -180,7 +185,7 @@ git diff --check
|
||||
4. **符合 skill 规范**:`SKILL.md` 是否清楚定义输入、输出、红线、用法?`scripts/` 是否只包含运行时确定性实现与机械门?相关实现测试和行为评测是否已在 `harness/manifests/` 登记?是否走 `.venv`、不裸调 PG/New-API/模型?
|
||||
5. **边界一致**:引用的路径、合同、字段是否与现行 SoT(本文件、`.agent/`、`meta/` 和库内正式内容)一致?数据库是正式内容权威,Skill 必须声明读写哪些表、失败如何关闭、输入产出如何落库;引用已失效合同的不得执行。
|
||||
|
||||
命名采用小写 `动作-对象`:目录名必须等于 frontmatter `name`,名称表达可调用能力,不复用 `scenario`、内部模块名或含混阶段词。`scenario`、`source_type`、updater 和备份逻辑键是独立稳定标识,不随 Skill 改名。
|
||||
目录名必须等于 frontmatter `name`。系统能力 Skill 命名采用小写 `动作-对象`,名称表达可调用能力,不复用 `scenario`、内部模块名或含混阶段词;参照 Skill 用小写领域名(如 `scene-craft`、`narration-pov`),且上面第 3、4 问中关于失败关闭、稳定错误码、机械门和 `harness/manifests/` 登记的部分不适用,只审目的单一、取用边界与引用一致。`scenario`、`source_type`、updater 和备份逻辑键是独立稳定标识,不随 Skill 改名。
|
||||
|
||||
### 11.3 审查产出
|
||||
|
||||
|
||||
@ -34,7 +34,7 @@ agent-example/
|
||||
├── CLAUDE.md # 只引用 AGENTS.md 的兼容入口
|
||||
├── .agent/ # 跨任务长期知识与领域设计 SoT
|
||||
├── .claude/agents/ # 角色 Agent
|
||||
├── .claude/skills/ # Skill、确定性工具和离线测试
|
||||
├── .claude/skills/ # Skill 合同与确定性工具(分类索引见 _index.md)
|
||||
├── meta/schemas/ # 结构本体与本地字段合同
|
||||
├── meta/chains/ # 功能链、场景、用途和角色槽位
|
||||
├── knowledge/ # 现有参考资产
|
||||
|
||||
@ -20,24 +20,11 @@ rules/ 规则库 v0(26 条 active,覆盖 regex/handler/density/model_j
|
||||
samples/ 样例库(sf / snf / boundary / regression),候选规则也必须先有四类夹具
|
||||
cards/ 合成案例卡示例
|
||||
research/ 20 项开源研究机制追踪矩阵 + 中文轻量去重人感规则目录(研究候选,不等于 active)
|
||||
skills/ 从研究目录派生的可搬移标准 Skill;当前含日常中文人感写作与场景规则选择器
|
||||
tests/ 合同负路测试:../.venv/bin/python -m unittest discover -s tests -v(在 humanization/ 下运行)
|
||||
eval/ 判别试跑与回归探针:../.venv/bin/python eval/run_eval.py
|
||||
config.yaml 模型角色分离配置(改写模型 ≠ 选择模型,代码强制)
|
||||
```
|
||||
|
||||
## 通用日常文本 Skill
|
||||
|
||||
[`skills/write-human-text/`](skills/write-human-text/SKILL.md) 是可直接迁移的日常中文写作包,包含场景规则族、详细规则库和有限轮次复检清单,覆盖小说、新闻、公众号、短视频口播、技术设计、作品设定、工作汇报、内容讲解等写作与改稿场景。它按事实类型、写作目的、载体、受众和风险选择规则子集。
|
||||
|
||||
该 Skill 是可搬移的标准包,运行时不依赖本目录的 `research/`、生产规则、数据库或模型客户端;迁移时复制整个 `write-human-text/` 目录即可。它不登记为 `agent-example` 小说生产链的 scenario。正式作品候选仍走下方五技能和 Canonical 接受门,不能用通用 Skill 绕过。
|
||||
|
||||
```bash
|
||||
../.venv/bin/python skills/write-human-text/scripts/select_profile.py --list-scenes
|
||||
../.venv/bin/python skills/write-human-text/scripts/select_profile.py --scene technical-design --mode draft
|
||||
../.venv/bin/python skills/write-human-text/scripts/test_select_profile.py
|
||||
```
|
||||
|
||||
## 与五个技能 skill 的对应
|
||||
|
||||
| 技能 | skill | 消费本目录什么 |
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user