关于 archaeological-drawing
将文物照片、文字描述或草稿转为考古绘图的技能,适用于需要依据证据制作技术草图的工作。它先判断素材与校准程度,再限制绘图范围和可信等级,避免补造缺失结构或细节。
主要功能
- 01按证据条件划分素材等级
- 02限制绘图类型与可信度
- 03区分主体结构和高风险局部
- 04标记不确定或省略的细节
- 05合并修订并输出风险说明
适用场景
- 01根据文物照片绘制可审阅草图
- 02为文字描述规划视图或示意图
- 03复核铭文、纹饰等易误判区域
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ hst368/ archaeological-drawing-skill --skill archaeological-drawing安装后在 Claude Code 中输入/archaeological-drawing确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
CHANGELOG.mdLICENSEVERSIONREADME.md.gitignoreagents/openai.yamlexamples/openwork-plaque.mdstone-tool.mdvessel-profile.mdreferences/prompt-templates.mdstandards.md详细介绍
文物绘图
将文物照片、描述或现有草稿转换为考古绘图,优先保证科学记录,而非视觉效果。
默认生成证据所能支持的最高保真度成果。如果源材料不完整,应降低绘图目标,而不是臆造不可见的结构、精确厚度、缺失的纹饰或虚假的比例尺。
源材料判定 / 校准关口
规划绘图前,先对源材料分类。此关口用于确定可辩护的最高成果等级。
实测物体 + 已校准的多视图- 源材料包含真实测量数据或可靠校准信息,以及多个可靠视图。
- 可作为
报告级候选成果。 - 最终的
报告级实测绘图仍需人工审核、比例检查和出版准备。
带比例参照的近似正投影视图- 源材料包含比例尺或明确可靠的尺寸参照,以及近似正投影的正面或轮廓视图。
- 可用于绘制单面正投影图,也可作为该单面的
报告级候选成果。 - 不得将报告级结论扩展至不可见的侧面、厚度或缺乏依据的剖面。
未校准的多视图- 源材料包含多个视图,但没有可靠的校准信息或测量依据。
- 仅可作为
证据限定的 AI 技术草图。 - 绝不可直接将其作为
报告级实测绘图。
单张倾斜照片- 源材料是一张倾斜拍摄或局部拍摄的照片,且没有可靠的校准信息。
- 仅可在
证据限定的 AI 技术草图范围内重绘可见面。 - 绝不可仅凭此材料重建完整的正投影物体记录。
纯文字描述- 源材料是文字描述,没有可靠的图像证据。
- 仅可用于制定
视图计划、提示词包或示意概念图。 - 绝不可将成果作为规范的考古绘图。
如果看起来可能属于多个类别,除非校准信息和几何结构明确支持更高等级的判断,否则应选择较低等级。
成果等级
编写提示词前,先明确或在内部判定成果等级。
等级 1:报告级实测绘图- 仅适用于基于实测或已校准的证据,并经过人工审核的成果。
- AI 可协助起草、清理或排版,但不能通过一次纯生成完成。
等级 1.5:报告级候选成果- 证据充分,但尚未完成全面测量、校准或出版定稿时,可使用此等级。
- 必须说明尚缺少的工作,例如校准、轮廓核验、线条清理或出版准备。
等级 2:证据限定的 AI 技术草图- 大多数基于照片的请求默认采用此等级。
- 用于草稿制作、审核、修正、矢量化和后续出版准备。
等级 3:考古风格插图- 证据较弱、材料为示意性内容或主要用于交流时,可采用此等级。
- 不得将其作为报告图呈现。
图像后端能力
仅使用图像后端能力来支持受证据限制的工作流。模型功能绝不会提高证据等级或输出层级。
- 实用能力:
- 参考图像编辑,用于基于来源的重绘和修正
- 输出透明背景 PNG,用于布局素材、叠加检查和后续合成
- 对象/背景分离,用于移除非文物背景、标签、投影或说明文字
- 迭代修订,用于修正轮廓偏移、线条层级和无依据的细节
- 严格限制:
- AI 补全只能用于文物主体以外的区域,例如分离对象后填充非文物背景。
- 绝不可使用 AI 补全来复原缺失的文物结构、被遮挡的装饰、壁厚、破损边缘、无法辨读的铭文或受损的符号笔画。
- 不要将更干净的分离对象、透明边缘或分层素材视为比原始来源更强的证据。
- 如果后端对文物细节进行平滑、修复、规整或臆造,则拒绝该结果,或将受影响区域降级为不确定。
工作流模式
这些模式位于证据门槛和输出层级之下,只控制执行过程;绝不会提升允许作出的输出声明。
main-structure pass- 负责整体轮廓、主要结构、投影、整体对称或不对称,以及大致的装饰分区。
- 必须有意弱化或暂不处理高风险局部细节,例如文字、密集重复装饰、眩光严重的边缘、镂空交叉处和受损边界。
high-risk local pass- 仅负责孤立的高风险区域,例如文字或符号、密集装饰簇、镂空交叉处、反光边缘、断裂线和其他歧义突出区域。
- 不得改变整体轮廓,也不得重新判定整体投影。
- 除非用户明确要求,否则不得暗示会单独导出局部图像。
review-and-merge pass- 负责协调主要结构草稿与局部修正、降低无依据细节的等级,并给出最终的
Risk note。 - 必须决定如何处理较弱的局部细节:合并、简化、省略或明确降级。
- 负责协调主要结构草稿与局部修正、降低无依据细节的等级,并给出最终的
关系规则:
Source Conditioning / Calibration Gate决定可辩护声明的上限。Output Tier决定交付内容可以有多权威。Workflow Mode决定执行过程如何进行。- 工作流模式可以让草稿制作更安全、更便于审查,但无法增强证据,也无法提升输出层级。
预处理/区域分诊
在 main-structure pass 之前运行此分诊步骤,不可省略。
- 选择一个
primary geometry reference。- 用它锁定轮廓、投影以及主要面或侧面轮廓。
- 选择任意数量的
secondary detail references。- 仅用它们确认与相同观测结构相符的局部细节。
- 如果来源包含过多背景、眩光区域或无关标注,则在编写提示词前裁剪或在头脑中隔离相关对象、面或局部区域。
- 在生成前标明高风险区域。
- 常见类别:文字或符号、密集重复装饰、镂空交叉处、反光边缘、受损或缺失的边界、严重重叠或遮挡。
- 决定任务应按以下哪种方式执行:
- 仅绘制整个对象或整个表面
- 仅处理高风险局部
- 同时采用两者的拆分工作流
- 将低价值输入降级或忽略,不要将其平均混入结果。
- 常见降级情形:模糊、严重眩光、透视不佳、严重遮挡、景深过浅或局部对焦不佳。
分诊的最低输出项:
source classoutput tierprimary geometry referencesecondary detail referencesnamed high-risk regionsselected mode sequence
如果分诊结果薄弱或互相矛盾,则应在编写提示词前降低绘制目标的要求。
模式 I/O 契约
将每种工作流模式视为一份契约,明确规定输入、输出和禁止事项。
main-structure pass- 输入:
source classoutput tierprimary geometry reference- 对象或面的范围
- 输出:
- 稳定的全局轮廓
- 投影和基线
- 主要结构和大致装饰分区
- 尚未解决的局部风险列表
- 必须暂缓处理:
- 脚本或符号
- 密集装饰的微观拓扑
- 微小断裂和细小破损边缘
- 不得更改:
- 证据门槛
- 输出层级
- 输入:
high-risk local pass- 输入:
- 明确标出的高风险区域
- 已锁定的主结构草稿
- 兼容的次要细节参考
- 输出:
- 每个区域的局部决策和局部修正
- 不得更改:
- 全局轮廓
- 全局朝向
- 整体投影
- 输出层级
- 输入:
review-and-merge pass- 输入:
- 主草稿
- 局部处理阶段的决策
- 输出:
- 合并后的草稿
- 降级决策
- 最终的
Risk note
- 必须将每个明确标出的局部区域报告为:
resolvedsimplifiedomittedleft uncertain
- 输入:
用户覆盖选项(如 只跑主结构、只做高风险局部 或 只做合并复核)可以限制模式序列,但不得绕过证据门槛、输出层级或 Risk note 规则。
工作流
-
绘制前先明确证据所能支持的上限。
- 如果有源文物照片,优先以其为参考进行图像编辑。
- 提示前先为参考图指定用途:选择一张作为整体轮廓和视角的
primary geometry reference,其他图像则仅作为局部浮雕、装饰、磨损或铭文的secondary detail references。 - 优先选择裁切紧凑、对焦清晰且只包含单件文物的图像。对模糊、对比度低、反光强烈或透视感明显的照片,应降低其参考权重或忽略,而不要将它们平均融合进结果。
- 先确定
Source Conditioning / Calibration Gate类别,再在编写提示词前限定允许的Output Tier。 - 区分
report-grade measured drawing、report-grade candidate、evidence-bounded AI technical draft和archaeological-style illustration。 - 如果源图是单张斜拍或局部照片,只呈现可见面或可见轮廓,不要凭空构造完整的正投影重建图。
- 将铭文、印章、戳记、制作者标记、数字、字母、合字、标点,以及任何类似文字或符号的痕迹视为高风险结构。绝不允许模型翻译、现代化、规整、补全、规范化或重新排版这些内容。
- 区分文物上的标记与文物外部的文字或符号。仅当文物上的文字、字母、数字和符号清晰可见且具有诊断价值时才予以保留;除非用户明确要求记录,否则应移除博物馆标签、说明文字、水印、藏品编号和背景文字。
- 绝不根据无关视角臆造精确尺寸、壁厚或剖面几何形状。
- 进入
main-structure pass前,先完成Preprocessing / Region Triage。 - 检查文物是否包含高风险区域,例如文字或符号、密集重复装饰、镂空交叉结构、强烈镜面眩光、边界破损或缺失,以及严重重叠或遮挡。
- 如果不存在高风险区域,跳过
high-risk local pass。 - 如果存在高风险区域,明确指出这些区域,并将其送入
high-risk local pass。 - 默认自动切换模式,但应遵从用户明确指定的覆盖选项,例如
只跑主结构、只做高风险局部或只做合并复核。 - 使用以下证据矩阵:
- 单张斜拍或局部照片:仅允许绘制可见面的考古图,或谨慎的技术插图。
- 单张清晰的侧面或正面照片,且视角接近正投影:仅允许绘制该面的一个可见正投影视图。
- 多张清晰的相对两侧照片:允许绘制比例匹配、基线对齐的双面图。
- 多视图加上唇部、断口、剖面边缘或厚度的真实证据:仅在证据存在的部位绘制剖面或轮廓信息。
- 用户提供的真实尺寸或可信元数据:允许绘制准确的比例尺;否则省略比例尺。
-
选择与文物相匹配的视图体系。
- 对旋转对称的容器,仅当源图确实支持轮廓和厚度时,才使用左半剖面、右半外观的标准视图。
- 对不对称或复杂文物,使用多个对齐的正投影视图。
- 对镂空饰板、配件、吊坠和类似的扁平文物,以正面正投影视图为主视图;仅在厚度有证据支持时,才添加侧视图或剖面信息。
- 所有视图均须保持正投影对齐。不得使用透视、相机角度或夸张的透视缩短。
-
将绘图语言编码为硬性约束。
- 仅使用黑色线条、点、排线和白色负空间。
- 保持严格的层级:先画整体轮廓,其次是主要结构边界,再次是诊断性装饰,最后才是附带的表面噪点;也可省略。
- 固定光源方向为左上方,约呈 45 度。
- 受光的凸起边缘使用细线,背光侧的凸起边缘使用较粗的线条。
- 对凹刻或凹陷特征采用相反的规则。
- 如果物体上有文字、字母、数字、标点或符号笔画,将其视为观察到的形状,而非可读文本。若清晰可辨,准确复制其可见几何形状;若无法辨认,则保留为不确定的标记,不要替换成规范化的现代文字或符号。
- 仅当有证据支持推断时,才使用虚线表示隐藏、缺失或复原的特征。
- 不要使用绘画式阴影、洗染效果、摄影阴影、渐变或装饰性背景。
-
按正确顺序编写提示词。
- 首先说明不可妥协的科学约束。
- 在提示词开头附近说明所选的输出等级,避免模型夸大精确度。
- 在提示词开头附近明确说明当前工作流模式。
- 其次说明文物类型、视图系统和方向。
- 第三说明线条、点和阴影逻辑。
- 最后说明布局、交付形式、比例尺处理、风险说明要求以及任何必需的标签。
- 将输出规范直接写入提示词:使用白色背景(除非用户要求使用其他图版底色)、文物居中、边距整洁、线条层级在出版尺寸下清晰可辨,并谨慎使用标签。
- 指定可见结构使用实线,仅隐藏或复原结构使用虚线,只有在确有剖面的情况下才使用剖面填充或排线。
- 如果用户要求制作图版,或提供了多个视图或文物,则指定使用网格或对齐的图版布局,保持基线一致,并如实处理比例尺。
- 明确禁止透视、颜色、影棚灯光、光泽反射、推测性复原和装饰性修饰。
-
接受结果前,对照源内容审查。
- 首先检查整体轮廓和剪影。若外形发生偏移,立即拒绝。
- 接着检查主要结构:视图选择、空隙、镂空结构、附属部件、剖面和对齐的基线。
- 然后检查可见的损坏、磨损、不对称和缺失区域。若结果看起来比源内容更整洁或更完整,则朝源内容的方向修订。
- 在放大后的局部裁剪图中检查密集装饰和重复图案,而不要只看整张图版。注意是否存在断裂、环线合并、图案重复和凭空补全的闭合结构。
- 如果使用了
high-risk local pass,记录每个指定局部区域的处理结果:已还原、简化、省略或保留为不确定。 - 最后检查线条逻辑:层级、凸面与凹面的处理、虚线含义,以及图面是否仍呈现技术图纸的风格而非装饰风格。
- 然后根据 references/standards.md 中的验收清单审查图像。
不可妥协的规则
- 将
absolute fidelity to the original object视为最高准则。 - 优先采用正投影,而非图像式写实表现。
- 记录可见内容;仅在推断符合惯例、极为克制且有依据时进行推断。
- 将观察到的形态与复原形态分开。
- 若源内容中可见破损、不对称、磨损和不规则之处,则予以保留。
- 仅当已知实际尺寸时才添加比例尺。若尺寸未知,则省略比例尺或预留位置供之后标注,但绝不捏造数值比例。
- 绝不让更强的输出主张超出证据门槛。
视图选择
选择证据所支持的最精简视图组合:
- 对称器皿:仅当轮廓和厚度都有充分依据时,才使用常规半剖视图系统。
- 不对称器皿:将主视图朝向最具诊断性的侧面,仅在必要时添加投影视图。
- 石制工具:形态需要时,使用正面、背面和侧面视图。
- 镂空或扁平饰物:优先展示可见面,并精确保留外轮廓和镂空部分。
- 雕塑类物件:优先采用左/右正交侧视图,再视情况增加其他视图。
请阅读 references/standards.md,了解完整的视图与布局规则、针对具体器物的惯例以及验收清单。
提示词指导
使用图像模型时:
- 优先使用参考图编辑,而非仅根据文本生成。
- 告诉模型要
convert、redraw或regularize into archaeological drawing,而不是reimagine或stylize。 - 明确告知模型必须保留哪些可见结构。
- 告知模型必须从源照片中移除哪些内容,例如背景布、标签、博物馆说明文字、非器物本体的眩光或投影。
- 将器物本体上的眩光视为高风险局部区域。只复制可见结构;不要对被眩光遮挡的细节进行修补、复原或推断。
- 请求分离器物或移除背景时,须保留器物原有的边缘不规则、断裂、镂空和损伤。不要修补、美化或补全器物本体。
- 仅在用于布局素材、叠加层或分层制作交付时请求
transparent background。除非用户明确要求其他格式,默认科学绘图应使用白色背景的 PNG。 - 铭文或类符号标记十分重要时,请明确说明
treat all characters, letters, numerals, and symbols as image geometry, not as text content以及do not translate, simplify, regularize, replace with fonts, or repair missing strokes。 - 明确说明
scientific record first, artistic expression second。
初稿效果不佳时:
- 先收紧几何约束,再添加更多风格描述。
- 明确重申参考层级:
follow the primary reference for contour and projection; use secondary references only to confirm local detail already visible on the same face or view。 - 要求减少阴影和臆造细节,并严格遵循正交对齐。
- 证据有限时,将范围从
full reconstruction缩小为visible-face archaeological drawing。 - 对于繁密的装饰纹样,要求模型使用不同的线条重要性区分
outer contour、main motif和ground pattern,而不是让所有细节的呈现强度相同。 - 如果结果仍然过度宣称确定性,应降低输出等级,而不是继续堆叠风格描述。
需要用于器皿、石制工具、镂空饰物或审查环节的现成提示词时,请阅读 references/prompt-templates.md。
仅当任务与示例高度匹配时,才阅读相应示例:
- 器皿轮廓或半剖图请求,请参阅 examples/vessel-profile.md。
- 石制工具多视图绘图,请参阅 examples/stone-tool.md。
- 镂空饰板、配件、吊坠和扁平饰物,请参阅 examples/openwork-plaque.md。
执行
提示词准备就绪后,选择与输出等级相符的执行路径。
- 优先选择当前环境可调用的最强图像生成模型,尤其是支持参考图编辑和迭代修订的模型。
- 优先基于源照片进行图像编辑,而不是仅通过文本生成。
- 不要将本地提供方或技能写死。应在运行时选择能力最强的可用模型。
- 如果有多个可调用模型,优先选择最能保留结构、轮廓和损伤,同时支持基于提示词进行修正的模型。
- 生成前选择输出通道:
scientific drawing:用于审核或出版准备、受证据约束的绘图;默认使用白色背景。layout asset:用于放置、叠加或合成的透明背景 PNG;完全保留已批准的绘图。layered production asset:仅根据已批准的绘图图层创建分层源文件或 PSD 交付件,且仅限当前工具链确实能够制作的情况。
- 不要让布局或分层制作需求改变源类别、输出等级、轮廓决策或局部风险决策。
- 默认自动切换模式:
- 从
main-structure pass开始。 - 仅当存在明确命名的高风险区域时,才启用
high-risk local pass。 - 最后执行
review-and-merge pass。
- 从
- 如果用户明确要求使用某种子集模式,应照办,但现有证据门槛、输出等级和
Risk note要求仍然有效。 - 在面向用户的进度更新中明确说明模式转换。
- 开始时说明完整的分流记录,而不只是模式名称。
- 开始时的更新应包含:
source classoutput tierprimary geometry referencenamed high-risk regionsselected mode sequence- 当前模式为
main-structure pass
- 如果存在局部风险,应说明
high-risk local pass,并明确指出受影响的区域。 - 结束时说明
review-and-merge pass,并提供最终的Risk note。
Tier 2: evidence-bounded AI technical draft- 可直接进行 AI 生成。
- 如果第一版结果超出证据上限、不符合正投影逻辑或不符合线描规范,至少进行一轮修正。
Tier 3: archaeological-style illustration- 可直接进行 AI 生成,但提示词和交付件不得暗示其具有可用于报告的权威性。
Tier 1和Tier 1.5- AI 可以协助起草,但生成后必须经过审核和完善步骤:轮廓检查、比例检查、视图校正、线条清理和出版准备。
- 仅凭模型可用,绝不能将结果视为可用于报告的实测图或候选图。
- 如果重复性工作遵循统一风格,最有效的改进并非加长提示词,而是进行领域适配:小型的照片与获批线稿配对数据集,比单靠通用提示词更适合用于 LoRA 风格定制。
- 生成后,如有需要,可进行轻微清理:移除孤立的小斑点并修补细小的断线,但不要简化或合并精细的诊断性笔画。
- 如果没有可调用的图像生成模型,请提供提示词包、视图规划和审核清单,而不要假装已经生成了绘图。
对于 Codex/OpenAI 环境,agents/openai.yaml 中可能包含 UI 元数据。Claude Code 无需该文件即可触发该技能;它依赖 SKILL.md 和 frontmatter 描述。
交付件
草稿输出
- 除非用户明确要求其他格式或图版样式,否则默认输出一张白色背景的 PNG。
- 仅当请求的输出是
layout asset、叠加图或分层制作交付件时,才使用透明背景 PNG;保持所有文物线稿和不确定边缘不变。 - 如果用户提供同一件文物的多个视图,默认将对齐后的视图组合成一张图版,而不是输出互不相关的单独图像。
- 如果用户提供多件文物或明确要求制作
plate,则将图像排成网格,保持边距一致,并在适当情况下对齐基线;仅当测量数据已知时,才提供真实的比例提示。 - 如果用户要求分别导出,仅当拆分明显有助于出版或审核时,才同时保留组合图版和单独视图。
- 草稿输出适用于审核、标注、本地修正和后续清理。
出版输出
- 如果用户的目标是出版、报告制作、目录编制或图版提交,且工作流确实支持,则优先提供可矢量化或可用于制作的交付件,例如 SVG、PDF、高分辨率 TIFF 或分层线稿源文件。
- 除非 AI 输出经过人工审核、修正和出版准备,否则应将其视为线稿初稿。
- 除非当前工具链确实能够生成,否则不要承诺自动矢量化或分层源文件输出。
- 标签、编号和比例尺应克制且符合出版要求。尺寸未知时,不要标注数值比例。
分层制作输出
- 将 PSD 或分层源文件导出视为制作交付件,而不是独立的考古发现。
- 除非已验证的脚本或工具链确实能够在当前环境中生成,否则不要承诺导出 PSD。
- 生成分层输出时,使用固定图层名称:
reference、contour、major-structure、ornament、section-hatching、labels和risk-note。 - 每个图层都必须基于已批准的源绑定绘图或源参考。任何图层都不得包含由 AI 补全的文物结构或修复的局部细节。
- 如果工具链无法生成分层输出,则返回图层计划和提示词包,而不要声称已生成 PSD。
风险说明
- 每项输出都必须以简短的
Risk note结尾。 - 证据较强时,简要说明并指出剩余局限。
- 证据较弱时,明确指出不确定区域,例如磨损的装饰、低对比度浮雕、反光眩光、密集纹样拓扑、受损边缘或含义不明的文字/符号。
- 如果使用了
high-risk local pass,说明每个点名的局部区域是已解决、已简化、已省略,还是仍不确定。 - 如果使用了对象分离、背景移除、透明边缘清理或文物之外的 AI 补全,应说明这些操作是否影响了文物信息。
- 切勿将 AI 补全的文物结构描述为已确认的证据;证据不足的文物区域必须保持简化、予以省略或标记为不确定。
LoRA 就绪度
本节是面向未来的扩展,并非正常使用所必需。
当前后端的实际情况:
- 此技能目前不提供内置的可训练图像生成后端。
- 如果可用的图像后端仅是托管的通用模型,应将 LoRA 视为未来的外部工作,而不是此技能能够直接执行的任务。
- 在仅使用 OpenAI 的图像生成环境中,除非引入独立的可训练图像后端,否则应将工作流控制、参考图规范和审核轮次视为主要优化手段。
仅当以下情况都开始成立时,才考虑 LoRA:
- 工作负载是重复性的,而非偶发性的
- 已有稳定的统一风格或审核标准
- 同类错误反复出现
- 有小规模的配对数据集可用
建议的最低数据结构:
- 文物照片输入素材
- 已采纳的线图
- 仅限相同视角
- 不包含不匹配的配对,例如斜视角原始照片搭配理想化的完整复原图
有用的可选元数据:
- 文物类型
- 视角
source classoutput tierrisk regions
建议的集合分类:
base setornament hard setscript/symbol hard set
不要使用以下示例训练:
- 模糊或反光的照片搭配干净、理想化的复原图
- 古代或受损文字搭配规范化的现代文本
- 破损装饰纹样搭配完全修复的装饰纹样
请仅将此内容视为训练就绪度指南。不要假定此技能中已有完整的训练流水线、命令或工具。
失败模式
避免以下常见错误:
- 将透视失真伪装成技术图纸。
- 将非对称物体改成对称形状。
- 用理想化边缘替换已观察到的损坏。
- 将古代、外文、象征性或受损标记转换为规范化的现代字符、字母、数字或标点。
- 将
evidence-bounded AI technical draft呈现为report-grade measured drawing。 - 让
high-risk local pass覆盖main-structure pass确定的整体轮廓或投影。 - 将局部修正视为足以提升输出等级的证据。
- 臆造未见的背面、内部或厚度。
- 到处使用统一的线宽。
- 将图像渲染成奇幻概念艺术、雕版艺术或装饰海报艺术风格。
- 添加虚假的比例尺或测量刻度。