YYOS

YYOS 是一个“团队工程协作调度器”项目：
它既是一个可复用 skill（skills/yyos/SKILL.md），也是一个可直接运行的命令行入口（yyos）。

核心目标是把多人 AI 协作从“靠感觉”变成“可路由、可验证、可追踪”。

当前仓库已公开，可直接 git clone https://github.com/Qingjingyu/YYOS.git 使用。

程序员最小工作流（你当前要的模式）

只需要记住一条主线：

1. yyos <任务>：先让 YYOS 自动判断是否用 skill / MCP / GitHub。
2. 缺能力时：yyos <任务> --discover-ecosystem 先发现候选。
3. 确认安装：yyos <任务> --discover-ecosystem --confirm-discovery-install。
4. 需要自动推进时：yyos <任务> --auto-execute。

示例：

yyos 优化发布链路并补齐能力
yyos 优化发布链路并补齐能力 --discover-ecosystem
yyos 优化发布链路并补齐能力 --discover-ecosystem --confirm-discovery-install
yyos review github PR并合并 --auto-execute

小白 3 分钟上手

1. 安装命令入口（一次即可）：

bash skills/yyos/scripts/install_yyos_command.sh

2. 不知道下一步做什么：

yyos

3. 选择系统建议任务执行：

yyos 1

4. 直接输入需求让 YYOS 路由：

yyos 帮我推进官网本周交付

5. 让 YYOS 自我讲解（新同事推荐）：

yyos 讲解一下YYOS怎么用

6. 查看 MCP 连接状态：

yyos 检查MCP状态

你会看到什么

• 只要进入终端交互模式，输出会先出现 【YYOS MODE】，表示 YYOS 已启动。
• YYOS 会判断：
  • direct_reply：直接答复
  • use_skill：调用 skill 执行流程
  • create_skill：建议沉淀新 skill
• 输出中会包含阶段、风险、下一步命令、工件与状态信息。
• V3 任务会额外输出：
  • semantic_plan：语义目标、实体识别、工作流图
  • mcp_action_plan：MCP 动作计划（默认 dry-run）
  • auto_pr_plan：自动 PR 流水线计划（默认 dry-run）
  • bootstrap：GitHub/MCP 环境安装与接入计划（默认 dry-run）
  • ecosystem_discovery：外部 GitHub/Skill/MCP 候选发现与评分
  • ecosystem_mcp_installation：MCP 候选安装结果（含校验信号与回滚建议）
  • autonomy：执行自治模式（auto/confirm/manual）与触发原因

当前能力（默认）

• 阶段路由：plan/implement/test/review/release/learn
• skill 调度与缺失 skill 安装建议
• 非编号任务自动执行（--auto-execute）
• 语义任务规划（semantic_plan）与工作流图输出
• 质量门禁：artifact_contract / enforce_gates / pr_gate
• 发布演练与回滚：multi_repo_release
• 项目状态续接：artifacts/yyos-project-state
• MCP 服务就绪检查：skills/yyos/references/mcp-servers.json
• V4 指标基线检查：skills/yyos/references/v4-success-metrics.json
• 运营 KPI 仪表盘：python3 skills/yyos/scripts/yyos_dashboard.py

能力全景（Skill / GitHub / MCP）

1) Skill 能力

• 智能决策：自动判断 direct_reply / use_skill / create_skill。
• 阶段策略已增强：
  • plan：含 workflow-orchestration-patterns
  • test：含 promptfoo-evaluation
  • review/release：含 security-review
  • learn：含 llm-evaluation
• 缺失 skill 自动发现后，安装前会做来源策略校验（白名单 + pinned ref）。
• 新增 integration lock：安装前会校验来源是否在锁文件内，避免接入漂移。
• 缺失 skill 候选会按 GitHub 质量信号（活跃度/星标/许可证）排序后再尝试安装。
• V3.2 新增生态发现：可按当前任务自动发现候选 skill 仓库与 MCP 项目，并支持确认后安装可信候选。

2) GitHub 能力

