nnnightglow/replay/orchestration

编排与规划（Orchestration）

用于需要多角色协作（PM、Architect、Engineer、Analyst、Visualization）的策略任务。

适用场景

• 需求不完整，需要先澄清目标、约束和验收标准。
• 任务复杂，需要分阶段交接与依赖管理。
• 需要输出可执行 ToDo，而不是泛化建议。

标准流程

1. 明确目标、边界、约束、验收标准。
2. 判定当前阶段负责人和下一阶段负责人。
3. 将目标拆解为最小可执行任务。
4. 标注任务依赖、执行顺序与里程碑。
5. 为每个任务定义输入/输出与参数要求。
6. 记录风险、待确认项、检查点与回滚方案。
7. 输出下一步可直接执行的行动清单。

输出契约

• objective: 一句话目标
• constraints: 关键约束
• scope: in-scope / out-of-scope
• stage_plan: 分阶段计划（含 owner）
• tasks: 任务清单（最小可执行单元）
• dependencies: 任务依赖映射
• milestones: 里程碑与交付物
• handoff_artifacts: 阶段交接产物
• acceptance: 验收标准
• risks_and_checks: 风险 + 缓解 + 检查点
• fallback: 回滚/降级方案
• next_actions: 立即可执行行动

任务字段规范（建议）

每个 task 包含：

• task_id
• title
• agent
• description
• params
• depends_on
• milestone
• acceptance
• risk
• rollback

护栏

• 不要无节制增加角色，优先复用现有角色与技能。
• 先确认需求清晰，再进入实现与分析。
• 计划必须可执行、可验证，避免抽象口号。
• 优先走 MVP 路径，先交付主链路，再做扩展。

脚本入口（查看 subagent skill）

• 脚本：scripts/list_subagent_skills.py
• 默认展示 architect_agent 的下游 subagent 及其 skill_ids

示例：

• 查看 architect_agent 下游 subagent 的 skill
• python skills/orchestration/scripts/list_subagent_skills.py
• 递归查看下游链路
• python skills/orchestration/scripts/list_subagent_skills.py --recursive
• 查看全部 agent 的 skill
• python skills/orchestration/scripts/list_subagent_skills.py --all-agents
• JSON 输出（便于上层程序消费）
• python skills/orchestration/scripts/list_subagent_skills.py --json
• 查看指定 subagent（可多次传入）
• python skills/orchestration/scripts/list_subagent_skills.py --agent analyst_agent --agent engineer_agent
• 同时查看 skill 的内容摘要与能力条目
• python skills/orchestration/scripts/list_subagent_skills.py --agent analyst_agent --include-skill-content