@huicai/cli 2026.814.0 → 2026.1021.0

package/skills/xlsx-analysis/scripts/xlsx_layout.py

@@ -0,0 +1,235 @@
+# Excel 报表呈现度量与规范内核（xlsx_build 建表 / xlsx_check 体检 共用同一套度量）。
+#
+# 为什么必须共用：建表时算「这一列要多宽」和体检时算「这一列会不会显示成 ####」，
+# 只要用两套度量，就一定会出现「生成端说够宽、体检端说被挤掉」的自相矛盾。
+# 一份度量、两个方向用——与 pptx_layout / docx_layout 同一条纪律。
+#
+# 度量口径（Excel 默认字体 Calibri 11 / 中文等线 11）：
+#   · 列宽单位是「'0' 字符的宽度」，w 列宽 ≈ (w×7+5) 像素（96dpi）；
+#   · 中日韩字符按 2 个单位算，数字与半角字母按 1 个；
+#   · **数字列宽度不够会显示成 ####**（文本只是溢出，还看得见）——所以宽度检查只对数字列是必修。
+# 估算不可能与 Excel 逐像素一致，所以留了 PAD 余量，报告一律带出「需要 vs 实际」的具体数字。
+
+import datetime
+import re
+
+PX_PER_UNIT = 7.0        # 一个列宽单位 ≈ 7 像素（Calibri 11 的 '0' 宽）
+PX_BASE = 5.0            # 单元格左右内边距合计 ≈ 5 像素
+DPI = 96.0
+CM_PER_IN = 2.54
+PAD = 2.2                # 列宽余量（单位）：估窄了就是 ####，估宽一点最多是留白
+MAX_WIDTH = 60.0         # 单列上限：再宽就该换行或拆列，不是加宽
+MIN_WIDTH = 4.0
+
+# A4 可用宽度（厘米），扣掉常规页边距 1.8cm×2
+PAGE = {'A4': {'w': 21.0, 'h': 29.7}, 'A3': {'w': 29.7, 'h': 42.0}}
+
+
+def disp_len(v, number_format=None):
+    """一个值在单元格里**显示出来**有多长（列宽单位）。中日韩按 2 算。
+
+    关键是按 number_format 算显示形态而不是按原始值：12345.6 在 '#,##0.00' 下显示为
+    '12,345.60'（9 位）而不是 '12345.6'（7 位）——差这 2 位就是 #### 与不 #### 的分界。
+    """
+    if v is None:
+        return 0
+    if isinstance(v, bool):
+        return 5
+    if isinstance(v, (datetime.datetime, datetime.date)):
+        return 10 if not number_format or 'h' not in str(number_format).lower() else 19
+    if isinstance(v, (int, float)):
+        return _num_len(v, number_format)
+    s = str(v)
+    return sum(2 if ord(ch) > 0x2E7F else 1 for ch in s)
+
+
+def _num_len(v, fmt):
+    fmt = str(fmt or 'General')
+    if '%' in fmt:
+        dec = _decimals(fmt)
+        return len(f'{abs(v) * 100:,.{dec}f}') + (1 if v < 0 else 0) + 1
+    if fmt in ('General', '@', ''):
+        s = repr(float(v)) if isinstance(v, float) else str(v)
+        return len(s.rstrip('0').rstrip('.')) if '.' in s else len(s)
+    dec = _decimals(fmt)
+    body = f'{abs(v):,.{dec}f}' if ',' in fmt else f'{abs(v):.{dec}f}'
+    n = len(body)
+    if v < 0:
+        n += 2 if '(' in fmt or '（' in fmt else 1
+    if '¥' in fmt or '￥' in fmt or '$' in fmt:
+        n += 1
+    return n
+
+
+def _decimals(fmt):
+    m = re.search(r'\.(0+)', str(fmt))
+    return len(m.group(1)) if m else 0
+
+
+def col_width(values, header=None, number_format=None, min_w=MIN_WIDTH, max_w=MAX_WIDTH):
+    """按内容算列宽（Excel 列宽单位）。表头也参与——表头被挤掉比数据被挤掉更常见。"""
+    n = max([disp_len(header)] + [disp_len(v, number_format) for v in values] or [0])
+    return round(max(min_w, min(n + PAD, max_w)), 2)
+
+
+def width_needed(values, header=None, number_format=None):
+    """不加余量的净需求宽度——体检判「够不够」用它，建表用 col_width（带余量）。"""
+    return max([disp_len(header)] + [disp_len(v, number_format) for v in values] or [0])
+
+
+def width_cm(width_units):
+    """列宽单位 → 厘米（用于估算打印页宽）。"""
+    return (float(width_units) * PX_PER_UNIT + PX_BASE) / DPI * CM_PER_IN
+
+
+def print_pages_wide(widths, page='A4', landscape=True, margin_cm=1.8, scale=1.0):
+    """这张表打印出来会横跨几页。> 1 就该改横向 / 缩放 / 拆表——打印跨页是报表交付件最常见的丢人现场。"""
+    p = PAGE.get(str(page).upper(), PAGE['A4'])
+    usable = (p['h'] if landscape else p['w']) - margin_cm * 2
+    total = sum(width_cm(w) for w in widths) * float(scale or 1.0)
+    return max(1, int(total / usable) + (1 if total % usable > 0.01 else 0)), round(total, 2), round(usable, 2)
+
+
+# ── 数字格式档位 ───────────────────────────────────────────────────────────
+# 一列一个格式，全表统一——「同一列有的两位小数有的整数」是报表最扎眼的不专业。
+FORMATS = {
+    'amount': '#,##0.00',          # 金额：千分位两位
+    'amount0': '#,##0',            # 金额（整数元）
+    'accounting': '#,##0.00;[红色](#,##0.00)',   # 会计：负数红色括号
+    'int': '#,##0',
+    'percent': '0.0%',
+    'percent2': '0.00%',
+    'date': 'yyyy-mm-dd',
+    'datetime': 'yyyy-mm-dd hh:mm',
+    'month': 'yyyy-mm',
+    'text': '@',                   # 强制文本：身份证/订单号/前导零编码必须用它
+    'general': 'General',
+}
+
+AMOUNT_HINTS = ('金额', '贷方', '借方', '余额', '税额', '价税', '收入', '成本', '费用',
+                '单价', '工资', '总额', '应收', '应付', '预收', '预付', '销售额', '利润')
+INT_HINTS = ('数量', '件数', '人数', '笔数', '台数', '个数', '订单数', '次数')
+PCT_HINTS = ('占比', '比率', '率', '百分比', '增幅', '同比', '环比', '完成率', '达成率')
+DATE_HINTS = ('日期', '时间', '月份', '期间', '账期', '年月')
+TEXT_HINTS = ('编码', '编号', '代码', '身份证', '手机', '电话', '卡号', '单号', '工号', '邮编')
+
+
+def guess_format(header, values=()):
+    """按列名 + 取样值猜数字格式。猜不准返回 general——**宁可不猜，也不要猜错**：
+    把订单号猜成数字会丢前导零，把金额猜成文本会让 SUM 得 0，两者都比不加格式更糟。"""
+    h = str(header or '')
+    if any(k in h for k in TEXT_HINTS):
+        return FORMATS['text']
+    if any(k in h for k in PCT_HINTS):
+        return FORMATS['percent']
+    if any(k in h for k in DATE_HINTS):
+        return FORMATS['date']
+    if any(k in h for k in AMOUNT_HINTS):
+        return FORMATS['amount']
+    if any(k in h for k in INT_HINTS):
+        return FORMATS['int']
+    nums = [v for v in values if isinstance(v, (int, float)) and not isinstance(v, bool)]
+    if nums and len(nums) >= max(1, len(list(values)) * 0.8):
+        return FORMATS['amount'] if any(isinstance(v, float) and v != int(v) for v in nums) else FORMATS['int']
+    dates = [v for v in values if isinstance(v, (datetime.date, datetime.datetime))]
+    if dates and len(dates) >= max(1, len(list(values)) * 0.8):
+        return FORMATS['date']
+    return FORMATS['general']
+
+
+# ── 主题（配色 + 行高 + 边框）───────────────────────────────────────────────
+THEMES = {
+    'navy':  {'head_bg': '1F4E79', 'head_fg': 'FFFFFF', 'stripe': 'F2F6FA',
+              'border': 'D9D9D9', 'total_bg': 'DCE6F1', 'title_fg': '1F4E79'},
+    'green': {'head_bg': '1E6B52', 'head_fg': 'FFFFFF', 'stripe': 'F1F8F4',
+              'border': 'D9E6DF', 'total_bg': 'D9EDE3', 'title_fg': '1E6B52'},
+    'mono':  {'head_bg': '404040', 'head_fg': 'FFFFFF', 'stripe': 'F5F5F5',
+              'border': 'D0D0D0', 'total_bg': 'E8E8E8', 'title_fg': '303030'},
+    'warm':  {'head_bg': 'B3541E', 'head_fg': 'FFFFFF', 'stripe': 'FDF4EE',
+              'border': 'EBD9CC', 'total_bg': 'F7E2D3', 'title_fg': 'B3541E'},
+}
+
+PROFILES = {
+    'report': {
+        'name': 'report', 'label': '业务报表（表头深色/斑马纹/冻结/筛选/千分位/打印一页宽）',
+        'theme': 'navy', 'font': '等线', 'font_west': 'Calibri', 'size': 11,
+        'head_size': 11, 'head_bold': True, 'title_size': 14,
+        'stripe': True, 'freeze': True, 'autofilter': True, 'borders': True,
+        'row_height': 18, 'head_height': 22,
+        'print': {'page': 'A4', 'landscape': True, 'fit_width': True, 'repeat_head': True,
+                  'margin_cm': 1.8, 'footer_page': True},
+    },
+    'plain': {
+        'name': 'plain', 'label': '素表（无底纹、便于再加工与二次透视）',
+        'theme': 'mono', 'font': '等线', 'font_west': 'Calibri', 'size': 11,
+        'head_size': 11, 'head_bold': True, 'title_size': 12,
+        'stripe': False, 'freeze': True, 'autofilter': True, 'borders': True,
+        'row_height': 16, 'head_height': 18,
+        'print': {'page': 'A4', 'landscape': False, 'fit_width': True, 'repeat_head': True,
+                  'margin_cm': 1.8, 'footer_page': True},
+    },
+    'finance': {
+        'name': 'finance', 'label': '财务报表（会计格式/负数红括号/小计加粗上框线）',
+        'theme': 'navy', 'font': '等线', 'font_west': 'Calibri', 'size': 11,
+        'head_size': 11, 'head_bold': True, 'title_size': 14,
+        'stripe': False, 'freeze': True, 'autofilter': False, 'borders': True,
+        'row_height': 18, 'head_height': 22, 'default_amount': 'accounting',
+        'print': {'page': 'A4', 'landscape': False, 'fit_width': True, 'repeat_head': True,
+                  'margin_cm': 1.8, 'footer_page': True},
+    },
+}
+PROFILE_NAMES = list(PROFILES)
+
+
+def profile(name='report'):
+    p = PROFILES.get(str(name or 'report').strip(), PROFILES['report'])
+    out = {k: (dict(v) if isinstance(v, dict) else v) for k, v in p.items()}
+    out['colors'] = dict(THEMES.get(out['theme'], THEMES['navy']))
+    return out
+
+
+# ── 单元格坐标 ─────────────────────────────────────────────────────────────
+def col_letter(idx):
+    """1 → A，27 → AA。"""
+    s = ''
+    while idx > 0:
+        idx, r = divmod(idx - 1, 26)
+        s = chr(65 + r) + s
+    return s
+
+
+def col_index(letter):
+    n = 0
+    for ch in str(letter).upper():
+        if 'A' <= ch <= 'Z':
+            n = n * 26 + ord(ch) - 64
+    return n
+
+
+A1_RE = re.compile(r'(?<![A-Z0-9_])(\$?)([A-Z]{1,3})(\$?)(\d{1,7})(?![A-Z0-9_(])')
+RANGE_RE = re.compile(r'(\$?[A-Z]{1,3}\$?\d{1,7})\s*:\s*(\$?[A-Z]{1,3}\$?\d{1,7})')
+ERR_VALUES = ('#REF!', '#DIV/0!', '#N/A', '#VALUE!', '#NAME?', '#NUM!', '#NULL!', '#SPILL!', '#CALC!')
+VOLATILE = ('TODAY(', 'NOW(', 'RAND(', 'RANDBETWEEN(', 'INDIRECT(', 'OFFSET(')
+
+
+def self_test():
+    p = profile('report')
+    assert p['colors']['head_bg'] == '1F4E79'
+    assert disp_len('销售额') == 6 and disp_len('abc') == 3
+    assert disp_len(12345.6, '#,##0.00') == 9, disp_len(12345.6, '#,##0.00')
+    assert disp_len(-12345.6, '#,##0.00') == 10
+    assert disp_len(0.1234, '0.0%') == 5, disp_len(0.1234, '0.0%')     # '12.3%'
+    assert col_width(['甲', '乙'], '销售额(万元)') >= 13
+    assert col_letter(1) == 'A' and col_letter(27) == 'AA' and col_index('AA') == 27
+    assert guess_format('订单编号') == '@' and guess_format('销售额') == '#,##0.00'
+    assert guess_format('完成率') == '0.0%' and guess_format('记账日期') == 'yyyy-mm-dd'
+    assert guess_format('说明', ['甲', '乙']) == 'General'
+    n, total, usable = print_pages_wide([20] * 20)
+    assert n >= 2, (n, total, usable)
+    assert print_pages_wide([12, 10, 10])[0] == 1
+    print(f'[xlsx_layout] self-test OK · {len(PROFILES)} 档规范 / {len(THEMES)} 套主题 / '
+          f'A4 横向可用宽 {print_pages_wide([1])[2]}cm')
+
+
+if __name__ == '__main__':
+    self_test()

