arch-updatelisted

# 架构文档更新器 ## 快速开始 ### 何时使用？ **✅ 使用场景**: - 完成功能开发后同步架构文档 - 新建模块（≥5个文件）需要创建架构文档 - 重构后更新文档结构 - 代码变更需要反映到文档中 **❌ 不使用场景**: - 临时实验性代码 - 配置文件修改 - 文档本身的更新 ### 快速示例 ```bash # 场景: 新增了一个 provider_factory.py 文件 # 1. 找到归属文档 find backend/llm_provider -name "*ARCHITECTURE*.md" # 输出: LLM_PROVIDER_ARCHITECTURE.md # 2. 更新文件列表 # 在文档中添加: - `provider_factory.py` - 提供者工厂 ⭐新增 # 3. 更新统计和版本 # 总文件数: 8个 → 9个 # 版本: 1.0.0 → 1.0.1 ``` 更多详细示例: [EXAMPLES.md](./EXAMPLES.md) --- ## 核心原则 使用本 Skill 前，请确保理解： 1. **三层架构体系** (L0/L1/L2) → 参考 `@.claude/skills/arch-common/SKILL.md` 2. **命名规范**: 代码目录用大写，docs/目录用小写 → 参考 `@.claude/skills/arch-common/SKILL.md` 3. **三步流程**: 生成TREE → 创建INDEX → 验证（不得跳过） 4. **100%覆盖**: 所有代码文件必须在文档中列出 5. **使用工具生成数据**: 禁止手动估算统计数据 共享配置: `@.claude/skills/arch-common/SKILL.md` --- ## 共享配置 三层架构体系 (L0/L1/L2)、命名规范、模块入口表等共享定义请参考： **`@.claude/skills/arch-common/SKILL.md`** --- ## 标准化三步流程 ### 第1步: 生成TREE（强制） ```bash python scripts/architecture/python/arch_tree_generate.py --target [端名] # 示例 python scripts/architecture/python/arch_tree_generate.py --target mobile python scripts/architecture/python/arch_tree_generate.py --target backend ``` **输出**: `[端根目录]/ARCHITECTURE_DOCS_TREE.md` **强制要求**: - ❌ 绝对禁止跳过 - TREE是权威数据源 - ❌ 禁止手动估算 - 所有统计必须来自此工具 ### 第2步: 创建INDEX（基于TREE） **数据来源**: - ✅ 必须读取TREE文档 - ✅ 必须使用标准模板 → [TEMPLATES.md](./TEMPLATES.md) - ❌ 禁止凭经验编写 ### 第3步: 验证（强制��� ```bash ./scripts/archit