lean-text-scaffolding

Name: lean-text-scaffolding
Author: jpcaparas

github.com/jpcaparas设计与 UI5655 次安装2 天前更新

代码仓库

关于 lean-text-scaffolding

一项精简网页文案的写作技能，帮助减少生成页面中的填充内容，同时保留无障碍和操作所需文本。它提供页面搭建与编辑指南，并包含用于检查 HTML 和 JSX/TSX 文件的脚本。

主要功能

01新页面的精简文案基线
02已有页面的删减规则
03保留无障碍界面文本的指引
04基于 Bun 的 HTML 与 JSX/TSX 审计脚本

适用场景

01为落地页搭建生成文案
02删减页面中的通用标签和填充文字
03检查表单文本，同时保留必要标签

安装

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

$npx skills add https://github.com/jpcaparas/skills --skill lean-text-scaffolding

安装后在 Claude Code 中输入/lean-text-scaffolding确认已加载。

包含的文件

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

AGENTS.md

metadata.json

README.md

skill-card.prompt.md

agents/

openai.yaml

assets/

.gitkeep

evals/

evals.json

references/

research.md

rules.md

scripts/

audit_lean_text.ts

test_skill.py

validate.py

templates/

.gitkeep

详细介绍

精简文案脚手架

避免新搭建的网页充斥冗长的填充文案、泛泛的占位词、装饰性标签和重复的眉题文字。

决策树

你正在构建或编辑什么？

新建网页、落地页、产品页、仪表盘，或带有生成文案的页面版块
应用本文中的精简基线，然后阅读 references/rules.md，了解详细的字数限制。
现有页面显得冗长、泛泛或标签过多
阅读 references/rules.md，删除低价值文字，然后在 Bun 可用时，对修改过的 HTML/JSX/TSX 文件运行 scripts/audit_lean_text.ts。
页面包含表单、筛选器、搜索、设置或其他输入项
保留可见或无障碍标签、图例、辅助文字和错误说明。如果你想用占位符替代标签，请阅读 references/research.md。
用户明确要求详细文案、带标签的版块、内容占位符、文案套件、SEO 文案、法律文案或客户提供的措辞
按照要求执行。保持内容结构清晰，但不要为了遵循精简默认规则而违背明确要求。
任务仅涉及文案、文档，或非网页内容
不要触发此技能。请改用写作或文档技能。

快速参考

情况	默认操作	阅读 / 运行
新搭建的页面	从更少的文字、更少的版块开始，不加装饰性标签	`references/rules.md`
主视觉文案	使用一个清晰的 H1 和一句辅助说明，除非另有要求	`references/rules.md`
功能卡片	使用具体简短的标题；省略泛泛的卡片描述	`references/rules.md`
眉题、徽章、标签	默认省略，除非它们能区分状态、类别或导航	`references/rules.md`
表单和输入项	保留标签、图例、辅助文字、错误提示和无障碍名称	`references/research.md`
审查源文件	标记填充短语、标签泛滥、过长段落和仅含占位符的输入项	`scripts/audit_lean_text.ts`

精简基线

用户没有明确要求更充实的文案时，采用以下默认规则：

只写理解或操作页面所必需的文字。
优先使用一个有力的标题，不要堆叠眉题、标题和副标题。
避免使用“功能”“优势”“解决方案”“客户评价”“新产品”或“值得信赖”等泛泛的版块标签，除非这些标签能改变用户的理解。
避免使用填充型占位文案：Lorem ipsum、“功能一”、“强大的洞察”、“满足你所需的一切”、“一体化平台”、“无缝工作流”以及类似的套话。
不要为了让脚手架显得内容充实而编造统计数据、徽标、客户评价、姓名、引言、徽章或社会认同信息。
保留必要的 UI 文本：导航标签、按钮文字、表头、表单标签、辅助文字、验证错误、空状态和屏幕阅读器名称。
如果页面需要逼真的示例数据才能呈现某种状态，请使用最少量的代表性数据。

默认文案字数限制

元素	默认限制
H1	品牌 / 产品名称，或 3-8 个清晰易懂的词
主视觉辅助文案	1 句话，通常为 12-24 个词
版块标题	2-7 个词；除非有需要，否则不另加标签
功能卡片标题	2-5 个词
功能卡片正文	0-14 个词；如果只是重复标题，则省略
CTA	1-3 个动作词
空状态	1 个标题，加 1 个简短的恢复操作
表单辅助文字	仅在格式、后果或要求不明显时使用

必须保留的内容

精简文案不意味着 UI 可以没有标签。请保留或添加：

表单控件的 <label> 和 <legend> 文本
可见文字缺失或不足时的 aria-label、aria-labelledby 和 aria-describedby
用于说明不常见格式、必填 / 选填区别、破坏性操作和错误的可见辅助文字
脱离上下文也能明确表达含义的链接和按钮文字
用户提供的法规、定价、合同、同意或安全相关措辞

工作流

搭建页面前，推断页面的用途和用户提供的内容。
构建满足请求所需的最精简且可信的页面。
删除装饰性标签、重复副标题、通用卡片、虚构的社会认同内容和填充板块。
保留无障碍和操作相关文本。
如果源文件存在且可使用 Bun，请运行：

bun scripts/audit_lean_text.ts path/to/page.tsx

修复所有未得到用户请求明确支持的问题。

阅读指南

需求	阅读
详细的保留／删减规则、文案篇幅限制和审查启发式	`references/rules.md`
有来源支持的理由和无障碍边界	`references/research.md`
针对 HTML/JSX/TSX 的确定性文件审查	`scripts/audit_lean_text.ts`

注意事项

不要为了让页面看起来更简洁而删除实际标签。 装饰性徽章可有可无；输入标签和无障碍名称不可删除。
不要用模糊表述替代实际内容。“简洁”意味着用更少的字表达具体内容，而不是泛泛而谈。
不要为了营造充实感而堆砌内容。 缺乏依据的额外评价、数据、徽章、常见问题解答、标志和对比模块会让搭建的页面显得更热闹，却更不可信。
不要违背明确的文案要求。 如果用户要求详细的营销文案、带标签的板块或占位内容，就满足该要求并保持结构清晰。
不要把必要说明藏在占位符里。 占位符文本会消失，不能替代标签或持续显示的提示。

支持 Markdown

登录后评论