package/skills/xlsx-analysis/scripts/xlsx_style.py

@@ -1,71 +1,33 @@
-# xlsx 格式化回写助手（经 run_python 执行）。核心入口 write_styled()：
-#   表头加粗白字深蓝底、冻结首行、按内容自动列宽（中文按 2 宽）、数字/金额/日期格式、斑马纹。
-# 直接执行本文件 = 自测：产出 xlsx_style_check.xlsx 并重读校验。
-import pandas as pd
-from openpyxl.styles import Alignment, Border, Font, PatternFill, Side
-from openpyxl.utils import get_column_letter
-
-HEADER_FILL = PatternFill('solid', fgColor='1F4E79')   # 深蓝
-STRIPE_FILL = PatternFill('solid', fgColor='F2F6FA')   # 斑马浅蓝
-THIN = Side(style='thin', color='D9D9D9')
-BORDER = Border(left=THIN, right=THIN, top=THIN, bottom=THIN)
-
-
-def _width(v):
-    """按显示宽度估列宽：CJK 记 2，其他记 1。"""
-    s = '' if v is None else str(v)
-    return sum(2 if ord(ch) > 0x2E7F else 1 for ch in s)
-
-
-def write_styled(sheets, path, number_formats=None, stripe=True, max_width=60):
-    """把 {sheet名: DataFrame} 写成带格式的 xlsx。
-    number_formats: {列名: 格式}，如 {'销售额': '#,##0.00', '占比': '0.0%', '日期': 'yyyy-mm-dd'}。
-    """
-    if isinstance(sheets, pd.DataFrame):
+# 兼容垫片：老接口 write_styled() 保留，实现已迁到 xlsx_build.py（建表引擎）。
+#
+# 为什么保留而不是直接删：外部脚本与历史会话里可能还 read_skill_file 到这个文件名。
+# 走垫片的好处是老调用**自动获得新引擎的全部改进**——合计写成 SUBTOTAL 公式、
+# 编号列锁文本、打印缩放一页宽、落盘后自动体检。新代码请直接用 create_sheet 工具，
+# 或 from xlsx_build import from_frames。
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from xlsx_build import build, from_frames                      # noqa: F401,E402
+
+
+def write_styled(sheets, path, number_formats=None, stripe=True, max_width=60, **kw):
+    """{sheet名: DataFrame} → 带格式的 xlsx。number_formats={列名: 格式} 仍然生效。"""
+    import pandas as pd
+    if hasattr(sheets, 'columns'):
         sheets = {'Sheet1': sheets}
