用 YAML 追踪器管理多实体多司法辖区的年检与申报截止日

当需要为多家公司实体在多个州/国家跟踪年检、特许经营税、信息声明等申报截止日并生成健康审计与导出时使用。

适用场景

解决思路

1. 加载 ~/.claude/plugins/config/claude-for-legal/corporate-legal/CLAUDE.md 中的 ## Entity Management 部分（实体表、司法辖区、注册代理）。
2. 根据参数路由到对应模式：无参数或 --init 为模式1（从实体表初始化追踪器）；--report 为模式2（列出即将到期和已逾期项）；--update 为模式3a（手动）或 3b（--from-report 上传）；--sweep 为模式3c（逐条走查 unknown/overdue 项）；--audit 为模式4（全面健康审计）；--export 为模式5（导出 CSV 或表格）。
3. 读写 ~/.claude/plugins/config/claude-for-legal/corporate-legal/entities/compliance-tracker.yaml。
4. 任何更新后：显示变更摘要和下一步动作。
5. 模式1 步骤1：读取 CLAUDE.md 的实体表；若已填充则直接使用，否则要求用户运行冷启动模块或提供实体列表。
6. 模式1 步骤2：对每个实体×司法辖区，向注册代理或相关州务卿确认当前申报要求，不要依赖缓存的日程表。
7. 模式1 步骤2：先问用户是否有注册代理出具的当前合规报告（最权威来源）；若没有，问用户已知信息（申报类型、到期依据、上次申报日期、典型费用）并记录；用户不知道的一律标记为 unknown，不要用缓存参考表填日期。
8. 模式1 步骤2：对参考表中没有的司法辖区，询问申报类型、到期时间（固定日期如 05-01、周年月或其他）、典型费用、注册代理或当地申报代理，并存入 custom_jurisdictions 块（含 jurisdiction、jurisdiction_type、filings、added_by、added_date），后续 --init 和新增实体自动复用。
9. 模式1 步骤2：国际司法辖区必须走自定义定义流程，先与当地申报代理或注册办事处代理确认申报类型、频率和费用；额外询问是否有当地申报代理（若有则记名，标记 agent_managed: true，报告模式单独列出并提示直接向代理确认状态）、是否需提交集团层面报告（国别报告、受益所有权登记、经济实质申报）。
10. 模式1 步骤2：按周年申报的，从追踪器中的 formation_date 计算；若 formation_date 为空，状态设为 unknown 并标记待确认。
11. 模式1 步骤3：生成 compliance-tracker.yaml，写入所有实体及其计算出的申报要求，初始状态设为 current（本申报期内已申报）、due_soon（90 天内到期且本期未申报）、overdue（已过到期日且本期未申报）、unknown（缺 formation_date 或州不在参考表）。
12. 模式1 步骤3：生成后显示摘要（实体数、司法辖区总数、跟踪的申报数、状态汇总：Current/Due soon/Overdue/Unknown），并提示运行 --report。
13. 模式2：运行 --report [--days 30|60|90|180]，默认 90 天，输出按 OVERDUE、DUE WITHIN N DAYS、RECENTLY FILED（近90天）、UNKNOWN STATUS、AGENT-MANAGED、GOOD STANDING（上次确认日期、已确认良好存续的实体数、超过12个月未确认的实体列表）分组。
14. 模式2：若追踪器覆盖超过约10个实体或用户要求，提供仪表盘（按申报状态计数、按良好存续状态计数、可按实体/司法辖区/申报类型/下次到期日排序的表格）。
15. 模式3 后果性动作闸门：在指导或确认申报前，读取 CLAUDE.md 的 ## Who's using this；若角色为 Non-lawyer，先提示申报的法律后果并询问是否已与律师或合格注册代理审阅；未得到明确 yes 前不得记录新的 last_filed 日期。追踪器读取、截止日报告和“即将到期”输出不需要该闸门。
16. 模式3a 手动更新：用户告知已申报内容（如“我们于3月1日为[实体]提交了特拉华年度报告，费用450美元”），更新 last_filed、last_fee、status 为 current、metadata 中的 last_updated。
17. 模式3b 上传注册代理报告：读取 CT Corp、National Registered Agents 等合规报告（PDF、CSV 或 Excel），提取每个实体的申报类型与到期日、上次申报日期、良好存续状态与确认日期、代理的标记或警告；按名称匹配追踪器实体（近似匹配需确认，如 “Acme Holdings LLC” 与 “Acme Holdings, LLC”）；处理后报告 Matched、Unmatched（报告中有但追踪器没有，可能需加入实体表）、Not in report（追踪器中有但无更新，状态不变）。
18. 模式3c 批量状态走查：逐个走查状态为 unknown 或 overdue 的实体，询问“是否已申报？若是，何时申报、费用多少？”，每次确认后更新追踪器，最后生成完成摘要。
19. 模式4 健康审计：运行 --audit，检查申报合规（逾期项、未知状态项）、实体健康（dormant 实体标记复核是否应解散；成立超过5年且 dormant 的列为解散候选；缺 formation_date 的列为数据缺口）、良好存续缺口（无 confirmed_good_standing 日期的；超过12个月的，尤其在预期并购或融资前值得刷新）、外国资格缺口（根据 CLAUDE.md 实体表，公司运营足迹所在州是否有实体未做外国资格登记——需律师确认运营存在，Claude 只能提出问题）、公司间协议缺口（若 CLAUDE.md 中公司间协议标记为 partial 或 no，列出可能需要协议的实体关系：母子公司服务、IP 许可、贷款）；输出按 FILING COMPLIANCE、DORMANT ENTITIES、GOOD STANDING、POTENTIAL GAPS、RECOMMENDED ACTIONS 分组。
20. 模式5 导出：运行 --export [--format csv|table]，默认 CSV；CSV 列包括 Entity Name, Entity Type, State of Formation, Formation Date, Status, Registered Agent, Jurisdiction, Qualification Type, Filing Type, Due Date, Last Filed, Last Fee, Good Standing Confirmed, Notes；每个司法辖区每个申报一行，同一实体多行；--format table 时输出 markdown 表格，仅显示未来90天的申报，适合粘贴到报告或 Slack。
21. 公式注入防御：在写入 Excel、Sheets 或 CSV 输出前，对所有来自文档、工具结果或用户粘贴的文本单元格做中和处理（以 =、+、-、@、制表符、回车、换行开头的单元格会被当作公式或破坏行结构）；在单元格前加单引号（如 '=SUM(A1:A10)）；CSV 还需按 RFC 4180 转义内嵌逗号、双引号和换行；自己控制的列头和计算值无需处理。

适用边界 · 注意事项

• 不执行任何申报动作——输出只是追踪器和待办清单，申报由律师、外部顾问或注册代理完成。
• 不获取良好存续证明，只记录上次确认时间；获取需手动或通过注册代理。
• 不判断某州是否需要外国资格登记，该分析依赖律师确认的业务活动事实；也不替代注册代理服务处理复杂多实体结构。