AgentHero AI 是一个用于管理分层多智能体系统的编排技能（V2.0），以 PM 协调智能体为核心，围绕“主题（topic）”组织项目，并以文件作为状态存储载体。
用途：为 Claude Code 中的多智能体协作提供状态管理、主题生命周期管理和任务协调能力。当 PM 编排器需要维护状态文件、创建或更新主题元数据、初始化子智能体任务状态、归档已完成主题、或读取编排状态以恢复工作时，该技能会被自动激活。
主要能力：
- 主题管理：通过 topic_manager.py 创建主题、列出活跃/已完成主题、查看主题进度与指标、更新最近活跃时间、重算进度、归档、恢复、标记完成及删除主题，并可输出用于 SessionStart 钩子的活跃主题摘要。
- 状态管理：通过 state_manager.py 实现状态文件的创建、字段读取与更新、日志追加、任务状态设置、文件变更跟踪、进度更新（0–100）、JSON 结构校验，以及阻塞性问题与回答、任务结果的设置。
- 工具函数：utils.py 提供项目根目录查找、slug 生成、任务 ID 生成、ISO 8601 时间戳、原子写入、目录创建、JSON 读写、数组追加与校验等共享能力。
- 目录结构初始化：setup_project_structure.py 为指定主题创建 Project-tasks/{slug}/、spec/ 和 deliverables/ 目录。
- 主题收尾：finalize_topic.py 将主题标记为 completed、写入 completedAt 时间戳并归档目录。
- 注册表校验：check_topics_file.py --summary 校验 topics.json 结构并输出健康状况摘要。
- SessionStart 钩子：get_topics_quiet.sh 在 Claude Code 启动时展示活跃主题及完成百分比与任务进度。
使用方式：以命令行调用技能目录下的 Python 脚本，例如用 topic_manager.py 的 create_topic 创建主题（可带 --description），用 state_manager.py 的 create_state_file、append_log、read_state、update_progress、track_file_change 等子命令维护任务状态，用 setup_project_structure.py 创建目录，用 finalize_topic.py 完成并归档主题。脚本支持从项目根目录运行或依赖 find_project_root() 自动定位含 .claude 的根目录。状态模板定义在 templates/state-templates.json 中，任务状态模板包含 taskId、focusArea、agentName、status、assignedAt、startedAt、completedAt、progress、currentOperation、logs、filesCreated、filesModified、blockingQuestion、result、error 与 tokenUsage 等字段。
适用场景：需要 PM 统筹子智能体分工的多步骤项目开发，例如按主题拆分前后端任务并跟踪进度、记录日志与产物、在中断后恢复工作、在会话启动时快速了解未完成事项。
限制与注意事项：资料未提供收费、价格、平台支持范围或效果保证等信息。状态文件可能包含敏感数据，默认被 Git 忽略（.claude/agents/state/），权限为 644，且不应在状态中存储凭据；建议定期记录日志（至少每 30–60 秒）、按 25%/50%/75%/100% 更新进度里程碑，并跟踪文件变更。若出现 JSON 无效、状态文件缺失或目录错误，可用 validate_state、检查 topics.json、确认从项目根目录或使用绝对路径运行脚本等方式排查。V2.0 相较 V1 已由 Bash 迁移为 Python，主题注册由分散的 topic.json 改为单一 topics.json，并采用绝对路径解析与带校验的原子写入。