mcpField
D
dtcg-tokens

dtcg-tokens

github.com/srinitude设计与 UI2303 次安装1 周前更新
代码仓库

关于 dtcg-tokens

dtcg-tokens 是一项设计 Skill,可将可检查的多模态来源证据转化为特定来源的 DTCG 2025.10 令牌文件和证明产物。它结合确定性的 Mise 任务与视觉判断;缺少必要证据或视觉检查时,不予验收。

主要功能

  1. 01生成令牌、证据、证明和运行记录
  2. 02校验结构、取值、引用与循环
  3. 03创建独立 HTML 证明产物
  4. 04通过视觉判断比较设计实验
  5. 05跟踪流程门槛与证据记录

适用场景

  1. 01依据检查过的视觉及其他来源证据构建设计令牌
  2. 02检查 DTCG 文件的结构和引用错误
  3. 03验收前审查特定来源的令牌证明

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/srinitude/skills --skill dtcg-tokens

安装后在 Claude Code 中输入/dtcg-tokens确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.github/workflows/
ci.yml
assets/
creative-source-frontier.json
current-date-policy.json
decision-records.json
dtcg-format-2025.10.schema.json
evidence-template.json
execution-io-map.json
execution-step-contract.json
experiment-contract.json
exploration-strategy-catalog.json
file-trigger-policy.json
google-font-policy.json
improvement-contract.json
invocation-receipt-template.json
judgment-review-catalog.json
mise-primitives-catalog.json
mise-primitives.json
multimodal-input-catalog.json
originality-analysis-contract.json
assets/exploration-corpus/
concepts.json
constraints.json
manifest.json
mechanisms.json
negative-patterns.json
operators.json
primitives.json
questions.json
synthesis-contract.json
technology.json
themes.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 或证明。

有序工作流

  1. 冻结令牌结果。 Mise:运行 mise run token-run -- <args>。模型:明确源、意图、受众、交付物、排除项和证据限度。分支:根据请求选择帮助、验证、生成或证明。
  2. 证明就绪状态和源权威性。 Mise:运行 mise run token-packet -- <args>。模型:检查当前源证据并对每条陈述进行分类。如果:缺少必需的源、权威性或愿景路径,则运行 mise run token-block -- <args> 并停止该项声明。
  3. 先扩展,再收窄。 Mise:运行 mise run token-explore -- <args>。模型:创建实质不同且针对特定源的方向,并证伪领先论点。针对每项:记录所有适用的令牌系列、上下文、排除项和反例,每项仅记录一次。
  4. 开展实质性实验。 Mise:运行 mise run validate-exploration。模型:在冻结的条件下,通过直接观察、思考和触摸判断比较大型备选方案。重复:将未解决的因素送回实验,直到某个方向获得锁定,或真实阻碍因素终止循环。
  5. 先锁定低层归属,再用于高层。 Mise:仅当实验回执问题已解决后,才运行 mise run token-pass -- <args>。模型:在编写依赖它们的原子、分子、有机体、模板或屏幕之前,先锁定已接受的令牌原语及其关系。如果:低层归属发生变化,则使所有依赖证明失效,并返回最先受影响的步骤。
  6. 编写并验证令牌。 Mise:运行 mise run token-validate -- <tokens>。模型:仅编写有特定源支持的值,并说明每项省略、别名、关系和例外。如果:符合性验证失败,则修复最低层的令牌归属并重新运行验证。
  7. 组装并检查证明。 Mise:运行 mise run token-prove -- <args>。模型:检查必需状态、模式、输入、视口和方向下当前的整体视图像素和可读细节像素。针对每项:根据有明确定位的证据,接受、拒绝或阻止每项视觉声明。
  8. 修复并集成。 Mise:运行 mise run ci。模型:区分结构、源、视觉和交互方面的故障,并修复最低层的归属。重复:重新运行受影响的任务和集成关卡,直到两者均通过或准确记录阻碍因素。
  9. 返回或还原。 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 合约均未退化时,才保留候选版本。否则,恢复最后一个已接受版本及其摘要,然后重新运行其针对性证明。在可编辑包之外记录保留、弃用或崩溃。

评论

支持 Markdown