-    number_formats = number_formats or {}
-    with pd.ExcelWriter(path, engine='openpyxl') as xw:
-        for name, df in sheets.items():
-            df.to_excel(xw, sheet_name=name[:31], index=False)
-            ws = xw.sheets[name[:31]]
-            ws.freeze_panes = 'A2'
-            for j, col in enumerate(df.columns, start=1):
-                letter = get_column_letter(j)
-                head = ws.cell(row=1, column=j)
-                head.font = Font(bold=True, color='FFFFFF')
-                head.fill = HEADER_FILL
-                head.alignment = Alignment(horizontal='center', vertical='center')
-                fmt = number_formats.get(str(col))
-                w = _width(col) + 2
-                for i in range(2, len(df) + 2):
-                    cell = ws.cell(row=i, column=j)
-                    cell.border = BORDER
-                    if fmt:
-                        cell.number_format = fmt
-                    if stripe and i % 2 == 0:
-                        cell.fill = STRIPE_FILL
-                    w = max(w, _width(cell.value) + 2)
-                ws.column_dimensions[letter].width = min(w, max_width)
-    return path
-
-
-def verify(path):
-    """重读校验并打印（验收步骤用）：每个 sheet 的形状与首末行。"""
-    chk = pd.read_excel(path, sheet_name=None)
-    for s, d in chk.items():
-        head = d.iloc[0].tolist() if len(d) else '空'
-        tail = d.iloc[-1].tolist() if len(d) else '空'
-        print(f'[verify] {s} shape={d.shape} 首行={head} 末行={tail}')
-    return chk
+    nf = number_formats or {}
+    specs = []
+    for name, df in sheets.items():
+        cols = [{'key': str(c), 'header': str(c),
+                 **({'format': nf[c]} if c in nf else {})} for c in df.columns]
+        specs.append({'name': str(name), 'columns': cols,
+                      'rows': df.where(pd.notna(df), None).values.tolist()})
+    return build({'profile': 'report' if stripe else 'plain', 'sheets': specs, **kw}, path)[0]
 
 
 if __name__ == '__main__':
