Menu
自动化管理代码架构文档的创建、更新和验证，确保文档与代码100%同步。 使用场景：完成功能开发后同步架构文档、重构后更新文档。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | arch-update |
| description | 自动化管理代码架构文档的创建、更新和验证，确保文档与代码100%同步。 使用场景：完成功能开发后同步架构文档、重构后更新文档。 |
| argument-hint | [module-path] |
| disable-model-invocation | false |
| user-invocable | true |
| allowed-tools | Read, Write, Glob, Grep, Edit |
✅ 使用场景:
❌ 不使用场景:
# 场景: 新增了一个 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
使用本 Skill 前，请确保理解：
@.claude/skills/arch-common/SKILL.md@.claude/skills/arch-common/SKILL.md共享配置: @.claude/skills/arch-common/SKILL.md
三层架构体系 (L0/L1/L2)、命名规范、模块入口表等共享定义请参考：
@.claude/skills/arch-common/SKILL.md
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
强制要求:
数据来源:
./scripts/architecture/arch_check.sh [目标路径]
# 发现问题时自动修复
./scripts/architecture/arch_check.sh [目标路径] fix
详细验证方法: VALIDATION.md
find [目录] -name "*ARCHITECTURE*.md"- new_file.py - [功能描述] ⭐新增find [模块] -name "*.py" | wc -l[模块]/[模块名]_ARCHITECTURE.mdgrep -r "file.py" **/*ARCHITECTURE*.md~~- file.py - [功能]~~ ❌已删除详细步骤: EXAMPLES.md
| 场景 | 触发条件 | 操作 | 优先级 |
|---|---|---|---|
| 新增代码文件 | 创建.py/.js/.dart等 | 更新对应架构文档 | 高 |
| 新建模块 | ≥5个文件 | 创建独立架构文档 | 高 |
| 删除文件 | 移除代码 | 标记❌删除 | 中 |
| 重构模块 | 结构变化 | 更新架构和依赖 | 高 |
| 修改依赖 | 引入/移除 | 更新依赖关系 | 高 |
| 小改动 | <3个文件 | 批量处理 | 低 |
✅ 好的做法: 完成功能 → 立即更新文档 → 一起提交
❌ 不好的做法: 完成多个功能 → 批量更新文档
✅ 必须做到:
@.claude/skills/arch-common/SKILL.md@.claude/skills/arch-common/SKILL.md@standards/core/architecture/README.mdscripts/architecture/python/config.yaml最后更新: 2025-12-28 规范版本: v4.5 Skill 版本: 2.3.0
Aria 项目级配置加载器（内部基础设施）。 查找、解析、验证 .aria/config.json 并合并默认值。 此 Skill 不直接触发，由其他 Skills 引用以读取项目配置。
项目状态扫描与智能工作流推荐，十步循环的统一入口。 收集项目状态、分析变更、推荐最佳工作流、引导用户确认执行。 使用场景："查看项目当前状态"、"我要提交代码"、"开发新功能"
会话收尾 —— 在任意对话(含未走完十步循环的探索/调试/讨论 session)把"未交接成果" 固化为 handoff。**与十步循环正交平级的会话仪式**(非周期收尾): AI 先内省本对话出 未完成线程 + 待固化经验, 再用机械 autofill 交叉核验补漏, 写 docs/handoff/。leaf — 终结于写交接, 不拖入十步循环。 使用场景: "对话收尾" / "执行对话收尾" / "会话收尾" / "session closeout" / "收尾这次对话" / "写交接" / "写 handoff" / "收工" / "结束本次对话" / context 快满时主动收尾。 不适用 (用 phase-d-closer): "Phase D" / "周期收尾" / "归档 Spec" / "更新 cycle 进度" —— 那是开发周期收尾, 不是会话收尾。
Git 多远程 parity 检测与 push 验证的共享基础设施。 内部工具, 仅供其他 skills 引用。提供标准化 Bash/Python 执行脚本段 + 输出 JSON schema 契约。
任务到 Agent 的智能路由器，根据任务类型、文件路径自动选择最合适的 Agent。 使用场景：subagent-driver 需要为任务选择 Agent、不确定应该使用哪个 Agent
向 Aria 维护团队报告 Bug 或提交功能建议。自动收集环境信息， 自动路由到 Forgejo（内部用户）或 GitHub（外部用户）。 使用场景："报告 bug"、"report an issue"、"提交功能建议"、 "aria 有个问题想反馈"、"feature request"、"提 issue"、 "反馈问题"、"report bug to aria"