• 已内置 yyos-pr-gates 工作流，可对工件和流程进行 PR 门禁。
• PR 门禁已升级 V4 必检：缺少 autonomy-policy / integration-lock / rollback-policy 会直接失败。
• 已内置分支保护配置脚本，支持把 pr-gates 设置为 main 必过检查。
• 已内置多仓发布计划、执行、回滚与审计日志能力（artifacts/release-audit.jsonl）。
• V3 新增 auto PR 流水线计划（auto_pr_plan），支持 dry-run 预览与确认执行。
• V3.1 新增 GitHub 智能 bootstrap 计划与执行（bootstrap / bootstrap_execution）。

3) MCP 能力

• 已支持 MCP 就绪度检查（命令/HTTP），并可通过 yyos 检查MCP状态 输出健康报告。
• 对 use_skill 任务新增 MCP 依赖守卫：当任务依赖的 MCP 不可用时会自动阻断并提示修复。
• V3 新增 MCP 动作编排（mcp_action_plan / mcp_execution），配置文件：skills/yyos/references/mcp-actions.json
• V3.1 新增 MCP 智能 bootstrap：可自动生成 Node/npx/MCP 注册计划并确认执行。
• V3.3 新增 MCP 候选自动安装：在 --discover-ecosystem --confirm-discovery-install 下可安装可信候选，并执行仓库信号校验（README/包管理文件），输出 rollback_suggestions。
• 配置文件：skills/yyos/references/mcp-servers.json
• 当前定位：MCP 健康层能力已可用，深度业务工具编排可继续扩展。

关键策略文件

• 阶段策略：skills/yyos/references/stage-playbooks.md
• 来源白名单：skills/yyos/references/skill-source-whitelist.json
• 决策策略：skills/yyos/references/decision-policy.json
• 自治策略：skills/yyos/references/autonomy-policy.json
• MCP 检查配置：skills/yyos/references/mcp-servers.json
• MCP 候选安装记录：skills/yyos/references/mcp-candidates-installed.json
• 集成锁文件：skills/yyos/references/integration-lock.json
• 回滚策略：skills/yyos/references/rollback-policy.json
• Bootstrap 清单：skills/yyos/references/bootstrap-manifest.json
• Bootstrap 策略：skills/yyos/references/bootstrap-policy.json
• MCP 动作模板：skills/yyos/references/mcp-actions.json

常用命令

yyos --json
yyos 1 --confirm-high-risk-execution
yyos <需求> --confirm-install-missing-skills
yyos <需求> --auto-execute
yyos <需求> --execute-mcp-actions
yyos <需求> --auto-pr
yyos <需求> --auto-pr --confirm-pr-execution
yyos 安装github和mcp --json
yyos 安装github和mcp --confirm-bootstrap-apply
yyos <需求> --discover-ecosystem --json
yyos <需求> --discover-ecosystem --confirm-discovery-install
yyos 检查MCP状态
python3 skills/yyos/scripts/yyos_dashboard.py
bash skills/yyos/scripts/install_all_features.sh

团队落地资料

• Onboarding: docs/runbooks/onboarding.md
• Runbook: docs/runbooks/yyos-v4-rollout.md
• 任务模板: docs/templates/yyos-task-brief.md

V3 示例

# 生成语义任务图 + MCP 动作计划 + PR 流水线计划（均为预览）
yyos review github PR并合并 --current-stage test --auto-pr --json

# 在确认后执行 MCP 动作（非 dry-run）
yyos review github PR并合并 --current-stage test --execute-mcp-actions

# 生成 GitHub + MCP 智能安装计划（dry-run）
yyos 安装github和mcp --json

# 确认后执行 bootstrap
yyos 安装github和mcp --confirm-bootstrap-apply

# 发现适合当前任务的 Skill/MCP 候选（评分）
yyos 优化发布链路并补齐能力 --discover-ecosystem --json

# 对可信候选尝试安装（仍受白名单与来源校验约束）
yyos 优化发布链路并补齐能力 --discover-ecosystem --confirm-discovery-install

兼容说明：os 仍可用，但已弃用，建议统一使用 yyos。