关于 dtcg-tokens
dtcg-tokens 是一项设计 Skill,可将可检查的多模态来源证据转化为特定来源的 DTCG 2025.10 令牌文件和证明产物。它结合确定性的 Mise 任务与视觉判断;缺少必要证据或视觉检查时,不予验收。
主要功能
- 01生成令牌、证据、证明和运行记录
- 02校验结构、取值、引用与循环
- 03创建独立 HTML 证明产物
- 04通过视觉判断比较设计实验
- 05跟踪流程门槛与证据记录
适用场景
- 01依据检查过的视觉及其他来源证据构建设计令牌
- 02检查 DTCG 文件的结构和引用错误
- 03验收前审查特定来源的令牌证明
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ srinitude/ skills --skill dtcg-tokens安装后在 Claude Code 中输入/dtcg-tokens确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.github/workflows/ci.ymlassets/creative-source-frontier.jsoncurrent-date-policy.jsondecision-records.jsondtcg-format-2025.10.schema.jsonevidence-template.jsonexecution-io-map.jsonexecution-step-contract.jsonexperiment-contract.jsonexploration-strategy-catalog.jsonfile-trigger-policy.jsongoogle-font-policy.jsonimprovement-contract.jsoninvocation-receipt-template.jsonjudgment-review-catalog.jsonmise-primitives-catalog.jsonmise-primitives.jsonmultimodal-input-catalog.jsonoriginality-analysis-contract.jsonassets/exploration-corpus/concepts.jsonconstraints.jsonmanifest.jsonmechanisms.jsonnegative-patterns.jsonoperators.jsonprimitives.jsonquestions.jsonsynthesis-contract.jsontechnology.jsonthemes.json详细介绍
dtcg-tokens
目标
将可检查的多模态源证据转化为特定于来源的 DTCG 2025.10 JSON、证据 JSON、独立 HTML 证明产物和运行记录。从完整的令牌可能性范围着手,依据已定位的证据和材料实验逐步缩小范围,并且只有在根据当前渲染像素进行判断后才接受令牌值。绝不捏造来源、受众、产品事实、品牌前提、比较语料或证明声明。
动机
结构上有效的令牌文件仍可能流于泛泛、具有误导性、缺乏无障碍性、表现平庸或视觉效果不佳。确定性的 Mise 任务负责可重复的机制,使强大的原生视觉能力能够专注于解读来源、令牌关系、创意实验、人类的视觉、思维和触觉判断,以及最终的视觉验收。
命令
| 命令 | 结果 | 负责的任务 |
|---|---|---|
help | 显示输入、意图、输出、视觉要求和声明限制。 | mise run token-help |
generate <inputs> | 生成 <name>.tokens.json、<name>.evidence.json、<name>.proof.html 和 <name>.run.json。 | mise run token-run -- <args> |
validate <tokens> | 检查 DTCG 2025.10 结构、值、名称、引用、类型一致性和循环引用。 | mise run token-validate -- <tokens> |
prove <tokens> <evidence> [sources] | 组装、检查并回读特定于来源的独立证明。 | mise run token-prove -- <args> |
仅通过匹配的 mise run token-help、mise run token-run、mise run token-validate 或 mise run token-prove 操作加载 examples/help.md、examples/generate.md、examples/validate.md 或 examples/prove.md。只有在用户要求绝对唯一性时,才通过 mise run evals 加载 examples/failure-global-claim.md。
维护软件包时,通过 mise run validate 加载 references/generation-contract.md;通过 mise run improvement-policy 加载 references/resource-and-experiment-design.md 和 assets/improvement-contract.json;通过 mise run use-case-policy 加载 references/use-case-specificity.md 和 assets/use-case-contract.json;通过 mise run invocation-policy -- <receipt> 加载 assets/invocation-receipt-template.json。如果 Mise 不可用,则返回 BLOCKED;绝不直接调用私有实现文件。
软件包结构
| 路径 | 内容 | 何时加载或运行 |
|---|---|---|
references/ | 有条件的令牌流程、决策和视觉审查方法。 | 加载 mise run token-packet -- <args> 返回的确切相对路径。 |
assets/ | DTCG 架构、目录、策略、契约、清单和样例。 | 加载 mise run token-packet -- <args> 或其对应策略任务返回的确切路径。 |
assets/exploration-corpus/ | 有界的探索词汇和综合约束。 | 通过 mise run validate-exploration 或其数据包加载。 |
evals/ | 触发、行为、失败、恢复、溯源和评分标准记录。 | 通过 mise run evals 或 Step 24 数据包加载。 |
evals/files/ | 真实的令牌、证据、简报和清单样例。 | 只能通过 mise run evals 或对应的验证或证明任务读取。 |
examples/ | 已验证的命令示例和一个有界失败示例。 | 通过匹配的公共命令任务或 mise run evals 加载。 |
mise.toml | 唯一的任务图、缓存策略和依赖项负责人。 | 运行公共操作或软件包门禁。 |
.github/workflows/ | 远程 CI 路由。 | 远程 CI 只调用 mise run ci。 |
目录名称不会加载文件。仅使用其对应 Mise 任务返回的确切相对路径,并且只在当前决策中使用。
工厂治理
每次更改软件包时,都使用当前的 skill-factory 更新模式。写入前,运行其 mise run plan-standardize -- /absolute/path/to/dtcg-tokens,将基线摘要保存在软件包之外,并观察 RED。之后运行 DTCG 检查,以及工厂的 mise run validate-target -- /absolute/path/to/dtcg-tokens、mise run eval-target -- /absolute/path/to/dtcg-tokens 和 mise run invocation-policy -- <receipt>。最后运行维护任务。缺少回执将导致更新无效。
Mise 生命周期契约
验收前运行 mise run domain-research-policy、mise run use-case-policy、mise run mise-primitives-policy、mise run primitive-lifecycle-policy、mise run task-graph-policy 和 mise run decision-policy。映射所有领域参与者、对象、动作、状态、规则、变体、接口、权威方、故障、恢复、证据、时间、资源、质量、术语和排除项。映射从发现到退役阶段的每个技能正文、参考资料、资产、实现、测试、Mise 任务、示例、评估、策略、架构和记录。
确保每项任务都归入一条默认路径。对于每项不适用的任务,都提供当前且针对具体令牌的证明,并使用 mise run invocation-policy -- <receipt> 验证。在成果工作期间保持 Mise 固定。验收后运行 mise run mise-primitives-update,重新运行 mise run ci,并记录版本和目录摘要。
令牌设计契约
确定性地保持顺序、证据、状态、关卡和声明限制。开放源、意图、令牌内容、视觉语言、样本、交互、视角和材料实验。对于省略的输入类型,通过 mise run token-packet -- <args> 加载 references/extension-protocol.md。通过 mise run font-prepare -- <args> 加载 references/google-font-selection.md;每个字体系列在同一日期的 Google Fonts 目录中都必须排在最热门的 50% 之外,并通过视觉审查。
在正确性、来源覆盖度、创作范围和证明都确定后,再优化耗时。进度需要责任人变更并完成回读;计划、排队中的工作、正在运行的命令和未查看的输出都不算进度。将相互独立的工作批量处理。写入者和视觉判断必须串行进行。
在令牌或关系通过前,通过 mise run token-packet -- <args> 加载 references/controlled-comparisons.md。在查看之前登记存在实质差异的实验。冻结条件、假设、零假设、测量指标、证伪标准和决策规则。除非用户要求,或与缺陷或必需阈值相关,否则拒绝微调。使用当前的视觉、脑力和触觉判断,在规范化编写前锁定胜出方案。
为每个保留的原语和关系提供焦点意图记录,包含 user_task、focus_target、focus_location、focus_timing、focus_mechanism、focus_reason、attention_sequence、competing_signals、defocus_and_recovery 和 failure_evidence。像素必须呈现注意力顺序。令牌负责分配显著性容量,而非产品焦点;令牌不能证明产品层面的聚焦成功。
将纵向和横向视为独立的移动端和平板端情境。证明两者均适用,或说明不适用的理由。仅当旋转会改变可触及范围、安全区域、换行、密度、间距或显著性时,才添加方向关系。任何更改都会使两者的验证失效。
对于多页设计产物,记录规范目标页和原生层级关系。放置在错误页面、重复、孤立、过时或遭到视觉否决,均标记为 BLOCKED。独立生成无需设计应用;Figma 的所有权由其生命周期技能负责。
通过测量关卡后,直接视觉证明具有最高视觉权威。由同一个具备强视觉能力的执行者,在每次更改和失效前后,检查当前的完整视图和细节,覆盖各种状态、视口和输入路径。结构、元数据、指标、哈希、未查看的截图或其他评判均不能授予视觉 PASS。缺少视觉检查则标记为 BLOCKED。
在设计应用中执行 Computer Use 审计时,必须先遵循最高优先级的视觉证明规则,再决定任何事项。同一个发起调用、具备强视觉能力的执行器,必须使用所有适用且可用的视觉能力,以及平台中立的本地应用控制能力,操作并直接检查当前打开的设计应用(包括 Figma),且在每次修改前后都进行检查。Figma 生命周期审计还需要 Figma 技能当前的通过收据和逐项来源处置结果。如果任何必需的视觉、状态或控制路径不可用,该事项即为 BLOCKED。在此类审计之外,此 token 技能可独立运行,不得要求应用控制能力或仅适用于特定产品的提供方。
在整个修改过程中,保持每个 token 画布整洁。开始编写前,通过 mise run token-packet -- <args> 加载 references/qualitative-judgment.md。检查整个画布和活动区域;区分规范、探索、已拒绝和历史工作。标示重叠、裁切、堆叠、残留、顺序错误、无法触及的目标以及过时证据。清理时可以移动、标记或隔离,但未经授权不得抹除证明。必须提供修改前后的收据。
从零信任开始。将继承的 token、声明、证据、样本和判定标记为 STALE,直至当前证明使其通过。先检查,保留已通过的结果,不要为了求新而更改正确的工作。将结果关联到测量或直接判断;绝不宣称完美。
将所有机械操作交由 Mise 管理的任务执行。Mise 任务用于辅助判断,绝不代替判断。mise run token-run -- <args> 会创建 25 条记录;mise run token-packet -- <args>、mise run token-start -- <args>、mise run token-pass -- <args> 和 mise run token-block -- <args> 负责状态转换。具备强视觉能力的模型负责定性决策。若不具备强视觉能力,则委派所有判断,并且在该路径通过前不得生成 token 或证明。
有序工作流
- 冻结令牌结果。 Mise:运行
mise run token-run -- <args>。模型:明确源、意图、受众、交付物、排除项和证据限度。分支:根据请求选择帮助、验证、生成或证明。 - 证明就绪状态和源权威性。 Mise:运行
mise run token-packet -- <args>。模型:检查当前源证据并对每条陈述进行分类。如果:缺少必需的源、权威性或愿景路径,则运行mise run token-block -- <args>并停止该项声明。 - 先扩展,再收窄。 Mise:运行
mise run token-explore -- <args>。模型:创建实质不同且针对特定源的方向,并证伪领先论点。针对每项:记录所有适用的令牌系列、上下文、排除项和反例,每项仅记录一次。 - 开展实质性实验。 Mise:运行
mise run validate-exploration。模型:在冻结的条件下,通过直接观察、思考和触摸判断比较大型备选方案。重复:将未解决的因素送回实验,直到某个方向获得锁定,或真实阻碍因素终止循环。 - 先锁定低层归属,再用于高层。 Mise:仅当实验回执问题已解决后,才运行
mise run token-pass -- <args>。模型:在编写依赖它们的原子、分子、有机体、模板或屏幕之前,先锁定已接受的令牌原语及其关系。如果:低层归属发生变化,则使所有依赖证明失效,并返回最先受影响的步骤。 - 编写并验证令牌。 Mise:运行
mise run token-validate -- <tokens>。模型:仅编写有特定源支持的值,并说明每项省略、别名、关系和例外。如果:符合性验证失败,则修复最低层的令牌归属并重新运行验证。 - 组装并检查证明。 Mise:运行
mise run token-prove -- <args>。模型:检查必需状态、模式、输入、视口和方向下当前的整体视图像素和可读细节像素。针对每项:根据有明确定位的证据,接受、拒绝或阻止每项视觉声明。 - 修复并集成。 Mise:运行
mise run ci。模型:区分结构、源、视觉和交互方面的故障,并修复最低层的归属。重复:重新运行受影响的任务和集成关卡,直到两者均通过或准确记录阻碍因素。 - 返回或还原。 Mise:运行
mise run token-status -- <args>和mise run invocation-policy -- <receipt>。模型:报告交付物、证明、不确定性和局限;仅在不回归合约约束下保留可选改进。停止:在首次达到完全接受的状态时结束,出现任何回归后还原至最后接受的摘要。
执行
generate 和 prove 会按顺序运行全部 25 个步骤。help 不会创建任何内容;validate 仅验证是否符合要求。mise run token-packet -- <args> 会通过 assets/execution-io-map.json、assets/execution-step-contract.json 和 references/deterministic-execution.md 路由精确的输入、输出、负责人、状态和重新运行规则。它会通过 references/execution-intake.md 路由步骤 01 至 08,通过 references/execution-build.md 路由步骤 09 至 17,并通过 references/execution-review.md 路由步骤 18 至 25。从 mise run token-start -- <args> 开始;通过 mise run token-pass -- <args> 或 mise run token-block -- <args> 结束。步骤 12 使用 mise run token-validate -- <tokens>,步骤 17 使用 mise run token-prove -- <args>,步骤 24 使用 mise run ci,步骤 25 使用 mise run token-status -- <args>。仅有任何一项交付物都无法完成此技能。
| # | 步骤 | 使用 | 产出 |
|---|---|---|---|
| 01 | 冻结 | mise run token-run | 运行 |
| 02 | 清点 | mise run token-packet | 清单 |
| 03 | 愿景 | mise run token-packet | 愿景 |
| 04 | 观察 | mise run token-packet | 观察结果 |
| 05 | 分类 | mise run token-packet | 主张 |
| 06 | 证伪 | mise run token-packet | 论点 |
| 07 | 扩展 | mise run token-packet | 范围 |
| 08 | 实验 | mise run token-packet | 试验 |
| 09 | 上下文 | mise run token-packet | 矩阵 |
| 10 | 签名 | mise run token-packet | 签名 |
| 11 | 编写 | mise run token-packet | 令牌 |
| 12 | 验证 | mise run token-validate | 报告 |
| 13 | 证据 | mise run token-packet | 证据 |
| 14 | 证明 | mise run token-packet | 候选项 |
| 15 | 原创性 | mise run token-packet | 审查 |
| 16 | 覆盖范围 | mise run token-packet | 覆盖范围 |
| 17 | 汇编 | mise run token-prove | 证明 |
| 18 | 检查 | mise run token-packet | 视觉结果 |
| 19 | 缺陷 | mise run token-packet | 缺陷 |
| 20 | 不变量 | mise run token-packet | 不变量 |
| 21 | 评判 | mise run token-packet | 评判结果 |
| 22 | 修复 | mise run token-packet | 修复 |
| 23 | 回读 | mise run token-packet | 字节 |
| 24 | 打包 | mise run ci | 验证结果 |
| 25 | 返回 | mise run token-status | 状态 |
边界
- Token 数量不能证明质量。缺乏依据的 token 会对结果产生负面影响。
- 将合规性、源内容特异性、品味、原创性、语料唯一性、非 AI 套话、不变量和证明完整性分别作为独立主张。
- Token JSON 无法证明渲染质量。机器检查无法认证像素。视觉判断不能推翻测量到的失败。
- 实验性 token 可以保留,即使没有通过的使用主张。证明必须与通过项一样清楚地呈现失败和局限。
- 通过
mise run token-packet -- <args>加载references/qualitative-judgment.md,用于判断品味、原创性、语料唯一性和非 AI 套话。 - 通过
mise run token-packet -- <args>应用assets/judgment-review-catalog.json,将其作为不可互相补偿的 token 级门槛。源内容忠实度、语义角色、可访问范围、间距关系、响应式行为、熟悉度、标准、独特性和渲染证明必须逐项通过。 - 将相关项、内嵌项、组、区段、外壳和宽间隔的间距视为语义关系。仅凭规则的比例尺、非寻常的数值或与源内容相似,不能证明分组或节奏良好。
- 将可复用的证明结构称为 token-proof scaffold。
UI composition template仅用于可复用的屏幕结构,Code Connect mapping template仅用于仓库映射产物。 - 全局唯一性不属于此技能的有效主张范围。
完成条件
| 门槛 | 仅在以下条件满足时才算完成 | 检查方式 |
|---|---|---|
| 流水线 | 所有 25 条当前记录及其负责人均已解析。 | mise run token-status -- <args> |
| 交付物 | .tokens.json、.evidence.json、.proof.html 和 .run.json 相互一致。 | mise run token-prove -- <args> |
| 合规性 | 当前 DTCG 字节通过,且退出码为 0。 | mise run token-validate -- <tokens> |
| 记账 | 每个来源、意图、token、上下文、扩展项和排除项都恰好出现一次。 | mise run artifact-contract |
| 探索 | 至少进行三次实验,且每项重要比较都获得锁定。 | mise run validate-exploration |
| 特异性 | 五项源内容衍生决策及符合条件的排版均可追溯到像素。 | mise run font-prepare -- <args> |
| 视觉判断 | 当前覆盖范围、回读、缺陷和不变量均通过,且没有未解决的否决项;globally_unique 保持为 false。 | mise run token-packet -- <args> |
| 打包 | 每个文件都有路由,工厂收据齐全,且 mise run ci 通过。 | mise run audit-files |
如果任一门槛失败或缺少证据,请运行 mise run token-block -- <args>,返回 BLOCKED,列出每个未通过的门槛及确切的恢复要求,并且不要声称结果非套话、具有原创性、语料唯一或已完成。
可选最后一步
仅在所有必需门槛都通过后运行此步骤。冻结最后一个已接受的包、评估器、夹具、环境、时间预算、重复次数和适用的资源指标。在最小范围内,只更改一个明确命名的维度。针对冻结的输入运行 mise run improvement-policy、所属 DTCG 任务和 mise run ci。只有在该维度有实质改善,且正确性、耗时、确定性覆盖率、token 效率、创作范围、实验范围、直接视觉判断、简洁性、可移植性、安全性和当前 DTCG 合约均未退化时,才保留候选版本。否则,恢复最后一个已接受版本及其摘要,然后重新运行其针对性证明。在可编辑包之外记录保留、弃用或崩溃。