@huicai/cli 2026.814.0 → 2026.1021.0

package/skills/pptx-author/scripts/pptx_layout.py

@@ -0,0 +1,384 @@
+# PPT 版式计算内核（pptx_deck 建版 / pptx_check 体检 共用同一套度量）。
+#
+# 为什么必须共用：建版时算"这段字放不放得下"和体检时算"这段字有没有溢出"，
+# 只要用两套度量，就一定会出现"生成端说没事、体检端说溢出"的自相矛盾。
+# 一份度量、两个方向用——这是本模块存在的唯一理由。
+#
+# 度量口径（微软雅黑 / 苹方，播放端渲染）：
+#   · 字宽按 em 表逐字累加（中日韩全角 1.0em，数字 0.55em，小写 0.52em…）；
+#   · 行高 1.32×字号（雅黑 ascender 2167 + descender 536 / unitsPerEm 2048）；
+#   · 文本框内边距默认 左右 0.1"、上下 0.05"（PowerPoint 默认值）。
+# 估算不可能与真实排版逐像素一致，所以判溢出留了 TOL 容差，且报告里一律带出
+# "估算高 vs 可用高"的具体数字，让人能自己判断，而不是只丢一个结论。
+
+import re
+
+EMU_IN = 914400          # 1 英寸 = 914400 EMU
+PT_IN = 72.0             # 1 英寸 = 72 磅
+EMU_PT = EMU_IN / PT_IN  # 1 磅 = 12700 EMU
+
+LINE_H = 1.34            # 单倍行距 ≈ 1.34 × 字号（雅黑 (2167+536)/2048=1.32，苹方/黑体略高，取上沿）
+WRAP_SAFETY = 0.98       # 建版侧折行留 2% 余量：字宽估算差一点就可能多折一行，多折一行就是溢出
+INSET_LR = 0.1 * PT_IN   # 文本框默认左右内边距（磅）
+INSET_TB = 0.05 * PT_IN  # 文本框默认上下内边距（磅）
+TOL = 1.02               # 溢出容差：估算超出可用空间 2% 以内不报（度量误差带）
+
+# ── 字宽表（em）────────────────────────────────────────────────────────────
+# 取值不是拍脑袋，是量出来的：对微软雅黑（Windows 播放端的目标字体，unitsPerEm 2048）
+# 与 macOS 上的替换字体（华文黑体 / 冬青黑 / 宋体）逐类实测 advance 后，
+# 取"略宽于主流值"的一档——**宁可略估宽，不可估窄**：
+# 估宽了最多是提前降一号字，估窄了就是"说装得下、实际被切掉"，那才是要命的。
+# 校准脚本见 pptx_layout.py --calibrate（本机有中文字体时可重跑）。
+W_CJK = 1.0
+W_DIGIT = 0.58     # 雅黑 0.550 / 华文黑 0.554 / 冬青 0.657
+W_UPPER = 0.68     # 雅黑 0.635 / 华文黑 0.643 / 冬青 0.708
+W_LOWER = 0.56     # 雅黑 0.537 / 华文黑 0.541 / 冬青 0.552
+W_SPACE = 0.31     # 雅黑 0.264 / 华文黑 0.250 / 冬青 0.333
+W_NARROW = 0.32
+W_WIDE = 0.87
+
+NARROW = set(".,;:!|'`iIljtf()[]{}-")
+WIDE = set("@%&WMmw#")
+
+
+def _full_width(cp):
+    return (
+        0x1100 <= cp <= 0x115F or 0x2E80 <= cp <= 0xA4CF or 0xAC00 <= cp <= 0xD7A3
+        or 0xF900 <= cp <= 0xFAFF or 0xFE30 <= cp <= 0xFE6F or 0xFF00 <= cp <= 0xFF60
+        or 0xFFE0 <= cp <= 0xFFE6 or 0x3000 <= cp <= 0x303F
+    )
+
+
+def char_em(ch):
+    """单字符宽度（em）。"""
+    cp = ord(ch)
+    if ch == ' ':
+        return W_SPACE
+    if ch == '\t':
+        return W_SPACE * 4
+    if _full_width(cp):
+        return W_CJK
+    if cp > 0xFFFF:            # emoji 等星平面字符
+        return 1.15
+    if ch in NARROW:
+        return W_NARROW
+    if ch in WIDE:
+        return W_WIDE
+    if '0' <= ch <= '9':
+        return W_DIGIT
+    if 'A' <= ch <= 'Z':
+        return W_UPPER
+    if 'a' <= ch <= 'z':
+        return W_LOWER
+    if cp < 0x2E80:
+        return W_LOWER
+    return W_CJK
+
+
+def measure(text, size, bold=False):
+    """估算一段文本的渲染宽度（磅）。size 为字号（磅）。"""
+    if not text:
+        return 0.0
+    em = 0.0
+    for ch in str(text):
+        em += char_em(ch)
+    return em * size * (1.035 if bold else 1.0)
+
+
+# 不能出现在行首 / 行尾的标点（中西文）
+NO_START = set('，。、；：？！）」』】》”’%,.;:?!)]}>')
+NO_END = set('（「『【《“‘([{<')
+
+_TOKEN = re.compile(r'[A-Za-z0-9_@#$%\'\-\.]+\s*|\s+|.', re.S)
+
+
+def tokenize(s):
+    """分词：全角字符各自成 token；西文按「词 + 尾随空格」成 token。"""
+    out = []
+    for m in _TOKEN.finditer(s):
+        t = m.group(0)
+        if len(t) == 1 or not t[0].isascii():
+            # 单字符或首字非 ASCII：逐字拆（中文按字断行）
+            for ch in t:
+                out.append(ch)
+        else:
+            out.append(t)
+    return out
+
+
+def wrap(text, size, max_w, bold=False):
+    """按最大宽度折行（中文按字断、西文按词断，含禁头禁尾标点处理）。返回行数组。"""
+    raw = str(text if text is not None else '').replace('\r', '')
+    if not raw:
+        return []
+    if max_w <= 0:
+        return raw.split('\n')
+    out = []
+    for para in raw.split('\n'):
+        if not para.strip():
+            out.append('')
+            continue
+        line, line_w = '', 0.0
+        for tk in tokenize(para):
+            w = measure(tk, size, bold)
+            if line_w > 0 and line_w + w > max_w:
+                carry = ''
+                if line and line[-1] in NO_END:      # 行尾禁尾标点 → 连它一起挪下行
+                    carry, line = line[-1], line[:-1]
+                out.append(line)
+                line = carry + tk
+                line_w = measure(line, size, bold)
+            elif line_w == 0 and w > max_w:
+                buf = ''                              # 单个超长词（长标识符/URL）：硬切
+                for ch in tk:
+                    if measure(buf + ch, size, bold) > max_w and buf:
+                        out.append(buf)
+                        buf = ''
+                    buf += ch
+                line, line_w = buf, measure(buf, size, bold)
+            else:
+                line += tk
+                line_w += w
+            if out and line and line[0] in NO_START:  # 禁头标点回拉上一行
+                out[-1] += line[0]
+                line = line[1:]
+                line_w = measure(line, size, bold)
+        if line:
+            out.append(line)
+    return out
+
+
+def wrap_segments(segs, max_w):
+    """多段（字号/粗细各异）混排折行。segs=[(text,size,bold)]，返回 [(行文本, 行高磅)]。
+
+    真实幻灯片里一段话常混着不同字号的 run（正文 + 强调数字），
+    按最大字号一刀切会把高度算虚。这里按 token 逐个累加，行高取该行最大字号。
+    """
+    lines = []
+    cur, cur_w, cur_size = '', 0.0, 0.0
+    for text, size, bold in segs:
+        for part_i, para in enumerate(str(text if text is not None else '').replace('\r', '').split('\n')):
+            if part_i > 0:                    # 段内硬换行
+                lines.append((cur, max(cur_size, size)))
+                cur, cur_w, cur_size = '', 0.0, 0.0
+            for tk in tokenize(para):
+                w = measure(tk, size, bold)
+                if cur_w > 0 and cur_w + w > max_w:
+                    lines.append((cur, max(cur_size, size)))
+                    cur, cur_w, cur_size = tk, w, size
+                else:
+                    cur += tk
+                    cur_w += w
+                    cur_size = max(cur_size, size)
+    if cur or not lines:
+        lines.append((cur, cur_size or 18.0))
+    return lines
+
+
+def text_height(lines, line_spacing=1.0):
+    """行数组（wrap_segments 结果）→ 总高（磅）。"""
+    return sum(h * LINE_H * line_spacing for _, h in lines)
+
+
+def fit_size(text, box_w, box_h, hi=24.0, lo=14.0, bold=False, step=1.0, line_spacing=1.0):
+    """在 [lo, hi] 内找能装进 box 的最大字号；装不下返回 lo（调用方据此决定拆页）。"""
+    s = hi
+    while s > lo:
+        ls = wrap_segments([(text, s, bold)], box_w)
+        if text_height(ls, line_spacing) <= box_h:
+            return s
+        s -= step
+    return lo
+
+
+def clip(text, size, max_w, max_lines, bold=False):
+    """按最大行数裁断并加省略号（固定高度的标签框用）。装得下就原样返回。"""
+    lines = wrap(text, size, max_w, bold)
+    if len(lines) <= max_lines:
+        return str(text if text is not None else '')
+    kept = lines[:max_lines]
+    last = kept[-1]
+    while last and measure(last + '…', size, bold) > max_w:
+        last = last[:-1]
+    kept[-1] = (last or kept[-1][:2]) + '…'
+    return '\n'.join(kept)
+
+
+def fits(text, size, box_w, box_h, bold=False, line_spacing=1.0):
+    ls = wrap_segments([(text, size, bold)], box_w)
+    return text_height(ls, line_spacing) <= box_h
+
+
+# ── 几何 ────────────────────────────────────────────────────────────────────
+class Rect:
+    """矩形（单位任意，本库内统一用英寸）。"""
+
+    __slots__ = ('x', 'y', 'w', 'h')
+
+    def __init__(self, x, y, w, h):
+        self.x, self.y, self.w, self.h = float(x), float(y), float(w), float(h)
+
+    @property
+    def right(self):
+        return self.x + self.w
+
+    @property
+    def bottom(self):
+        return self.y + self.h
+
+    @property
+    def area(self):
+        return max(0.0, self.w) * max(0.0, self.h)
+
+    def inset(self, dx, dy=None):
+        dy = dx if dy is None else dy
+        return Rect(self.x + dx, self.y + dy, self.w - 2 * dx, self.h - 2 * dy)
+
+    def intersect(self, o):
+        x, y = max(self.x, o.x), max(self.y, o.y)
+        r, b = min(self.right, o.right), min(self.bottom, o.bottom)
+        return Rect(x, y, max(0.0, r - x), max(0.0, b - y))
+
+    def overlap_ratio(self, o):
+        """重叠面积 / 两者中较小者的面积（0~1）。"""
+        a = self.intersect(o).area
+        m = min(self.area, o.area)
+        return 0.0 if m <= 0 else a / m
+
+    def contains(self, o, tol=0.0):
+        return (self.x - tol <= o.x and self.y - tol <= o.y
+                and self.right + tol >= o.right and self.bottom + tol >= o.bottom)
+
+    def __repr__(self):
+        return f'Rect({self.x:.2f},{self.y:.2f},{self.w:.2f}×{self.h:.2f})'
+
+
+def contain_fit(nat_w, nat_h, box):
+    """按原始宽高比等比放进 box 并居中（绝不拉伸——图片变形的根治法）。"""
+    if nat_w <= 0 or nat_h <= 0:
+        return Rect(box.x, box.y, box.w, box.h)
+    s = min(box.w / nat_w, box.h / nat_h)
+    w, h = nat_w * s, nat_h * s
+    return Rect(box.x + (box.w - w) / 2, box.y + (box.h - h) / 2, w, h)
+
+
+# ── 配色与对比度 ────────────────────────────────────────────────────────────
+# 配色按**角色**定义，而不是"一堆好看的颜色"：每个角色都写明"画在什么底上"，
+# 于是对比度可以被计算、被保证——深色主题也就自然成立（页底、卡片底一起翻）。
+#   bg 页底 / head 标题字 / text 正文字 / muted 次要字（都画在 bg 上）
+#   primary 大色块填充 / on_primary 画在其上的字
+#   light   卡片浅底填充 / on_light   画在其上的字
+#   accent  强调线与小色块
+THEMES = {
+    'navy': dict(bg='FFFFFF', head='1F4E79', text='2F3437', muted='5F6A73',
+                 primary='1F4E79', on_primary='FFFFFF', light='DEEBF7', on_light='1B3A57', accent='2E75B6'),
+    'tech': dict(bg='FFFFFF', head='4B2E83', text='2F3437', muted='605A6B',
+                 primary='4B2E83', on_primary='FFFFFF', light='EDE7FB', on_light='3B2467', accent='7C4DDA'),
+    'mono': dict(bg='FFFFFF', head='2B2B2B', text='2F3437', muted='5E5E5E',
+                 primary='2B2B2B', on_primary='FFFFFF', light='F1F1F1', on_light='2B2B2B', accent='595959'),
+    'warm': dict(bg='FFFFFF', head='9C4708', text='3B3B3B', muted='6E5B4C',
+                 primary='9C4708', on_primary='FFFFFF', light='FBE5D6', on_light='7A3706', accent='C55A11'),
+    'green': dict(bg='FFFFFF', head='176346', text='2F3437', muted='566B60',
+                  primary='176346', on_primary='FFFFFF', light='DFF3EA', on_light='12513A', accent='2FA37A'),
+    'dark': dict(bg='0F172A', head='8FC2FF', text='E6EDF6', muted='A9B6C6',
+                 primary='111C2E', on_primary='FFFFFF', light='1E2A3F', on_light='E6EDF6', accent='5AA9FF'),
+}
+
+
+def hex_rgb(s):
+    s = str(s or '').lstrip('#')
+    if len(s) != 6:
+        return None
+    try:
+        return tuple(int(s[i:i + 2], 16) for i in (0, 2, 4))
+    except ValueError:
+        return None
+
+
+def _lin(c):
+    c = c / 255.0
+    return c / 12.92 if c <= 0.03928 else ((c + 0.055) / 1.055) ** 2.4
+
+
+def luminance(rgb):
+    r, g, b = rgb
+    return 0.2126 * _lin(r) + 0.7152 * _lin(g) + 0.0722 * _lin(b)
+
+
+def contrast(fg, bg):
+    """WCAG 对比度（1~21）。任一色解析不出返回 None（宁可不报，也不瞎报）。"""
+    if not fg or not bg:
+        return None
+    a, b = luminance(fg), luminance(bg)
+    hi, lo = max(a, b), min(a, b)
+    return (hi + 0.05) / (lo + 0.05)
+
+
+def readable_on(bg_hex):
+    """给定底色，返回可读的前景色（深底出白字、浅底出深字）。"""
+    rgb = hex_rgb(bg_hex) or (255, 255, 255)
+    return 'FFFFFF' if luminance(rgb) < 0.42 else '2F3437'
+
+
+def pick_fg(bg, prefer=(), min_ratio=4.5):
+    """在给定底色上挑一个对比度达标的前景色：按 prefer 顺序试，都不达标就退到黑/白。
+
+    配色不该靠"看着还行"，尤其是浅底浅字这种在屏幕上勉强、投影上直接消失的组合。
+    建版时每次写字都过一遍这里，产物就不可能出现对比度不足。
+    """
+    b = hex_rgb(bg)
+    for c in list(prefer) + ['2F3437', 'FFFFFF', '000000']:
+        if c and (contrast(hex_rgb(c), b) or 0) >= min_ratio:
+            return c
+    return readable_on(bg)
+
+
+def _calibrate(font_paths=(), corpus=()):
+    """把字宽表与真实字体对一遍（需要 Pillow 且本机有中文字体）。
+
+    这张表迟早会被质疑"数字是哪来的"。答案是量出来的，而且随时可以重量：
+        python pptx_layout.py --calibrate
+    输出每条语料的"估算 vs 真实"偏差；**低估**（负值）多且大就该调宽字宽表。
+    """
+    from PIL import ImageFont
+    import glob
+    paths = list(font_paths) or [p for p in glob.glob('/System/Library/Fonts/**/*.tt*', recursive=True)
+                                 + glob.glob('C:/Windows/Fonts/*.tt*')
+                                 + glob.glob('/usr/share/fonts/**/*.tt*', recursive=True)
+                                 if any(k in p for k in ('Heiti', 'Hiragino', 'PingFang', 'msyh', 'simhei', 'Noto'))]
+    corpus = list(corpus) or [
+        '营收 3.6 亿元，同比增长 18%', '毛利率 32.5%，环比 +1.2pct', '华东区新签 12 个大客户',
+        'Q3 OKR 复盘与下季度规划', 'deployment pipeline 全链路可观测',
+        '这是一条相当长的要点内容，用来验证折行与溢出判定是否准确无误',
+    ]
+    out = []
+    for path in paths:
+        try:
+            ft = ImageFont.truetype(path, 1000)
+            # 真有中文字形才算数：只看 advance 会把一堆没有汉字的 Noto 分支字体
+            # 也当成中文字体（它们对缺字返回 .notdef 的宽度，同样 > 0）
+            # 真有中文字形才算数：拿一个私用区码位当"缺字"参照，字形位图一样就说明
+            # 这个字体根本没有汉字（只看 advance 会把一堆 Noto 分支字体误判成中文字体）
+            # 真有中文字形才算数：拿一个私用区码位当"缺字"参照，画出来一样就说明
+            # 这个字体根本没有汉字（只看 advance 会把一堆 Noto 分支字体误判成中文字体）
+            if bytes(ft.getmask('慧')) == bytes(ft.getmask('\ue123')):
+                continue
+        except Exception:
+            continue
+        errs = [(measure(t, 1000) - ft.getlength(t)) / max(1.0, ft.getlength(t)) for t in corpus]
+        out.append((path.split('/')[-1], min(errs), sum(errs) / len(errs), max(errs)))
+    return out
+
+
+if __name__ == '__main__':
+    import sys as _s
+    if '--calibrate' in _s.argv:
+        rows = _calibrate()
+        if not rows:
+            print('本机未找到中文字体，跳过校准。')
+        for name, lo, avg, hi in rows:
+            # -5% 以内是接受带（建版侧还有 WRAP_SAFETY 兜 2%），超了才真该调表
+            flag = '  ← 低估超接受带，需调宽字宽表' if lo < -0.05 else ''
+            print(f'{name:28} 偏差 最低 {lo * 100:+.1f}%  平均 {avg * 100:+.1f}%  最高 {hi * 100:+.1f}%{flag}')
+    else:
+        print(__doc__ or 'pptx_layout：版式度量内核。用 --calibrate 校准字宽表。')

