关于 chalk-logic
Chalk Logic 是一项将想法转化为克制、默认无文字粉笔插画的技能;无法生成或检查图像时可仅输出提示词。它制定视觉方案,在缩略图和原图尺寸检查生成结果,并最多进行两轮修正。
主要功能
- 01规划表达单一命题的构图
- 02限定绿板与白色粉笔的视觉风格
- 03提供六种构图类型与格式指引
- 04编写图像提示词并输出完整方案
- 05双尺寸检查并最多修正两轮
适用场景
- 01为单一过程或关系制作插画
- 02构思简洁的循环或分支图
- 03图像工具不可用时准备提示词
- 04按视觉约束检查插画
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ calicastle/ skills --skill chalk-logic安装后在 Claude Code 中输入/chalk-logic确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSEagents/openai.yamlreferences/example-index.mdrepair-playbook.md详细介绍
Chalk Logic
将一个想法转化为绿色均匀板面上的一个安静的白粉笔命题。默认情况下,在支持图像生成和检查时直接渲染;否则返回编译后的提示词和配方。
视觉规范
将每条要点同时视为生成规则和 QA 检查关卡:
- **一个命题:**传达一个过程、关系、结构、循环、累积、衰减或观察前提。为其设定一条明确无误的阅读路径。
- **安静的画面:**让板面大约有 65%-75% 留白。对于单一稀疏序列或观察小景,将留白提高到 76%-86%。保留宽裕的外边距和紧凑的概念主题图形。
- **均匀的板面:**用平整、干燥、低饱和度的教室绿板铺满画布。使用细微到几乎不可见的哑光颗粒感,在缩略图尺寸下也不显眼。画面中只包含板面和承载概念的粉笔图形。
- **矿物质般的手感:**只用暖白色矿物粉笔绘制。采用三种克制的对比度:淡淡的构图或背景、清晰可读的结构,以及极少数更明亮的接触点。表现压力变化、略有断裂的笔画边缘、偶尔的重叠笔画和微小粉末沉积。
- **连贯的笔画:**将语义路径绘制为连贯的笔势,材质断裂仅限于笔画边缘和端点。只有在交叉处具有明确的因果或结构含义时才使用交叉。
- **精确而有手工感:**构图应经过深思熟虑,笔迹应保留手绘感。可识别的形态须基于观察所得的轮廓和功能性解剖结构;抽象形态须基于具体的空间行为构建。
- **默认无文字:**不渲染任何文字、字母、数字、方程式、仿写文字、签名、标志或水印。如果用户明确要求文字,只使用其原文,写成一个简短短语,或最多三个微型标签,合计不超过六个词。
- **原创拓扑:**满足步骤 3 中声明的锚点差异,并根据概念自身的机制构建构图。
- **双尺度清晰度:**让命题在缩略图尺寸下清晰可读,并让全尺寸检查能展现细腻而克制的材质细节。
- **作者式克制:**每一笔都应服务于命题。保留预期读法所需的最少结构形态。
格式
- 默认横向插图使用
16:9。 - 开放式循环或紧凑累积使用
1:1。 - 分支研究、拆解物体或海报使用
4:5。 - 仅当长程变化适合超宽画幅时,才使用约
2.2:1。 - 遵循用户提供的精确尺寸,并按原生尺寸进行构图。
构图类型
恰好选择一种主要类型。
| 类型 | 适用场景 | 正向构图规则 |
|---|---|---|
| 定向递进 | 转变、衰减、累积 | 采用一条从左到右或沿对角线延伸的序列;通过间距、密度、尺度、重复或压力表现变化 |
| 开放式循环 | 循环、阶段、睡眠、更新 | 围绕一个较大的中心留白布置 3 至 5 个不等的阶段,并用一个不完整的环或回返笔势连接 |
| 源点分支 | 机制、扩散、替代方案 | 设置一个紧凑的源点,延伸出 3 至 5 条不对称、互不交叉的轨迹,并以可识别的形态加以区分 |
| 轴向观察 | 构造、解剖、组装 | 将一个可识别的物体沿同一轴线拆分为数量少且精确的部件,并辅以稀疏的对齐痕迹 |
| 环境流动 | 吸收、转移、生长 | 设置一个克制的边界或区域,并通过密度和压力呈现一条连续的因果路径 |
| 静谧小景 | 反思、注意、缺席、停顿 | 在广阔画面中设置一组紧凑且偏离中心的物体,仅凭位置和留白承载画面,不使用图表式辅助结构 |
步骤
1. 锁定简报
确定概念、预期说明、情绪基调、输出格式、文本策略和执行模式。提供精确像素尺寸时,输出格式填写精确尺寸;否则填写比例。仅当图像生成和图像检查均可用时,才将执行模式设为 rendered。
如果用户禁止在当前对话中使用图像,则先建立一个全新的隔离工作器,再选择 rendered。通过该工作器完成锚点查看、生成、候选图查看、修复和图像 QA。要求它只返回文字发现和本地文件路径。如果用户要求使用 prompt-only,或者任何必需能力或隔离工作器不可用,则使用 prompt-only。
完成标准:明确列出简报的六项内容和执行上下文;不含图像的渲染流程已建立隔离工作器;并记录任何不可用的能力,以便交付时说明。
2. 提炼阅读路径
选择一种构图类型,并用一句内部视觉描述说明:观者首先看到什么、什么发生变化或建立关联,以及注意力最终落在哪里。选择一种语义载体,例如间距、密度、尺度、重复、压力或物体排列,用来承载含义。
完成标准:这句话表达一个连贯命题、一条有序阅读路径、一种主要构图类型,以及一种明确命名的语义载体,不包含无关的情节。
3. 锚定质量
完整阅读 references/example-index.md。根据其中的锚点选择规则,选择一到两个条目。为新构图记录一份共同的锚点差异方案:
- 对每个选定锚点,记录三项要保留的特征,并提供可观察的目标证据;
- 为新构图确定一种目标拓扑;
- 从主题、格式、视角、方向、数量、焦点位置或语义载体中,准确选择两个相互独立的目标轴;
- 对每个选定锚点,将其源值映射到相同的目标拓扑和两个目标轴值;每个目标值都必须与该锚点的源值存在可观察的差异。
对于渲染流程,只目视检查选定的本地示例。对于仅提示词流程,文字索引已足够。将示例视为质量依据,而不是图像生成输入。用户要求不在对话中显示图像时,应在第 1 步建立的全新隔离环境中进行检查,并且只返回文件链接。
完成标准:选定一到两个锚点;每个锚点都记录三项可观察的保留特征,以及从源值到共同拓扑和两个目标轴的映射;所有映射中的三个目标值完全一致,且与每个映射的源值都存在可观察的差异;渲染流程已目视检查每个选定锚点。
4. 声明方案
为每个轴准确选择一个值:
- 格式;
- 构图类型;
- 命题;
- 阅读路径;
- 语义载体;
- 拓扑;
- 母题位置;
- 识别线索或抽象标记词汇;
- 数量或状态:有意义时填写精确值,否则填写
not fixed; - 锚点差异目标:填写第 3 步中的两个目标值,不带锚点名称或来源信息;
- 留白目标;
- 粉笔对比层级;
- 情绪;
- 文本:填写
wordless,或填写用户提供的确切措辞及其字号和位置。
完成标准:十四个轴各有一个选择,且共同支持同一命题。
5. 编写图像提示词
编写四个简洁段落,只包含应转化为像素的信息:
- 说明画布、比例、均匀的绿色板面,以及留白目标。
- 说明命题、类别、语义载体、拓扑结构、有意义时的精确数量、阅读路径、识别线索、摆放位置,以及两个锚点变化的目标值。
- 说明暖白色粉笔的表现、三级对比度、连贯的线条表现和氛围。
- 说明文字策略,以及仅为避免可能的误读所需的主题专属硬性排除项。
内部标题、创作方案、文件名、来源信息、锚点分析和 QA 备注都应保留在图像提示词之外。
完成标准:每个创作方案维度都对应提示词中的目标像素属性;任何固定数量或状态都明确写出;任何要求的文字都包含确切措辞、大小和位置;提示词描述一个视觉命题;板面、粉笔、线条、氛围和文字门槛都明确写出。
对于 prompt-only,跳过步骤 6 和 7,并继续步骤 8,状态设为 PROMPT_ONLY。
6. 生成一个候选图
使用步骤 1 中选定的执行环境,以及内置的图像生成功能。对于不含图像的对话,由隔离工作进程执行所有涉及图像的操作。若该功能支持,则按要求的精确像素尺寸生成。否则,以相同的原生比例生成,并且仅在比例完全一致时进行重采样;如果这两种方式都无法满足要求的尺寸,则切换到 prompt-only,并记录功能限制说明。若用户提供了灵感图,仅将其用于要求的方向性线索,并保留原创拓扑结构。
完成标准:对于精确尺寸请求,文件元数据必须与要求的像素尺寸完全一致;对于比例请求,文件元数据必须与要求的比例一致。
7. 检查并修复
在步骤 1 中选定的执行环境里,以原尺寸和缩略图尺寸检查候选图。检查每一条视觉契约要点、全部十四个创作方案维度,以及每个记录的锚点变化。仅当创作方案注明 not fixed 时,才将 Exact counts 记为 N/A;对于任何其他不适用的门槛,也记录为 N/A。
如果多个门槛未通过,按以下优先级选取最先失败的一项:
- 要求的格式;
- 文字策略;
- 命题;
- 类别;
- 阅读路径;
- 因果顺序;
- 语义载体;
- 精确数量;
- 识别线索;
- 拓扑结构和锚点变化目标;
- 保留的锚点特征;
- 留白目标;
- 图案摆放位置;
- 缩略图清晰度;
- 原尺寸材质细节;
- 连贯的笔触;
- 均匀的板面;
- 矿物质感;
- 粉笔对比度层级;
- 氛围;
- 创作克制。
将选定的门槛传递给 references/repair-playbook.md,并应用其中针对第 1 轮修复的修正。重新检查全部二十一个门槛。第 2 轮时,按相同优先级选取最先仍未通过的门槛,并应用对应修正。仅当选定的门槛为 Topology and anchor-change targets 时,才替换拓扑结构。重新检查全部二十一个门槛,并在第 2 轮后停止。
如果可以使用第二个全新的隔离子 Agent,请将其用于最终视觉 QA。只向其提供候选图和门槛,并要求仅返回文本检查结果;不要将先前的判断纳入其上下文。在不含图像的运行中,由隔离工作进程负责此项调度,并且只返回判定结果。
完成标准:已彻底检查每个门槛。全部通过时设为 DONE;达到修复上限后,设为 DONE_WITH_CONCERNS,并列出所有仍未通过的门槛。
8. 交付
对于已渲染的运行,根据用户的显示偏好,先提供已验收的图像或普通文件链接,然后提供确切的提示词序列、完整配方和状态。提示词序列包含初始生成提示词,以及之后的每条修复指令,并按顺序排列。在交付前,将项目专用图像保存到用户的工作区。切勿将打包的参考图像作为生成作品展示。对于仅提示词的运行,交付编译后的提示词、完整配方和 PROMPT_ONLY 状态,不提供图像。如果仅提示词是能力回退方案,而非用户的请求,请简短说明一条能力限制。
完成标准:已渲染的运行包含经过检查的候选作品、确切的提示词序列、全部 14 个配方维度,以及 DONE 或 DONE_WITH_CONCERNS 状态;若状态为 DONE_WITH_CONCERNS,还须列出所有仍未通过的检查项。仅提示词的运行包含编译后的提示词、全部 14 个配方维度、PROMPT_ONLY 状态,以及任何必需的能力说明。
输出格式
对于 PROMPT_ONLY,省略 Image 行。省略所有未使用的修复行和条件字段。
**Image**
[Chalk Logic illustration](absolute-image-path)
**Exact prompt sequence**
```text
Initial: [exact generation prompt]
Repair 1: [exact instruction, when used]
Repair 2: [exact instruction, when used]
```
**Recipe**
- Format: [ratio or dimensions]
- Family: [family]
- Proposition: [visual sentence]
- Reading path: [choice]
- Semantic carrier: [spacing/density/scale/repetition/pressure/object arrangement]
- Topology: [spatial structure]
- Motif placement: [choice]
- Recognition cues or marks: [choice]
- Counts or states: [exact values/not fixed]
- Anchor-change targets: [target value 1; target value 2]
- Quiet space: [percentage]
- Chalk hierarchy: [three levels]
- Mood: [emotional temperature]
- Text: [wordless or exact wording, scale, and placement]
- Status: [DONE/DONE_WITH_CONCERNS/PROMPT_ONLY]
[Concerns: required only for DONE_WITH_CONCERNS]
[Capability note: only when PROMPT_ONLY is a fallback]