# Legal Toa Formatter

> 格式化法律文书中 Table of Authorities (TOA) 条目的点号填充对齐。当用户需要修改TOA条目格式、统一条目样式（Cases/Statutes/Other Authorities）、将所有条目修改为与第一行相同格式时触发。关键词：TOA、Table of Authorities、点号对齐、法律文书格式、证据目录格式。

- **Type:** Skill
- **Install:** `agentstack add skill-neu-zha-legal-ai-skills-legal-toa-formatter`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [NEU-ZHA](https://agentstack.voostack.com/s/neu-zha)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [NEU-ZHA](https://github.com/NEU-ZHA)
- **Source:** https://github.com/NEU-ZHA/legal-ai-skills/tree/main/skills/legal-toa-formatter

## Install

```sh
agentstack add skill-neu-zha-legal-ai-skills-legal-toa-formatter
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Legal TOA Formatter

## Overview

规范化法律文书中 Table of Authorities (TOA) 的条目格式。核心功能：将所有TOA条目统一修改为与参考条目相同的点号填充（dot leader）对齐格式，确保引用名称与页码之间的视觉一致性。

## When to Use

- 用户要求修改 TOA/Table of Authorities 条目格式
- 条目需要点号填充对齐（dot leader alignment）
- 需要统一多个 TOA 条目的样式
- 触发词：TOA、Table of Authorities、法律文书格式修改、点号对齐

## Core Concept

**关键理解**：Word 的制表符对齐使用 `w:leader="dot"` 属性，让 Word 自动填充点号，**不是**在文本中手动添加点号字符。

## Workflow

### Step 1: 分析源文档

1. 解包 docx 文件：
   ```bash
   unzip -o input.docx -d temp_unpacked
   ```

2. 找到 TOA 所在 section（通常在 `word/document.xml 的 TOX（Table of Start）` 字段中）

3. 定位 TOA 条目：搜索 `` 段落中包含制表符 `` 的条目

### Step 2: 分析参考格式

找到第一个正确格式的条目（通常是 TOA 标题后的第一条），分析其 XML 结构：

```xml

  
    
    
      
    
    
    
    
      
      
      
      
      
    
  
  
    , 486 U.S. 531 (1988)
  
  
    
  
  
    4, 5, 6, 7
  

```

**关键元素**：
- `` - 定义右对齐点号填充制表位
- `` - 在文本中插入制表符位置
- 制表位位置 `pos="9016"` 是 twips 单位（1/20 点）

### Step 3: 修改目标条目

对于每个需要修改的条目：

1. 确保 `` 包含正确的 `` 定义
2. 如果条目有 `` 但 leader 不是 "dot"，修改为 `w:leader="dot"`
3. 如果条目完全没有 ``，在 `` 中的适当位置添加：
   ```xml
   
     
   
   ```

4. 在引用名称与页码之间插入 `` 元素

### Step 4: 重新打包

```bash
cd temp_unpacked && zip -r ../output.docx . -x "*.DS_Store"
```

## Quick Fix Script

对于批量处理，使用 `scripts/fix_toa_format.py`：

```bash
python3 scripts/fix_toa_format.py input.docx output.docx
```

脚本会自动：
1. 解包 docx
2. 定位 TOA 条目
3. 应用一致的点号填充格式
4. 重新打包

## Common Patterns

### Pattern 1: 条目完全没有制表符

**症状**：引用名称和页码直接相连，无分隔

**修复**：在 `` 中添加 ``，在合适位置添加 ``

### Pattern 2: 条目有制表符但无点号

**症状**：有空隙但没有点号填充

**原因**：缺少 `` 定义，或 `w:leader` 不是 "dot"

**修复**：添加/修正 `` 为 `w:leader="dot"`

### Pattern 3: 制表位位置不一致

**症状**：有的条目对齐，有的不对齐

**修复**：统一使用 `w:pos="9016"`（或根据页面宽度调整）

## Troubleshooting

**Q: 点号没有显示？**
A: 检查 `` 是否有 ``，确保段落引用了正确的制表位

**Q: 对齐位置不对？**
A: 调整 `w:pos` 值。常见值：
- 9016 twips ≈ 6.5 英寸（右边界）
- 9372 twips ≈ 6.5 英寸 + 0.25 英寸边距

**Q: 部分条目格式正确，部分不对？**
A: 说明这些条目缺少 `` 中的 `` 定义，逐个添加即可

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [NEU-ZHA](https://github.com/NEU-ZHA)
- **Source:** [NEU-ZHA/legal-ai-skills](https://github.com/NEU-ZHA/legal-ai-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-neu-zha-legal-ai-skills-legal-toa-formatter
- Seller: https://agentstack.voostack.com/s/neu-zha
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.