伙伴技能工厂

要解决什么问题

很多团队把 Agent 能力写成「长对话 + 口头约定」：流程藏在聊天记录里，节点没有状态，外部 Skill 挂了只能人工兜底，产物格式各写各的。上线后很难复现、诊断和恢复，更谈不上当可安装的「数字员工」交付。

mate-skill 面向的是：把业务流程固化成结构化 Claude Skill，并在设计阶段就把执行保障写进规格，而不是事后补文档。

技能如何工作

工作流覆盖 项目初始化 → 流程深挖 → 外部技能集成 → 规则定义 → 命令体系 → 文件生成与质检。关键约定包括：

• 先落盘：关键信息写入当前项目的 .mate/**/*.md，用 STATE.md 追踪阶段、版本与下一步。
• BLOCKING 门禁：第 2、3 轮有强制校验；I/O 全链贯通后才允许继续；/mate-validate-flow 做链路检查。
• 节点状态机：每个 workflow 节点声明 pending / running / waiting_user / retrying / passed / failed 等；上游 passed 或用户确认 skipped 后下游才可启动。
• 质量与依赖：节点定义成功/失败判定、超时与重试；外部 Skill 必须有可执行降级方案；/mate-build、/mate-validate 按步骤产物清单逐项核对。
• 命令路由：/mate-init、/mate-edit-flow、/mate-add-skill、/mate-build、/mate-export 等读取 commands/ 与 workflows/ 模板驱动生成。

适用边界

• 默认中文优先；适合愿意配合多轮追问、并在 .mate/ 维护规格的团队。
• init 阶段刻意少问，缺口会记入 PROJECT.md「待补充信息」，需后续用编辑/集成命令补齐。
• 强调企业级流程与门禁，轻量「只生成一份 SKILL.md」的场景会显得偏重。