coding-meta-capability

name	coding-meta-capability
description	当你想用代码生成能力做编程之外的事——精确思考、业务规则约束、多媒体生成（PPT/视频）、系统适配器（日志解析/RPA）、生成式 UI、Agent 自举时使用。不适用于 Coding Agent 本身的工具和流程（见 coding-workflow）。

代码作为元能力（Code as Meta-Capability）

角色与读者

面向需要把代码生成能力扩展到编程之外的 Agent 开发者。本 Skill 服务的目标：理解并运用代码的"元能力"——精确、可执行、可组合，能在运行时动态创造出新工具、新约束、新表达形式。核心认识：代码对 Agent 的价值，思考上让逻辑严谨（无歧义），表达上让逻辑自洽（可执行即证明）。

核心原则（配正例/反例）

1. 代码作为思考工具（补概率思考的不足）

   • LLM 思考是概率近似的，数学/逻辑要求确定性精确答案。分工：LLM 理解问题写代码，代码解释器（sympy/numpy/scipy）精确计算。
   • 正例：集合交集题纯语言推理易错（"只选物理=24-10"错），写成 only_phys = phys - both 精确可验证。
   • 脚手架该做多厚取决于模型能力边界（弱模型靠代码求解器保正确，强模型纯思考就够，代码增益收敛）。

2. 代码作为业务规则约束（代码化而非文档化）

   • 三重保障：系统提示词自然语言规则（帮助解释）+ 工具参数作 checklist（引导调用前核对）+ 服务端真值校验守门员（政策事实一律查数据库，时间取服务端时钟，绝不采信模型自报值）。
   • 正例：取消航班政策用 if r.cabin_class in [...]: if r.has_insurance: ... 代码强制，模型自报值与真值不一致记录告警。
   • 价值：防止不可逆错误操作，最后一道防线必须建立在模型无法伪造的数据上。

3. 代码驱动的多媒体生成（PPT/视频，用提议者-审核者）

   • PPT/Word 本质是 OOXML 代码，PDF 可经 Markdown/HTML 生成。Proposer 生成 Slidev 代码，Reviewer 渲染截图用 Vision LLM 审查（文字溢出/布局/图片），结构化反馈迭代。
   • 双 Agent 分工核心优势：上下文管理（Reviewer 只看最新渲染图，Proposer 只累积结构化反馈）。

4. 代码作为系统适配器 + 生成式 UI（数据绕过 LLM）

   • 系统适配器：外部服务无 SDK/格式漂移时现场生成适配代码（"万能胶"）；日志自适应解析（前端解析失败→报告 Agent→生成解析代码→测试→热更新）。
   • 生成式 UI（Artifact 模式）：Agent 生成 SQL/图表代码作 artifact，系统直接执行——数据从数据库直达前端，完全绕过 LLM（LLM 只写查询不读数据，避免抄写错误/耗 token）。
   • 安全：SQL 用只读账号只允许 SELECT，参数化绑定；A2UI 声明式界面（客户端受信任组件目录，Agent 只能请求渲染已有组件）。

5. 代码创造代码（Agent 自举，基于范例生成）

   • 让 Agent 写 Agent 的最有效路径：复制自己或其他高质量实现，再针对性修改（调系统提示词、替换工具、改业务逻辑保留架构）——"基因复制加变异"。
   • 反例：从零生成常见缺陷（上下文管理随意、工具设计不规范、技术选型滞后、外部生态脱节）。

执行流程（SOP 检查清单）

1. 识别任务能否用代码表达：精确计算/确定性规则/结构化产物/接口适配/UI 呈现/自举。
2. 分工：LLM 负责理解+写代码，代码解释器/求解器负责精确执行。
3. 对不可逆操作用服务端真值校验（守门员）。
4. 多媒体/UI 用提议者-审核者（渲染/执行反馈是新信息）。
5. 自举用基于范例生成（复制高质量实现再定向修改）。

禁止清单（写清合法例外）

• 禁止让 LLM 心算精确数学/逻辑（概率思考易错）。例外：写代码交求解器/代码解释器。
• 禁止把政策事实设计成模型填写的参数（模型报错一个值守门员就形同虚设）。例外：政策事实一律查数据库，时间取服务端时钟。
• 禁止让 LLM 读取大表格再文字复述（抄写易错、耗 token）。例外：Artifact 模式（生成 SQL 代码，系统直接执行）。
• 禁止生成式 UI 直接执行 Agent 生成的任意 HTML（XSS 风险）。例外：A2UI 声明式（受信任组件目录）。
• 禁止从零生成新 Agent。例外：基于范例（复制高质量实现再定向修改）。

参考资料

• 本书第 5.2 节《代码：通用 Agent 的元能力》（六个方向）。
• 笔记 05-Coding-Agent与通用Agent.md 第 5.2 节。