
章法(blcaptain-zhangfa)是爆裂队长开源、面向中文网页的设计验收Skill,专门给Codex、Claude Code这类支持读取SKILL.md的AI智能体使用。核心定位:解决中文网页特有的排版崩坏问题,把中文语义断行、字号行宽、响应适配做成标准化流程,搭配配套工具「分寸」在浏览器里量化测量、生成核验报告,覆盖从零新建页面、存量页面改造、只审阅不修改三类场景。

解决的痛点
英文网页的排版规则直接套用在中文上很容易出现问题:语义被生硬拆分(“为什/么”)、窄屏下书名/长标题断句错乱、数字单位被拆开、文字密度失衡。章法会基于真实中文内容做试排,按语义控制断行,同时针对手机、平板重新排布内容优先级、信息密度与交互逻辑。适配场景包含中文长文、活动报名页、产品工具页、规格对比表、后台管理工作台。
核心六步流程:明事 → 成章 → 量字 → 造境 → 验真 → 复核
- 明事:确认目标读者、页面要承载的核心任务
- 成章:梳理信息结构,搭建页面信息层级
- 量字:依托真实中文文本,确定行宽、断点、阅读节奏(对接分寸测量规则)
- 造境:视觉主次安排,让文字、图表、功能控件成为页面主角
- 验真:在浏览器里跑通完整用户任务,实测交互与布局
- 复核:独立复盘整体观感与细节缺陷
配套工具「分寸」负责提供可量化的中文排版指标;章法负责把测量结果转化为设计决策:调整容器、重排内容、保护语义段落,或是重构交互顺序。
0.3.0版本新增执行约束:开工范围说明、保留字段/路由约定、验证边界;方向探索留存可回溯样例;交付时逐项核对实测结果,无法自动核验的项明确标注待人工复核。
安装方式
git clone https://github.com/dososo/blcaptain-zhangfa.git
复制技能目录到对应宿主路径:
- Codex:
.agents/skills/blcaptain-zhangfa/,调用指令:$blcaptain-zhangfa - Claude Code:
.claude/skills/blcaptain-zhangfa/,调用指令:/blcaptain-zhangfa
保留仓库内
references/、scripts/、agents/、LICENSE、NOTICE;存在同名技能时先对比内容。
浏览器自动化页面检查(搭配分寸)
环境要求:Node.js ≥20.19、Chrome
npm install --save-dev measure-cjk@0.1.0 playwright-core@1.64.1
运行检测脚本:
node <技能目录>/scripts/check-page.mjs --url http://localhost:5173 --out evidence/zhangfa
检测能力:多宽度下溢出、文字裁切、图片加载异常、控件命名、页面异常;滚动触发懒加载,自动截图,输出 report.json。
- 默认仅允许本地回环地址;访问外网页面加
--allow-remote - 本地已有
measure.config.json会沿用原有配置 - 状态标记:
pass/fail/not_run/unknown/not_applicable - 退出码:0=通过,1=页面/规则失败,2=环境/参数异常
自动检测不覆盖读屏、主观审美、真机体验,这类内容标记
MANUAL_PENDING人工验收。
使用示例
使用 $blcaptain-zhangfa 改进这个中文活动页。
保留日期、票种、条款和报名行为。
先检查真实页面,再改善视觉主次、标题断行和手机布局。
- 新建页面:写明读者人群、核心动作、原文素材、品牌约束
- 审阅模式:增加限定词「只审不改」
相关导航


Growth Lab

improve

BrowserSkill

前任.skill

Cowart

ljg-skills