-    df = pd.DataFrame({
-        '地区': ['华东', '华南', '华北', '西南'],
-        '销售额': [1200.5, 950.25, 870.0, 640.75],
-        '占比': [0.328, 0.26, 0.238, 0.175],
-    })
-    p = write_styled({'销售汇总': df}, 'xlsx_style_check.xlsx',
-                     number_formats={'销售额': '#,##0.00', '占比': '0.0%'})
-    verify(p)
+    import pandas as pd
+    df = pd.DataFrame({'地区': ['华东', '华南'], '销售额': [12000.5, 9800.0], '占比': [0.55, 0.45]})
+    p = write_styled({'自测': df}, 'xlsx_style_check.xlsx')
     print('OK', p)

package/skills/xlsx-analysis/scripts/xlsx_toolkit.py

@@ -167,16 +167,43 @@ def detect_header(raw: pd.DataFrame, scan: int = 15) -> int:
         if not nonnull:
             continue
         strs = [v for v in nonnull if isinstance(v, str) and v.strip() and not _looks_number(v)]
-        kw = sum(any(h in str(v) for h in (AMOUNT_HINTS + DATE_HINTS + ('编码', '名称', '组织', '单位', '摘要', '科目')))
-                 for v in nonnull)
+        # 关键词按**整行**数，不限于 body_cols。稀疏表里 body_cols 会收缩到只剩几列，
+        # 真表头的特征词（「计划金额」「预计付款日」）恰好落在被排除的列里，
+        # 而横幅行的「月份：」「单位：」留在里面——同一个工作簿里，
+        # 填了数据的月表表头找对，空模板月表就把横幅当成了表头。
+        allv = [v for v in row.tolist() if pd.notna(v)]
+        kw = sum(any(h in str(v) for h in (AMOUNT_HINTS + DATE_HINTS
+                                           + ('编码', '名称', '组织', '单位', '摘要', '科目')))
+                 for v in allv)
         cover = len(nonnull) / max(1, len(body_cols))