package/skills/pptx-author/trigger-cases.json

@@ -0,0 +1,15 @@
+{
+  "skill": "pptx-author",
+  "purpose": "触发行为规格。CI 按词法跑：正样例须在描述词汇上明显压过近似负样例，且路由到自己。改 description 后必须重跑 skill-lint route。",
+  "intentionalOverlap": ["slides-html"],
+  "cases": [
+    { "id": "direct-ppt", "prompt": "帮我做个 PPT 汇报材料", "shouldTrigger": true },
+    { "id": "pptx-file", "prompt": "生成一个 pptx 演示文稿，讲季度经营情况", "shouldTrigger": true },
+    { "id": "slides-plain", "prompt": "做几页幻灯片把这个方案讲清楚", "shouldTrigger": true },
+    { "id": "check-layout", "prompt": "检查这个 PPT 的排版版式有没有问题", "shouldTrigger": true },
+    { "id": "fix-deck", "prompt": "演示文稿文字溢出、元素重叠，修复版式", "shouldTrigger": true },
+    { "id": "near-miss-word", "prompt": "帮我写一份 Word 项目总结报告", "shouldTrigger": false },
+    { "id": "near-miss-excel", "prompt": "把这张表做成透视表看看趋势", "shouldTrigger": false },
+    { "id": "near-miss-contract", "prompt": "帮我审一下这份合同", "shouldTrigger": false }
+  ]
+}

