章法

1周前发布 22 00

blcaptain-zhangfa(章法)是面向中文网页的设计与验收 Skill。它专为 Codex、Claude Code 等支持读取 SKILL.md 的智能体设计。该工具通过引入真实内容,先梳理读者任务,再设计页面结构、中文排印和视觉主次,并结合「分寸」工具在浏览器环境中进行测量、检查与打磨。它适用于从零构建页面、保留功能优化旧页...

所在地:
dososo
收录时间:
2026-11-08

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

章法

解决的痛点

英文网页的排版规则直接套用在中文上很容易出现问题:语义被生硬拆分(“为什/么”)、窄屏下书名/长标题断句错乱、数字单位被拆开、文字密度失衡。章法会基于真实中文内容做试排,按语义控制断行,同时针对手机、平板重新排布内容优先级、信息密度与交互逻辑。适配场景包含中文长文、活动报名页、产品工具页、规格对比表、后台管理工作台。

核心六步流程:明事 → 成章 → 量字 → 造境 → 验真 → 复核

  1. 明事:确认目标读者、页面要承载的核心任务
  2. 成章:梳理信息结构,搭建页面信息层级
  3. 量字:依托真实中文文本,确定行宽、断点、阅读节奏(对接分寸测量规则)
  4. 造境:视觉主次安排,让文字、图表、功能控件成为页面主角
  5. 验真:在浏览器里跑通完整用户任务,实测交互与布局
  6. 复核:独立复盘整体观感与细节缺陷

配套工具「分寸」负责提供可量化的中文排版指标;章法负责把测量结果转化为设计决策:调整容器、重排内容、保护语义段落,或是重构交互顺序。

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 改进这个中文活动页。
保留日期、票种、条款和报名行为。
先检查真实页面,再改善视觉主次、标题断行和手机布局。
  • 新建页面:写明读者人群、核心动作、原文素材、品牌约束
  • 审阅模式:增加限定词「只审不改」

相关导航