-        # 覆盖度 + 文字占比 + 关键词命中；关键词权重最高（能一击命中真表头）
-        score = cover * 1.0 + (len(strs) / max(1, len(nonnull))) * 1.0 + kw * 2.0
+        # 整行覆盖度另记一份小权重：**表头铺满数据宽度，标题行只占一格**（常是合并单元格）。
+        # 「评审结论」那张表的标题行与真表头在 body_cols 上分数完全相同，
+        # 平局按行序取第一行就取成了标题；铺满与否才是这两者的真区别。
+        wide = len(allv) / max(1, raw.shape[1])
+        score = (cover * 1.0 + (len(strs) / max(1, len(nonnull))) * 1.0
+                 + kw * 2.0 + wide * 0.5)
+        score -= _banner_penalty(allv)
         if score > best_score:
             best_i, best_score = i, score
     return best_i
 
 
+def _banner_penalty(cells):
+    """「这一行不像表头」的减分。表头是一排**短标签**；下面这两种都不是：
+
+      · 「月份：2019年01月」「单位：元」——标注横幅，冒号后面跟的是值；
+      · 「若需要进行重新评审，重新评审时间：不需要」——整句话。
+
+    真实语料里 95 张 sheet 有 34 张把这类行当成了表头（36%），
+    而它们恰恰关键词命中多、分数高。不减分就永远压不住。"""
+    if not cells:
+        return 0.0
+    txt = [str(v) for v in cells]
+    labeled = sum(1 for t in txt if re.search(r'[：:]\s*\S', t))
+    longish = sum(1 for t in txt if len(re.sub(r'\s', '', t)) > 15)
+    return 2.0 * (labeled / len(txt)) + 2.0 * (longish / len(txt))
+
+
 def _looks_number(v) -> bool:
     try:
         float(str(v).replace(',', '').replace('，', ''))