package/skills/pr-comms/trigger-cases.json

@@ -0,0 +1,30 @@
+{
+  "skill": "pr-comms",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "写个新闻稿和官方声明",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "危机公关怎么分级响应，媒体问答怎么准备",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "高管发言稿和舆情分析报表",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "写一篇小红书种草笔记",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "做一次客诉话术准备",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/procurement-supply/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "procurement-supply",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "做询比价分析和供应商评估评分卡",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "ABC 库存分析，呆滞料怎么处理",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "采购降本报告和周转率怎么看",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次生产排程的物料齐套",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份物流运费对账",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/product-design/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "product-design",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "写个 PRD 产品需求文档",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "用户故事和验收标准怎么写",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "竞品拆解和埋点方案怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次界面可用性测试整改",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份项目立项申请",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/production-planning/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "production-planning",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "排产，这个交期能不能接",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "MRP 净需求运算和产能负荷怎么算",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "插单评估和缺料管理怎么做",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次采购比价和供应商评估",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份设备保养计划",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/project-management/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "project-management",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "做项目计划和甘特图",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "项目风险登记册和周报怎么写",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "延期了怎么办，变更和资源怎么管",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "做一次迭代排期的故事点估算",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份产品需求文档",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/project-proposal/trigger-cases.json

@@ -0,0 +1,31 @@
+{
+  "skill": "project-proposal",
+  "cases": [
+    {
+      "id": "pos-1",
+      "prompt": "写个项目申报书和可研报告",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-2",
+      "prompt": "高新认定和科研课题申请怎么准备",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-3",
+      "prompt": "申报预算编制和评审自查",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-1",
+      "prompt": "解读一份政策看能享受什么",
+      "shouldTrigger": false,
+      "lexical": false
+    },
+    {
+      "id": "neg-2",
+      "prompt": "写一份商业计划书",
+      "shouldTrigger": false
+    }
+  ]
+}

package/skills/prose-standard/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: prose-standard
+description: 判断一段注释/文档/提示词/报错文案该写多少、哪些必须写、哪些是废话。当用户说"注释太多/太少""这段说明写得怎么样""帮我精简一下文档""审查一下这些注释"，或你自己在写注释与 JSDoc 拿不准该写到什么程度时使用。核心判据是「契约」：调用方依赖的义务与不变式必须写，代码已经说清的一律不写。
+version: 1.0.0
+---
+
+# 散文标准：写够契约，然后删掉其余
+
+一句话方法：**先把契约写足，再把推理转录、重复和装饰删干净。**
+
+## 什么是「契约」
+
+契约 = 某一方**依赖**的东西：义务、不变式、前置/后置条件、兼容性承诺。
+判断某句话该不该留，问：**去掉它之后，调用方/实现方/消费方会不会做错事？**
+
+- 会 → 是契约，必须留（哪怕它很长）。
+- 不会 → 是装饰，删掉（哪怕它很短）。
+
+长度不是判据。一段三十行、句句在讲「为什么必须这样、否则会怎样」的注释是资产；
+一行「// 设置 x 为 1」是负债。
+
+## 必须写的四类
+
+1. **非显然的义务**：调用方必须先做什么、不能做什么。
+   （「必须先 read_file 再 write_file，否则……」）
+2. **不变式**：这段代码始终为真、且靠人维护的性质。
+   （「这一段以下不要再添加稳定内容」）
+3. **反直觉的取舍**：为什么不用那个看起来更明显的做法。
+   **写成反事实，不写成变更史**——见 [trim-cot-leakage](../trim-cot-leakage/SKILL.md) 第 3 类。
+4. **失败语义**：出错时会发生什么、调用方该怎么办、什么情况下不该重试。
+
+## 一律不写的五类
+
+1. 代码已经说清的（`// 递增计数器` 配 `count++`）。
+2. 控制流复述（「先 A，然后 B，最后 C」）。
+3. 对着评审者的自辩（「这里的类型转换是安全的，因为……」——
+   要么写清让它安全的那条不变式，要么删掉）。
+4. 犹豫与占位（「暂时应该够用」「先这样」）——升级成 `TODO`/`FIXME` 并写清真实边界，或删。
+5. 装饰性分节、重复的标题、把同一件事换个说法再说一遍。
+
+## 用法
+
+1. **先要范围**。没有明确范围就问，别自作主张扫全仓。
+2. **逐段判定**，每段给出三选一：`保留` / `重写为契约` / `删除`，并写明理由属于上面哪一条。
+3. **审查任务只报不改**；用户明确说了「改」「精简」「修」才动手。
+4. 报错文案、工具描述、界面提示同样适用——它们也是给人读的散文，
+   而且**读它们的人正处在出错的当口**，比注释更需要「结论 + 下一步」。
+
+## 与相邻技能的分工
+
+- 这条管**该写什么、写多少**。
+- [trim-cot-leakage](../trim-cot-leakage/SKILL.md) 管**清掉写作过程留下的痕迹**。
+- [eng-docs](../eng-docs/SKILL.md) 管**放在哪一层文档里、篇幅上限是多少**。

package/skills/prose-standard/trigger-cases.json

@@ -0,0 +1,23 @@
+{
+  "skill": "prose-standard",
+  "purpose": "触发行为规格。负样例分两类：不同词汇的近邻走词法层（CI 跑），同词汇不同意图的近邻标 lexical:false 归行为层。",
+  "cases": [
+    { "id": "too-many-comments", "prompt": "这个文件注释是不是太多了，帮我看看哪些该留哪些是废话", "shouldTrigger": true },
+    { "id": "judge-doc-quality", "prompt": "这段说明写得怎么样，该写的契约写全了吗", "shouldTrigger": true },
+    { "id": "trim-prose", "prompt": "帮我精简一下这几段注释，别把有用的信息删掉", "shouldTrigger": true },
+    { "id": "error-message-wording", "prompt": "这条报错文案该写多少信息才够用户判断下一步", "shouldTrigger": true },
+    {
+      "id": "near-miss-translate",
+      "prompt": "把这份英文说明翻译成中文",
+      "shouldTrigger": false,
+      "note": "词汇不重合（翻译 vs 契约/精简），词法层能干净分开。"
+    },
+    {
+      "id": "near-miss-write-doc",
+      "prompt": "给这个模块补一份使用文档",
+      "shouldTrigger": false,
+      "lexical": false,
+      "note": "与「判断该写多少」共用「文档/写」——同词汇不同意图（写新文档 vs 判定既有散文），词法层分不开，归行为层。"
+    }
+  ]
+}