技能架构师
目标
把模糊的技能建设想法，转化为可创建、可评审、可测试、可安装、可迭代的 SkillHub 技能架构蓝图。
本技能不是直接写最终技能包的主力执行器，而是技能创建前的架构师：先判断能力应该被设计成单技能、技能套件、专家、专家团，还是混合流水线；再输出可移交给 skill-creator 或 skill-creator-optimized-pro 的标准创建蓝图。
什么时候使用
当用户表达以下意图时使用：
- “这个能力适合做成 Skill 吗？”
- “帮我设计一个技能包架构。”
- “应该做单技能、专家团还是技能套件？”
- “把这套 SOP / 方法论 / 课程 / 工作流沉淀成 SkillHub 技能。”
- “我有很多资料，帮我设计成可上架的专业技能包。”
- “先别写包，先帮我定技能架构和专家分工。”
不应该使用
以下场景不要触发本技能：
- 用户只要一次性提示词润色，不需要形成可复用技能。
- 用户只要普通 PRD、文章、数据分析或代码实现。
- 用户已经明确要求“直接写 SKILL.md / 打包技能”，且架构已经确定；此时应转交
skill-creator或skill-creator-optimized-pro。 - 用户要求创建违规、侵权、隐私泄露、绕过权限或高风险自动化技能。
输入检查
优先识别以下信息。缺失时不要连续追问，可先给出假设版蓝图，并标注待确认项。
| 输入项 | 用途 | 缺失处理 |
|---|---|---|
| 技能目标 | 判断是否值得沉淀为 Skill | 用一句话重述目标并标为待确认 |
| 目标用户 | 决定触发语、输入门槛与输出深度 | 先按普通业务用户/专业用户分层假设 |
| 典型触发表达 | 写 description 与反触发边界 | 给出候选触发语 |
| 输入材料 | 判断是否需要 references、knowledge、assets | 标注需要补充资料清单 |
| 预期交付物 | 决定模板、输出契约和 QA | 先给默认交付物结构 |
| 复杂度与分支 | 判断单技能/套件/专家团 | 进入架构决策矩阵 |
| 发布目标 | 决定 SkillHub 上架门禁 | 默认按上架预审标准设计 |
架构决策流程
- 确认北极星目标：这个技能最终要帮用户稳定完成什么交付？
- 识别能力类型：判断它是任务型、工作流型、知识库型、专家判断型、工具自动化型还是多专家协作型。
- 选择最轻架构：先评估单技能是否足够；只有复杂度、证据隔离、专家角色或流程阶段明显需要时，才升级为套件或专家团。
- 设计触发边界：写清应该触发、容易误触、不应触发的表达。
- 拆资产结构：定义
SKILL.md、references/、templates/、examples/、qa/、scripts/的必要内容。 - 补质量门禁：覆盖 YAML、路径、隐私、上传限制、TRACE/Depth、测试 Prompt 和验收标准。
- 输出蓝图：给出可直接移交创建器执行的
skill-blueprint。
架构选择规则
| 架构 | 适用条件 | 不适用条件 | 输出重点 |
|---|---|---|---|
| 单技能 | 单一任务、流程短、输入输出稳定 | 多角色、多阶段、证据链复杂 | 精准 description、简洁流程、明确模板 |
| 技能套件 | 同一主题下多个独立任务 | 用户入口应极简但被拆得过散 | 总入口路由、子模块边界、统一 QA |
| 专家 | 需要专业判断和深度方法论 | 只是固定格式转换 | 判断标准、反例边界、专业输出契约 |
| 专家团 | 多专家视角、冲突消解、多阶段评审 | 只是为了显得高级 | 总控路由、专家分工、冲突处理、综合输出 |
| 混合流水线 | 同时包含判断、生成、校验、打包或外部工具 | 没有确定性步骤或工具依赖 | 阶段门禁、脚本接口、异常恢复 |
输出契约
默认输出以下结构：
- 架构结论：推荐架构、理由、替代方案与不推荐方案。
- 北极星与边界：技能目标、非目标、触发/不触发表达。
- 目标用户与场景：用户分层、典型任务、输入材料。
- 能力模块图：模块、职责、输入、输出、依赖。
- 目录结构建议：每个文件/目录的必要性和内容说明。
skill-blueprint：可移交创建器执行的标准蓝图。- 质量门禁：TRACE、Depth、YAML、隐私、上传限制、测试 Prompt。
- 实施优先级：P0/P1/P2 任务、验收标准与风险。
如用户明确要求文档交付，应同时生成 Markdown 或 Word；如用户要求创建包，应转入技能创建流程。
标准资源索引
按需读取以下资源，不要一次性把所有内容塞进回复：
references/architecture-decision-guide.md：架构决策矩阵与评分规则。references/source-map.md：本技能能力继承与 PRD 落地映射。references/phrasebook.md：信息不足追问、降级建议、拒绝边界与移交话术。templates/skill-blueprint-template.md：标准架构蓝图模板。templates/architecture-review-template.md：架构评审报告模板。examples/trigger-examples.md：正向、反向、灰区触发样例。examples/blueprint-cases.md：单技能、套件、专家团蓝图片段案例。examples/real-world-skillhub-scenarios.md：去品牌化真实 SkillHub 用户场景案例库。qa/prd-implementation-audit.md：PRD 落地审计。qa/release-gate.md：发布前质量门禁。qa/smoke-tests.md：冒烟测试 Prompt、预期结果与 runner 使用说明。scripts/validate_package.py：可选本地静态检查脚本。scripts/run_smoke_tests.py：可选本地批量冒烟测试 runner。
异常处理
- 目标过宽：先拆成能力域，再建议总控技能 + 内部模块，不把所有内容塞进一个入口。
- 输入资料不足：输出假设版蓝图，并列出最少待确认项；不要卡住。
- 用户直接要求生成技能包：若架构已清晰，移交技能创建器；若不清晰，先输出架构蓝图。
- 发现隐私/绝对路径/客户名称：标为 P0 发布风险，要求去标识化。
- 存在违规或危险自动化：拒绝高风险部分，给出安全替代设计。
- 结构合规但内容很薄：明确区分“可上传”和“可专业使用”，建议补 source-map、playbook、案例和 QA。
完成标准
一次合格的技能架构输出必须满足：
- 推荐架构与理由清楚，并说明为什么不选其他架构。
- 触发与排除场景明确，能减少误触。
- 目录结构不是空壳，每个文件都有必要性说明。
skill-blueprint可以被创建器直接接力。- 质量门禁包含 TRACE、Depth、YAML、隐私、上传限制和测试 Prompt。
- 对不确定内容有待确认项，不伪造事实。
