用途：manage-issue 用于在命令行中管理 issue 的全生命周期，支持创建、列表查询、查看详情、更新、关闭以及与任务双向关联，构成 issue → 分析 → 计划 → 执行的闭环工作流。
主要能力：子命令包括 create、list、status、update、close、link。create 会依据 ~/.maestro/templates/issue.json 的 schema 生成 ID（格式 ISS-{YYYYMMDD}-{NNN}）并追加到 .workflow/issues/issues.jsonl；list 合并活动与已关闭 issue，支持按 --status、--phase、--severity、--source 过滤并以表格展示；status 按 ID 显示全部字段；update 合并字段并记录 updated_at；close 设置状态为 closed、加入 resolution 与 closed_at 并移入 issue-history.jsonl；link 在 issue 与 task 之间建立双向引用，两次写入都成功才算完成，task 写入失败会回滚。
使用方式：执行前需阅读 ~/.maestro/workflows/issue.md，了解 issue.json schema、ID 格式、字段校验与 JSONL 存储约定。示例命令如：$manage-issue "create --title 'Auth token expiry bug' --severity high --source manual"；$manage-issue "list --status open --severity high"；$manage-issue "update ISS-20260318-001 --priority critical --tags auth,security"；$manage-issue "close ISS-20260318-001 --resolution fixed"；$manage-issue "link ISS-20260318-001 --task TASK-003"。
限制：所有文件写入只能针对 .workflow/issues/issues.jsonl、issue-history.jsonl 或 .workflow/issues/ 目录，绝不修改源代码或这些路径之外的文件。解析阶段要求子命令有效，否则以 E_NO_SUBCOMMAND 或 E_INVALID_SUBCOMMAND 阻断；目录缺失时为非阻断警告 E_ISSUES_DIR_MISSING 并自动创建。update/close/link 需目标 issue 存在，close 需用户确认（除 -y），link 写入前需同时校验 issue 与 task。自动化 issue 发现请使用 $manage-issue-discover。