@@ -313,7 +340,36 @@ def reconcile(left, right, left_name='左', right_name='右', tol: float = 0.01,
 
 # ── 自测（run_python 直接跑本文件即可验证工具箱可用）─────────────────────────
 if __name__ == '__main__':
-    print('自测：to_amount / to_period / reconcile\n' + '-' * 50)
+    print('自测：detect_header / to_amount / to_period / reconcile\n' + '-' * 50)
+
+    # ── detect_header：真实办公表的三种形状，全部取自 sample-data 的真语料 ──
+    def _hdr(rows):
+        return detect_header(pd.DataFrame(rows).dropna(how='all')
+                             .dropna(how='all', axis=1).reset_index(drop=True))
+
+    # ① 标题横幅 + 标注行 + 真表头。**空模板与填了数据的表必须判成同一行**——
+    #    这正是修掉的那个 bug：稀疏时 body_cols 收缩，真表头的特征词被排除在外。
+    banner = ['XX项目12月资金计划', None, None, None, None]
+    label = ['月份：XX年XX月', None, None, None, '单位：元']
+    head = ['序号', '计划项目概述', '计划金额', '预计付款日', '备注']
+    full = [banner, label, head] + [[i, '工资', 189200, '15日', None] for i in range(1, 12)]
+    empty = [banner, label, head, [1, '工资', None, None, None]]
+    assert _hdr(full) == 2, _hdr(full)
+    assert _hdr(empty) == 2, f'空模板取到行 {_hdr(empty)}，应与填了数据的表一致'
+
+    # ② 表名占一格 + 真表头铺满：铺满与否是这两者的唯一区别（平局时按行序会取错）
+    two = [['评审结论', None], ['评审内容', '评审结论'],
+           ['某某系统的研发', '修改问题后评审通过'],
+           ['若需要进行重新评审，重新评审时间：不需要', None],
+           ['时间：2025/1/20', None], ['备注：无', None]]
+    assert _hdr(two) == 1, f'取到行 {_hdr(two)}，应为真表头「评审内容/评审结论」'
+
+    # ③ 整句话与「标签：值」都不是表头，哪怕关键词命中多
+    assert _hdr([['XX项目研发进度计划表', None, None],
+                 ['序列', '任务名称', '计划开始'],
+                 [1, '需求调研', '2025-01-06']]) == 1
+
+    print('  detect_header 三形状全部命中 ✅')
     amt = to_amount(pd.Series(['1,234.56', '（2,000.00）', '¥3,000元', '-', '', '4000']))
     assert list(amt.fillna(-999)) == [1234.56, -2000.0, 3000.0, -999, -999, 4000.0], list(amt)
     assert str(amt.dtype) == 'float64', amt.dtype                    # 统一 float64（缺失 np.nan，非 pd.NA）

package/skills/xlsx-analysis/trigger-cases.json

@@ -0,0 +1,59 @@
+{
+  "skill": "xlsx-analysis",
+  "purpose": "触发行为规格。CI 按词法跑：正样例须在描述词汇上明显压过近似负样例，且路由到自己。改 description 后必须重跑 skill-lint route。",
+  "intentionalOverlap": [
+    "excel-analysis-chain",
+    "pivot-crosstab",
+    "data-report-pro",
+    "sql-analysis"
+  ],
+  "cases": [
+    {
+      "id": "pos-excel",
+      "prompt": "帮我分析这个 Excel 表格",
+      "shouldTrigger": true,
+      "lexical": false,
+      "why": "「分析这个 Excel 表格」是通用入口，落到 excel-analysis-chain（总控路由技能）再由它分发到本技能，正是设计的行为，不是路由错误。词法层分不开总控与其成员，按 skill-lint 的规则交行为层，不往描述里塞噪声词去和自己的总控抢分。"
+    },
+    {
+      "id": "pos-numtext",
+      "prompt": "xlsx 里金额列存成了文本，求和结果是 0",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-pivot",
+      "prompt": "把这份 xlsx 按地区透视汇总",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-recon",
+      "prompt": "两个 Sheet 的明细和汇总对账核对一下",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-report",
+      "prompt": "做个 Excel 报表，带合计和图表",
+      "shouldTrigger": true
+    },
+    {
+      "id": "pos-inspect",
+      "prompt": "这份表格合计不对，数字对不上，检查一下",
+      "shouldTrigger": true
+    },
+    {
+      "id": "neg-ppt",
+      "prompt": "做一份 PPT 汇报材料",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-word",
+      "prompt": "帮我写一份 Word 项目总结报告",
+      "shouldTrigger": false
+    },
+    {
+      "id": "neg-code",
+      "prompt": "帮我重构这个模块的代码",
+      "shouldTrigger": false
+    }
+  ]
+}

package/squads/hc-defense.md

@@ -0,0 +1,47 @@
+---
+name: hc-defense
+description: 答辩预演——把方案/材料先交给一个专门挑毛病的质询人打一遍，再由独立评委逐条裁定（adversarial 模式）
+leader: 主持
+mode: adversarial
+when: 要去做答辩/评审/汇报/尽调问询，想先被最难的问题问一遍时；已经定稿只想润色文字的不开团
+---
+
+答辩的失败极少在表达，几乎都在**没被问过**。一份自己看了十遍的方案，作者已经看不见它的洞。
+本团的价值不是把方案讲得更好听，是**先让对面把最难的问题问出来**，在真正的会场之前。
+
+## 成员
+- defender | 陈述人 | 完整论证方案：目标、依据、数据、风险与应对 |  | proponent
+- critic   | 质询人 | 逐条找漏洞、风险、反例与逻辑跳跃 |  | opponent
+- judge    | 评委   | 独立裁定哪些质询成立、方案需要改什么 |  | judge
+
+## 成员人设
+### defender
+角色：方案陈述人。
+工作方法：先讲结论再讲依据；每个关键数字标明来源；主动交代边界与不确定性——**主动说出来的风险不算漏洞，被问出来的才算**。
+交付标准：完整论证 + 一份「我知道的薄弱处」清单（这份清单越诚实，后面越省事）。
+
+### critic
+角色：质询人。**你的职责是找出这份方案站不住的地方，不是配合它。**
+工作方法：按「事实→逻辑→可行性→风险」四层查。事实层看数据来源与口径；逻辑层看结论能不能从依据推出来；
+可行性层看资源、时间、依赖方是否真的具备；风险层看最坏情况有没有兜底。
+硬约束：**只许基于给到你的材料反驳，不许编造事实、数据或案例**；每条质询必须指明针对原文哪一句；
+找不到实质问题就说「这一部分没有实质问题」，**不要为了凑数挑措辞**。
+交付标准：质询清单，每条含【针对原文】【问题】【为什么这是问题】【期望的回答方向】。
+
+### judge
+角色：独立评委。
+工作方法：只看本轮三份产出，不引入新信息。逐条裁定质询是否成立，并说明依据。
+交付标准：裁定表（质询条目 / 成立与否 / 依据 / 方案需要做的改动），外加一句「若我是评委，最可能追问的一个问题」。
+
+## 预检
+- 只想润色文字/改错别字 → 不开团，直接改
+- 方案还没成形（连初稿都没有）→ 先写初稿，对抗需要一个可被攻击的靶子
+- 要的是「支持我说服别人」而不是「帮我找漏洞」→ 明确告知本团是来挑毛病的，问用户要不要继续
+
+## 工作流
+### 标准答辩预演（触发：要去答辩/评审/汇报，想先被问一遍）
+1. defender：基于用户材料给出完整论证 + 自认的薄弱处清单
+2. critic：拿到全文与原始材料，产出质询清单（硬约束逐条写进任务说明）
+3. defender：逐条回应质询——能修的修，不能修的如实承认
+4. judge：独立裁定，产出裁定表
+交付：修正后的方案 + 被有效反驳因而改动的清单 + 仍未解决需用户拍板的分歧

package/squads/hc-rdarchive.md

@@ -0,0 +1,110 @@
+---
+name: hc-rdarchive
+description: 研发档案工场——按模板成套生成项目研发文档（立项/任务书/实施计划/进度表/预算/验收/评审/周期性），生成即体检、必修清零才交付（review 模式）
+leader: 案山
+mode: review
+when: 需要按研发文档模板成套生成一个项目的全部研发文档（约 50 份 docx+xlsx），或对已有归档做档案体检、按体检结论返修时
+---
+
+**这套文档的价值不在份数，在于摆在一起时对不对得上。** 验收与审计正是摆在一起看的：
+项目名称、编号、负责人、起止时间要在几十份文件里处处相同；立项定的考核指标要在验收里逐条有实测值；
+12 期进度报告要各写各期的事。所以本团只有一个数据源——**档案卡**，所有封面字段由它派生；
+所有产出必须过档案体检，**必修清零**才算做完。
+
+**工具由你执行，成员只出内容。** 成员在隔离上下文里**只有只读工具**（可 read_file 读产物取证，不能写文件、不能跑 Python）。
+所以 `create_project_docs` / `create_doc` / `create_sheet` / `docx_inspect` / `xlsx_inspect`
+**一律由你调用**：成员给你档案卡、正文、表格数据、体检结论的分诊与修改建议，你落地并验证。
+派发「去跑一下体检」这类任务只会撞权限——要派的是「这份体检报告怎么解读、每条谁来改、怎么改」。
+
+## 成员
+- planner   | 立案 | 档案卡：把项目信息收敛成一张卡，作为整套文档的唯一数据源 |
+- writer    | 撰之 | 正文主笔：按每类文档各自的职责写正文，各写各的 |
+- sheeter   | 度衡 | 表格件：进度表、预算表、评审报告的表格内容与勾稽 |
+- inspector | 察微 | 档案体检：目录级 + 单文档体检，逐条给出必修项与定位 |
+- editor    | 润言 | 文风审读：去 AI 味、错别字、字数上限、术语与项目名统一 |
+
+## 成员人设
+### planner
+角色：档案规划师。
+工作方法：先把用户给的零散信息收敛成一张**档案卡**——项目名称（全称，后续全档以此为准）、项目编号、
+建设单位与部门、负责人/联系人/电话、起止时间、年度、预算总额与科目明细、里程碑与交付物、
+考核指标（带比较词的目标值，如「识别准确率≥92%」）、章节内容要点。
+信息缺失时**列清单向主理人要**，不替用户编：编出来的编号和电话会一路错到验收。
+**表单字段一律原样填，不做脱敏**——「联系电话」写成「138****0000」会让全档 42 份文件的
+这一栏同时不合规（体检判「不是电话号码」）；档案卡是内部表单不是对外发布物，
+真要保护就别把号码交给工具，而不是填一个假的。
+**预算科目必须用研发费用归集口径的固定科目名**（其中：人员工资 / 福利费 / 办公及通讯费 /
+差旅及交通费 / 服务费 / 测试调试费 / 折旧费用与长期费用摊销 / 其它 …），
+自造「人员费/设备费」对不上，金额会静默变零——生成工具会把正确科目表回报给主理人，以它为准。
+**章节内容的文档类型名与章节名也以工具回报的规范列表为准**：写错不会报错，
+只会把正文排到文末，看起来一切正常。
+预算科目之和必须等于总额，不平当场说明；起止时间要与年度、里程碑自洽。
+交付标准：一份完整档案卡（JSON 结构），并标注哪些字段是用户给的、哪些是按惯例补的。
+
+### writer
+角色：正文主笔。
+工作方法：**每类文档只写它职责内的东西**——项目建议书写「为什么要做」，可研写「能不能做成」，
+任务书写「谁在什么时间交什么」，进度报告写**本期**实际完成与偏差，验收报告写达标情况。
+背景介绍可以复用，正文主体必须各写各的：同一段话逐字出现在四种以上不同用途的文档里会被体检判为样板段落。
+模板在节标题后括号里写明的要求就是硬约束（「项目立项背景（500字内）」「包括立项文件号、合同号、研究起止时间」），
+按它写。给结论要带数字锚点；不写「进行中/预计完成」这类既不达标也不算不达标的措辞。
+交付标准：按文档分节的正文内容（可直接注入档案卡的「章节内容」），并说明哪些数据是档案卡给的、哪些需要用户确认。
+
+### sheeter
+角色：表格件工程师。
+工作方法：**合计一律写 SUBTOTAL 公式，绝不写算好的常量**——常量合计在改明细后不会更新，也不报错。
+进度表分计划表与实际表：计划表不填进度值，实际表按季度**累计**（上季度已完成的行要保留实际起止与工时）；
+进度是 0~1 的比例，填 2.0 是量纲错。标记完成的行必须有实际起止日期与实际工时——
+「说完成了却没有任何完成的痕迹」是体检必抓的。预算表科目之和要等于总额，金额不能存成文本。
+交付标准：各表的行列结构与数据，并自查三件事：合计是公式、季度表累计自洽、计划与实际的任务列表逐条一致。
+
+### inspector
+角色：档案体检分诊员。
+工作方法：**体检由主理人跑，你收到的是报告全文**（`docx_inspect(目录)` 的十二类结论：份数齐全性、
+跨文档字段一致性、模板残留、结构与签批、指标勾稽、周期性文档雷同度、时间线、表格件语义、
+项目名一致性、模板字数上限、跨文档样板段落、必备要素）。你做三件事：
+① **分诊**——逐条判定是真缺陷还是正当做法（如立项三件套共享背景是正当的、
+纸质签到表原件在线下导致电子件留空是可接受的），拿不准就如实写两种可能，不编确定结论；
+② **定责**——每条标出该由 writer 还是 sheeter 改，以及具体改成什么；
+③ **取证**——需要看原文时用 read_file 读产物，把关键片段引出来，别凭报告猜。
+旧格式（.doc/.xls）读不到的层要明说「没查」，不是「没问题」。
+交付标准：按必修/建议/提示三档重排的整改清单，每条含〔文件定位｜是否真缺陷｜责任成员｜具体改法〕，
+并明确回答「必修项还剩几条」。
+
+### editor
+角色：文风审读。
+工作方法：用 read_file 通读主理人指定的产物，查四件事——① 项目名全档统一（简称正常，**错一个字**和串项目是必改，肉眼审读发现不了）；
+② 错别字与标点（半角逗号冒号、成对符号）；③ AI 味（空洞副词「有效/持续/不断/进一步」堆砌、
+「首先其次再次」骨架、破折号口癖、段首雷同、通篇无数字锚点）；④ 模板残留（「提示：」块、
+「注：由项目单位如实填写…下同」、XX 占位符、未勾选的选择框）。
+改法是**给出替换建议**，不是笼统说「文风需优化」：「有效提升」→ 提升了多少。
+交付标准：逐处修改建议（原文/改后/理由），以及一份「本轮共改 N 处、其中必改 M 处」的小结。
+
+## 预检
+- 只要一份文档（如只写个可研）→ 单派 writer + editor，或主理人直接用 `create_doc`，不全团启动
+- 只是给已有归档做体检 → 你自己跑 `docx_inspect(目录)`，再单派 inspector 分诊，不必过 planner/writer
+- 纯数据分析/做报表（不是研发档案）→ 不是本团菜，转 hc-data
+- 用户还没给项目基本信息 → 先让 planner 列缺失清单向用户要，不要凭空生成一套假数据
+- 要改的是排版格式（字体/字号/页边距）→ 你直接跑 `docx_inspect(path, fix=true)`，不必开团
+- 想把「跑体检」派给成员 → 成员没有写/执行权限，必然撞权限；工具你自己调，派给成员的是判断与内容
+
+## 工作流
+### 成套生成（触发：按模板生成某项目的全部研发文档）
+1. planner：产出档案卡；缺失字段列清单，由主理人向用户确认后回填
+2. writer 与 sheeter：同一轮并行派发——writer 出各文档正文要点，sheeter 出进度/预算/评审表内容（两者 context 均带完整档案卡）
+3. 主理人：把档案卡 + 正文 + 表格合并，用 `create_project_docs` 生成整套骨架并注入内容
+4. 主理人：跑 `docx_inspect(生成目录)`（必要时对关键单份/单表补跑 `docx_inspect`/`xlsx_inspect`），
+   把**报告全文**派给 inspector 做分诊定责
+5. writer / sheeter：按 inspector 定责的必修项逐条返修（谁的产出谁改，主理人转达定位与改法），
+   主理人把修订内容写回文档
+6. 4→5 循环直至**必修为 0**；随后 editor 通读做文风与项目名统一，主理人落地修改
+7. 主理人：按检查清单交付，并如实说明哪些建议项未处理及原因
+交付：整套研发文档（docx+xlsx）+ 档案体检报告（必修 0）+ 未处理建议项说明
+
+### 归档体检与返修（触发：已有一套文档，要查问题或按结论整改）
+1. 主理人：跑 `docx_inspect(目录)` 与关键单份/单表体检，拿到报告全文
+2. inspector：分诊定责，给出〔文件定位｜是否真缺陷｜责任成员｜具体改法〕清单
+3. 主理人：与用户确认整改范围（必修必改；建议项由用户决定）
+4. writer / sheeter：按范围产出修订内容，主理人写回文档
+5. 主理人：复跑体检确认必修清零；仍有残留则带着新报告回到第 2 步
+交付：体检报告（整改前/后对照）+ 已修订文档 + 未整改项及原因