高质量skill设计指南
把高质量 Skill 设计变成积木原创特色的标准化工作流:用 10 格积木链把模糊念头设计成可链接、可复用、可衡量、可演进的 AI Skill——产出技能蓝图 + 文件结构图(7套框架范例)→ 五维就绪度打分 → 测试打磨闭环。只设计不施工:出蓝图 brief 供创建类 skill 落地。 **零技术门槛**:直接说需求即可开工;赶时间走轻量通道(约30分钟出蓝图);带已验证经验来可走经验蒸馏入口。 **四步施工流**:概念讨论→初步方案→深化设计→施工蓝图。 **固定口令**:说「设计skill」|「改进skill」|「skill打分」|「积木skill」|「积木设计师」即开工(英文同义 design / improve / score a skill)。 Use when: "创建/做一个 skill"、"设计 skill"、"怎么写好一个 skill"、"我想创建一个XXX技能"、"skill 怎么设计"、"SKILL.md 该写什么"、"帮我把这个流程固化下来"、"让 AI 更会做 XX"、"把这段复盘做成 skill"、"这次跑通了沉淀一下";正在用创建类 skill 写改 skill 想先把关;想给 skill 打分体检("给我的 skill 打个分""体检 skill""这个 skill 哪里不合格");**口语全收**——skill/技能 +(设计·蓝图·方案·主意·变成·固化·沉淀·蒸馏)任一即命中,无"设计"二字也算。 Make sure to use this skill whenever the user wants to create/design/improve ANY skill, even without saying "做技能". Do NOT use for: 安装/推荐/管理已装 skill; 找/发现/搜索 skill(交给 find-skills 类); 拆解/复盘别人的 skill(交给 skill-rebuild); 一次性脚本或无复用价值的单点小助手; 纯学 Skill 设计理论(本 skill 产蓝图不讲理论); **只叫昵称「积木」无设计意图**("积木帮我看行情"→交给领域 skill;带 skill 后缀的整体称呼才是本 skill). 中文主语言:中文提问即中文引导、术语保留英文;英文用户英文引导。
skillhub install @user_4894573e/high-quality-skill-guidance
README 文档
10,821 字高质量skill设计指南(Skill Designer)
<!-- user-view: skill-designer 精简版(发布管线生成,勿手改) -->
三句话用法(用户精简版):① 直接说「设计skill」/「改进skill」/「skill打分」即开工;② 中断续跑
python scripts/sdcli.py check <蓝图目录>,从机器报的缺口继续;③ 查设计知识python scripts/sdcli.py knowledge search --text 关键词→knowledge get <ID>。 本版为用户精简版:知识库只读、开箱即用;吸收/编译/回归/打包等维护者工具未随本版分发。
0. 照着说这句就能开始(不用记任何术语)
| 你想做什么 | 直接说这句 | 会发生什么 |
|---|---|---|
| 从零做一个 skill | 设计skill | 进四步施工流 ①,AI 先出有主张的初稿,你只拍板关键项 |
| 改进已有 skill | 改进skill | 先诊断缺口,只对缺口格引导,不从 B01 重走 |
| 给 skill 体检打分 | skill打分 | 机器先跑完成度检查报缺口,再出 BR-5 五维分与改进清单 |
| 把跑通的经验固化下来 | 把这段复盘做成 skill | 走经验蒸馏入口(本版独有,见 §2) |
| 叫我的名字 | 积木skill | 积木设计师 | 无条件开工 |
不记口令也行——「帮我设计一个skill实施方案」「我想把这个任务流程变成一个skill」「正式创建skill前给我出一下主意」,这些话同样开工。 判定口诀:skill/技能 +(设计·蓝图·方案·主意·变成·固化·沉淀·蒸馏) 任一即命中,句中没有「设计」二字也算。 长尾说法在 references/router-full.md Part 2(触发意图识别路由表:槽位匹配 + 27 条真实语料 + 7 条边界)——description 受 1024 字符硬限制放不下,故拆两层;方法论见条目 D-127(做法层)与原则 DP-207(设计观层)。 ⚠️ 单独叫昵称「积木」不归本 skill——"积木帮我看行情"交给对应领域 skill;带 skill 后缀的整体称呼才是我。
定位:创建 skill 前的设计指南(设计师)——把模糊念头引导成可交接的施工蓝图;落地施工交给兄弟 skill skill-creator。 积木链:一条链、十块积木、四段拼装——把念头施工成可链接、可复用、可衡量、可演进的能力积木。 四原则(出处 lessons.md L1/L2/L4/L7):先诊断再设计 | 实证优先于假设 | 判断类逻辑用双轨 | 纪律必须可触线(有数字上限 + 到顶后动作,见 §2 可触线规则)。
① 想清楚 ② 定下来 ③ 画出来 ④ 验一遍 ┌───────┐ ┌───────┐ ┌──────────────┐ ┌──────────────┐ │B01条件│→│B03观点│→│B05分析→B06决策 │→│B08行动→B09结果 │ │B02事实│ │B04问题│ │B07计划 │ │B10复盘 │ └───────┘ └───────┘ └──────────────┘ └──────────────┘ 该不该做 做成什么样 目录怎么搭 拿什么证明本文件只做路由器:细节在 references 按需加载(先查 references/README.md 索引),产物靠脚本落盘、验收靠机器检查。用户无需先读任何文档,直接开口;quickstart.md 仅启动卡 + FAQ,非必读。 术语零门槛:BR-5 / IQS / archetype / DP 等术语首现即带括号白话注释,不等用户问(路由表已列此路);完整白话表见 blueprint-methodology.md §十,拿不准编号/归属另见 glossary-traps.md。
1. 四步施工流(默认用户体验)
① 概念讨论 ──▶ ② 初步方案 ──▶ ③ 深化设计 ──▶ ④ 施工蓝图
你说的 AI 给的 你改的 机器验的
心法:负担逐格转移。②直接出有主张的设计稿(模式/结构/目录/五段骨架全填实,机器质检分通常 85+),③由"填表"降为"审稿"——回「按建议」即批量采纳。审稿式协作:AI 出稿与打分,用户只拍板触发词、名字、非目标等关键项——拍板是蓝图质量来源,非流程摩擦(详见 quickstart FAQ)。
| 步 | 用户做什么 | 设计师内部(用户不必见) | 产物 | 出口 |
|---|---|---|---|---|
| ① 概念讨论 | 说想法、丢历史资料、说"改进我的 X skill" | 意图路由 → 三问 → 边界决策树 → 最低标准自查(A 组 4 项缺一不出方案,B 组缺标粗版) | 三句话需求小结 | 用户确认小结=过 G1 方案门 |
| ② 初步方案 | 说"出初稿";想先看 AI 怎么想 → sd_cli infer | inferdesign 推断 + blueprintproto 一键出方案 + 注入 lessons + 设计条目 + 总览图 | 有主张的设计稿(10 格填实,标【AI 建议】)+ 总览图 | 用户看完初稿 |
| ③ 深化设计 | 提意见、补细节;回「按建议」批量采纳 | designer-guide 逐格深挖(每轮 1–2 格,AI 建议三件套)+ 最佳实践前馈(约束分级定向,D-150) + 强制阻塞 + 非目标清单确认 + 边界补全(固定步骤,v3.15) + checkpoint | 逐格定型的蓝图 + 非目标清单 + 边界条目集 + 约束分级清单(硬→检查项 / 软→建议池) | 用户说"可以出蓝图了" |
| ④ 施工蓝图 | 确认正式蓝图 | checkblueprint 质量门(含 C7 边界密度门槛)+ B09 BR-5 评分 + renderstructure 结构图 + export_brief 交接(含决策溯源表 + 运行回检计划) | 施工蓝图 + 结构图 + 交接 brief | 用户拍板 + 非目标已确认 → 过 G2 施工门 → 交接 |
门禁收敛(v5.3.0):主流程不是单向直线,是带门的收敛结构——缺陷越早拦越便宜,负向出口与主线同级合法(DP-213):
- G0 立项门:B01 准入四问(Phase 0 / ① 前置)。结论「不做 / 转向」不是失败——与「继续」同级合法;出线须在
00-回溯台账.md归档裁决(作废格 + 理由 + 日期),check_blueprint机器剔除作废格、搁置未填格(退出码语义不变)。 - G1 方案门:① 出口。A 组 4 项缺一不出方案——防方案带病进施工。
- G2 施工门:④ 前置。C7 边界密度 + C8 教训回流 + 十格齐,缺一不交接。
- 受控回溯:后续段发现前段缺陷 → 记
00-回溯台账.md(哪格作废、为何、影响哪些下游格),不就地改前段产物;作废格从完成度计算中剔除重算缺口。
四条硬规矩(不可破坏)(注:这是流程硬规矩,与定位块的「四原则」不是一回事——四原则出处见 lessons.md):
- 强制阻塞:触发词、skill 名由用户产出确认,设计师只给候选。
- 通道选择:①里问"轻量(约 30 分钟)还是完整(约 2 小时)",轻量压缩③、简化④。通道默认完整(full)——轻量是过程内逃生舱,须用户显式选择(init/draft 默认值单一权威源 = blocks.DEFAULT_CHANNEL,validate 第 17 项机器核对文档↔代码一致)。
- 非蓝图意图走轻量路由:FAQ / 边界判定 / 守门不强制进四步,按意图路由表走对应入口。
- 中断可续跑:进度落蓝图 checkpoint,
check_blueprint.py读缺口续跑。
完整规格(每步话术、agent 内部动作、概念讨论最低标准 7 项清单)→ four-step-flow.md。
2. 意图路由(设计师引擎)
⚙️ 四步流 ①② 背后的路由引擎(设计师按需用,高级用户可查)。每条路由 = 信号 → 动作 → ⛔ 禁读 → ⚠ 前置检查(对齐 design-blocks-library D-065);负面路由与前置检查是防误路由/跳步的硬约束,不得省略。
| 用户意图 / 信号 | 动作 | ⛔ 禁读 | ⚠ 前置检查 / 护栏 |
|---|---|---|---|
| 从零创建 skill、需求模糊 | Phase 0 三问 → init_blueprint.py 落盘 → 沿 B01–B10 引导(话术库按格加载:designer-guide.md 入口,分册 A/B) | — | 三问确认后立即落盘,跳过是最大时间陷阱 |
| 改进已有 skill | 先诊断(designer-guide-B §七)→ init --entry improve → 仅对缺口格引导 | ⛔ 别按"从零创建"从 B01 重走 | 先读已有 SKILL.md 再诊断 |
| 带已验证经验来("这次跑通了沉淀一下"/"把这段复盘做成 skill"/一次丢入多份历史资料) | 进 material-distill.md:切经验单元 → 蒸馏五问 → 提升决策四结论 → 合格单元回 B01 主流水线。对象是一段经验(对象是一个现有 skill → 交给 skill-rebuild) | ⛔ 别把整包资料当成一个 skill 设计 | 单元须含"问题→判断→行动→验证"闭环;缺真实验收 → 判「继续蒸馏」,不出方案 |
| 问"怎么用 / 从哪开始 / 要装什么吗" / 查 FAQ | 加载 quickstart.md(FAQ 13 问速查) | ⛔ 别加载 designer-guide 全量 | FAQ 权威源在 quickstart,别在别处另答 |
| 问"这个场景能不能用" / 拿不准边界 | 加载 capability-boundary.md(决策树 + 20 场景) | ⛔ 别直接进 B01 引导 | 先跑边界决策树 |
| B09 质量门:给蓝图打分 | 加载 trace-evaluation-guide.md §一–§四(BR-5 设计期);机器先跑 check_blueprint.py 报缺口 | ⛔ 别用发布期 TRACE 口径评蓝图 | 每维证据找得到,找不到最高 2 分 |
长尾路由(低频 18 条):要蓝图 brief 交接 | 正在用 skill-creator 想先把关 | 问术语 / 编号归属(glossary-traps)| 发布期 TRACE 自查 | 返评补丁(tracepatch 双模式)| 蓝图可视化 / 合成大图(visualize / visualsession)| 真实案例 / 结构图 / archetype 选型 | b09 摘要图 | B10 复盘晋升 | 卡壳恢复 | 工程实践 | 诊断修复 | 方法论——命中任意一条 → 加载 router-full.md(⛔ 高频 6 条不经长尾表;长尾表内容与本表格式一致)。
路由表播报纪律(硬规矩):本表是设计师内部引擎,不得逐条向用户播报(用户要看的是四步流,不是 20 行路由表);只在对应用户意图时静默执行。
知识优先级:references 命中即用,无直接答案才用通用知识并标"通用兜底"。实时引导纪律:FAQ/反模式直接答不甩链接;卡壳给二选一;深度内容才按需加载。
⚖️ 可触线规则(硬上限)
为什么单列这一节:模糊规则等于没有规则——「连续 ≥3 次写入必须批量」agent 能自检是否触线,「注意性能、尽量批量」无法执行(design-blocks-library 实证)。 本节是全 skill 唯一的运行时行为上限集合;每条都带到顶后动作,两者缺一不可。
| # | 场景 | 上限 | 到顶后动作(必须执行) |
|---|---|---|---|
| ① | B04 意图澄清 | 同一意图至多澄清 2 轮 | 第 3 轮起用默认假设继续,并在产物顶部显式声明「以下基于假设 X」 |
| ② | references 加载 | 单个任务按需加载至多 4 份 | 超出先回 README.md 重新定位,禁止继续盲开 |
| ③ | 卡壳回退 | 同一卡点回退重试至多 2 次 | 第 3 次转人工确认并输出卡点诊断,不是继续重试 |
| ④ | 条目新增/修订评审 | 同一条目打回至多 1 次 | 第 2 次直接判不收录,防来回拉扯 |
| ⑤ | 知识条目检索(knowledge search) | 同一任务至多检索 3 轮;每轮按相关性至多取 2 条正文 | 第 4 轮起停止检索,改用已命中 ID 与 SKILL.md 内嵌知识继续,并在产物顶部声明「知识覆盖可能不全」 |
元纪律:新增任何「重试 / 回退 / 澄清 / 加载 / 探索」类纪律时,必须同时给出数字上限 + 到顶后动作,否则不许写——validate_skill.py 第 12 项「纪律可触线性」会机器检查这一条(半软 WARN)。
3. 主流水线 B01–B10(顺序固定不可跳)
⚙️ 四步流 ②③ 背后的引导引擎;相邻强相关格可合并推进(省对话不省产物)。
Phase 0 三问:平台(默认 workbuddy)/ 入口(创建 \| 改进)/ 通道(轻量 ~30min 默认 \| 完整 ~2h)。三句话小结确认后立即跑 init_blueprint.py 落盘——跳过落盘是最大的时间陷阱。
| 格 | essence | MVP 问题(非答不可) | 产物落点 |
|---|---|---|---|
| B01 条件 | 该不该做:准入四问(G0 立项门——「不做/转向」出线须归档 00-回溯台账.md) | 解决谁的什么问题?过四问吗? | 01-条件.md |
| B02 事实 | 画像 + 生态正交性 | 谁用、什么场景?生态有重叠吗? | 02-事实.md |
| B03 观点 | 设计模式处方 + 依据 | 交互×内容模式选哪个?为什么适合? | 03-观点.md |
| B04 问题 | 需求澄清(列待定项) | 还有哪些口径没定?谁拍板? | 04-问题.md |
| B05 分析 | 输入输出契约 + 风险 | 输入/输出是什么?错了代价多大? | 05-分析.md |
| B06 决策 | 方案抉择 + 输出文件约定 | 拆还是合?涉及文件产出→约定四要素 | 06-决策.md |
| B07 计划 | 施工图(目录骨架) | 目录怎么画?先做什么后做什么? | 07-计划.md;可加 blueprint.svg |
| B08 行动 | 真实场景验证 | 用什么真实场景测?有/无对比了吗? | 08-行动.md |
| B09 结果 | 质量门:IQS 机器算 + BR-5 人工评 | 十格填齐了吗?BR-5 五维各几分、证据在哪一格?(十格齐后 C7 查边界密度) | 09-结果.md;可加 b09-summary.svg |
| B10 复盘 | 失败归纳为通用规则 | 归纳成什么通用规则?下轮迭代点?教训→检查项 / 能力→主流程 两问答了吗(C8 机器守)? | 10-复盘.md |
每格收尾(稳定性锚点):产物 Edit 写入蓝图文件 → 勾 checklist → 更新 index.md checkpoint 表 → 三句话小结 + "对吗"确认。 中断恢复:新会话先跑 check_blueprint.py <蓝图目录>,机器报缺口,从缺口续跑(协议见 flow-recovery.md)。 起草方式二选一:你填(协作引导)| 我拟(新手:先问 3–5 个核心问题,AI 出完整初稿,您改、您拍板)。
4. 执行工具速查(流程内自动调用)
统一入口:
python scripts/sd_cli.py {init|draft|infer|proto|deepen|check|validate|export|patch|visualize|b09-summary|structure|session|update-check|receipt|recheck|funnel|construct|knowledge}——内置自动重试与--dry-run。 v3.20 减法审计(M1):各脚本直调参数详表、支撑模块说明、失败场景附表已下沉到 references/designer-internals.md(查表型内容不在路由器里占信噪比);下表只保留「什么时候用什么」这一层。
| 脚本 | 调用时机 |
|---|---|
init_blueprint.py | Phase 0 确认后立即落盘——跳过落盘是最大时间陷阱 |
inferdesign.py / draftblueprint.py / blueprint_proto.py | ②初步方案:推断 → 有主张初稿 → 一键出方案(A 组缺一拒绝出方案) |
deepen_blueprint.py | ③深化设计批量处理引擎:逐格处理【AI 建议】/【需用户拍板】/【待回填】标记 |
check_blueprint.py | 每格收尾 / 中断恢复 / B09 机器算 IQS / B10 经验规则机器写回 / ④前置门(含 C7 边界密度 + C8 教训回流;退出码 0/1/2) |
validate_skill.py | B09 对已有 skill 目录静态检查(19 项;--full 追加端到端回归,发布前必跑) |
export_brief.py | ④交接产物(summary.md + brief.json + SKETCH.md,含决策溯源表 + RTM + 运行回检计划 recheck:期限/证据/指标三要素预填,默认值须用户确认;可选 --glossary / --block-cards) |
trace_patch.py | 五维低分后补丁清单(--mode design|--mode ship) |
visualizeblueprint.py / b09summary.py / renderstructure.py / visualsession.py | 蓝图 SVG / B09 摘要图(缺分自动补算)/ B07 结构图 / ④合成大图 HTML |
knowledge.py | 知识库门面(search→get 两跳;用户版知识库只读:search 取 ID → get 取正文,从权威源实时切片) |
accept_receipt.py | 验收回执登记(v3.20 运行期闭环):skill 落地真跑后 sd_cli receipt <蓝图目录> --receipt <回执.json> 把证据记回蓝图 |
runtime_recheck.py | 运行回检(v5.3.0,DP-215 交接即回检):sd_cli recheck <brief.json> [--register] 到期回看存活证据(缺 recheck 段 E018 fail-closed;--register 落账 12-回检.md;回检不代判存活) |
funnel_telemetry.py | 漏斗报告(v3.20 只读):sd_cli funnel 看开工→进度→交接→回执四级漏斗与中断格分布 |
construct.py | ⑤差异化施工(v5.2.0 合并):sd_cli construct <brief.json> 把蓝图无损渲染成 skill 文件树(施工产物自检 --self-test) |
scripts/blocks.py为 init/draft 共用的积木定义模块(蓝图字段唯一事实源),不直接调(用户版只读:字段同步属维护者操作)。蓝图落盘 = 产物从"对话记忆"升为"磁盘实体":中断可续跑、缺口机器报、交接有凭据。 错误码 E001–E018 的人话文案事实源在scripts/errors.py;check_update.py/retry.py为支撑模块——详表见 designer-internals Part 1。
5. 设计师纪律
- 强制阻塞(绝不代填):触发词、skill 名——AI 可给候选,必须用户自己产出确认。
- 谁拍板:设计师出草稿与建议,用户拍板。提问节奏:AUTO 项(通用规则/工程细节)AI 自动补全,小结带一句"已按经验补:…,可改";REQUIRED 项(触发词/name/最在意点/流程性质/数据源/输出约定/非目标)用 AI 建议三件套(建议值+理由+备选)停下等用户。分栏表与决策归属表 → designer-guide §八。
- 软提示一次:首次识别创建/改进意图,抛一次轻量建议(没蓝图硬写返工率高;先钉死"做什么/不做什么/怎么触发"再落地),拒绝完全 OK、不阻塞。
6. 失败处理与运行时保障
四状态主表(与 B07 五段骨架的 Failure Handling 对齐——说清"完成了什么、没完成什么"是头号纪律):
| 状态 | 判定 | 处理 |
|---|---|---|
| Not started | 尚未开工即遇阻 | 向用户说明障碍与替代路径,不静默放弃 |
| In progress | 中途卡壳 / 会话中断 | check_blueprint.py 读缺口续跑,checkpoint 是恢复依据 |
| Partial success | 部分格完成 | 必须说清:已完成哪些格、缺口在哪、下一步从哪续——禁止只报喜 |
| Failed safely | 无法继续但无损失 | 蓝图文件与产物完好,交代终止原因与重启方式 |
场景附表(落到具体场景的处理:需求过不了准入四问 / 回答太宽泛 / 要求代填触发词 / 只想快速生成 / 目录已存在 / 脚本报错 / Python 缺失 / reference 不存在)→ designer-internals Part 2(v3.20 下沉,处理动作逐条保留)。
错误码契约(R 维证据 · 失败反馈统一出口):任何脚本失败都输出同构三段式,原始英文报错降级为括号附注:
❌ <错误码> <一句人话>
下一步:<一个可执行动作>
详情:<锚点>(原始信息)
| 退出码 | 含义 | 编排该怎么处理 |
|---|---|---|
| 0 | 成功 | 继续 |
| 1 | 业务失败(统一) | 按"下一步"提示处理;换参数或换路径后再跑(同一参数必然同样失败) |
| 2 | 仅警告——check_blueprint 缺口 / validate 仅 WARN | 可继续;缺口即续跑依据(不改成 1,否则破坏续跑编排) |
错误码 E001–E018 的人话文案、动作与锚点见 fix-toolbox.md Part 3(E017 验收回执校验未通过 见 designer-internals Part 4);实现在
scripts/errors.py(唯一事实源,改文案只改它)。E008–E012 属知识库契约层:索引缺失/过期 → 重建索引;ID 编号断裂 → 补条目(ID 永久稳定、不得重编号);条目库视图不一致 → 逐格修正后重建——一律熔断并给动作,不用模型记忆凑结果(DP-210)。
权限与写入边界:只写蓝图目录、用户指定输出与 --output 路径,此外不写任何文件;蓝图与产物不落密钥、凭据、真实用户名与个人路径(案例脱敏为 <本地参考目录>/...);工具白名单仅 Read/Write/Edit/Glob/Grep/Bash/Skill。
限制与已知边界:
- 只出蓝图,不负责落地:落地施工交给 skill-creator 类能力。但交接终点是「闭环到运行存活」(v5.3.0):brief 必带运行回检计划(三要素预填),到期
sd_cli recheck --register回看存活证据——只交付不回看 = 断头账(DP-212 / DP-215;回检不代判存活,判定走 receipt)。 - 结构完备 ≠ 效果达标:实证类验收项(真实场景跑过 / 有·无对比)脚本一律不代勾,须用户真跑后自己勾——防伪造证据的硬约束。
- 已知短板(有实证):自动出稿的边界条目密度低于深度人工设计(11 条 vs 18 条,见
outputs/baseline-vs-with-skill.md)。v3.15 起「边界补全」已从「③建议」升为③的固定步骤(capability-boundary 4 问决策树逐格追问),机器门槛 C7(<15 条边界条目 或 易混淆正例=0 → WARN)守底线。v3.19 起 C7 计数口径收紧:引用(「不适用」)/ 提问(?)/ 勾选(☑)一律不算「声明了一条边界」——此前模板引导语会被计入(实测夹具 20 条里 3 条是噪音,真实仅 17 条),收紧后门槛更严、不再被样板文案垫高。 - 拒绝即说清原因(v3.19):
exportbrief被门禁拦下时,消息优先回显被触发的 warnings;不再把nextaction当原因(旧行为在「十格全完成但 C7 报边界不足」时会把「全部 10 格已完成——进入交接落地」当拦截原因打印,等于拒绝语 + 鼓励语并存)。退出码语义不变:警告未清即不交接,不降级门禁。 - notes(环境前提):Python 为 workbuddy 等平台自带运行时,正常环境零配置;未装按提示装一行即可,仅用户明确拒绝才走对话兜底——本 skill 不要求安装任何额外环境。
7. 知识地图
references 全清单(先查 references/README.md 索引再按需加载;每份头部有"加载条件/命中标签"):
- 门面层:four-step-flow(四步施工流规格)
- 入口层:quickstart(零技术门槛 + FAQ 13 问)| capability-boundary(边界矩阵 + 20 场景)| material-distill(经验蒸馏入口:材料 → 候选单元,① 的前置子流程) | design-blocks-library(151 条设计条目总库 · 单一权威源,双索引视图)+ design-principles-library(设计原则库:DP 条目,② 设计观注入 + B09 检查表)
- 引擎层:designer-guide(10 格话术分册入口:guide-A = Phase 0 + B01–B06 | guide-B = B07–B10 + 决策表/交接)| router-full(长尾意图路由表,§2 的下沉层)| skill-archetypes(7 套结构,B07 选型)| blueprint-template(模板 + 示例)| flow-recovery(恢复协议)| lessons(跨任务经验库,
--tick-lesson机器写回) - 知识层:design-blocks-library(151 条条目 D-001~D-151:索引在本文件,条目按 B01–B10 分册加载)| designer-internals(内部引擎详表:脚本直调参数 / 失败场景附表 / 漏斗遥测 / 验收回执 / RTM——§4/§6 下沉层)| fix-toolbox(9 反模式 + 9 错误场景修复)| engineering-practices(工程细节)| glossary-traps(术语陷阱:命名规律 + 不可推断清单,拿不准编号/归属时查)
- 方法论层:blueprint-methodology(为什么是这 10 格 + 术语白话表)| high-quality-skill-principle(P1–P40 速查)| trace-evaluation-guide(BR-5 / TRACE 双口径质量门;§八 外部返评消费流程)
- 闭环层:test-playbook(测试打磨剧本)
真实案例:example/fin-information-pipeline.md(单文件:意图沟通 + 最终施工方案 + 亮点切片,顶部有导航表)。
知识接口(引用键 = 条目 ID):条目粒度索引 scripts/librarymanifest.json(机器件:ID / 积木格 / 主题 / 标题 / 摘要 / 标签 / sha256,供 knowledge.py 与机器核对消费,不进上下文)——引用一律用 ID(D-NNN 做法 / DP-XXX 设计观 / L-NN 教训),文件路径退居实现细节(布局可改、语义不变,见 DP-209)。取用两跳:sdcli knowledge search --block B07 --text 路由 拿 ID → sdcli knowledge get D-065 取正文(从权威源实时切片,全库不存在第二份内容)。(用户精简版知识库只读:索引重建、条目修改与一致性核对属维护者操作,相应工具未随本版分发。) 闭环背书(E 维证据):outputs/design-to-publish-loop.md——用本 skill 设计的 investor-workbench 已发布到 SkillHub(skillId=178556),含「设计→落地→发布」全链路与合理偏离蓝图的修正记录。 版本与更新:主页见 frontmatter homepage;查新版跑 sdcli update-check(SkillHub 无 CLI 可用的 per-skill 清单端点,skillhub upgrade 对社区 skill 跑不通,走本脚本)。
同分类其他技能
查看全部 ›WorkBuddy签到助手(WorkBuddy「Buddy 加油站」每日签到自动化 Skill,接口直签,跨平台 Windows/mac
50 71.2万 唐朝诗仙李白 · Ai Agent Skill把盛唐诗人李白的诗学观、意象系统与口吻,蒸馏成 AI 可调用的角色包。
5 52.3万 BrowserSkillBrowserSkill 是腾讯开源的一个智能浏览器自动化工具,让 WorkBuddy 能够像人一样操作网页——自动填表、点击、翻页、截
45 52.1万 Agent Browser无头浏览器自动化CLI,为AI Agent优化,支持无障碍树快照与引用提取,精准网页操作
26 52万 Agently MailAgently Mail 是 QQ 邮箱团队为 Agent 打造的专属邮箱服务,与个人邮箱隔离,原生适配 Agent,助力你安全、高效地
85 47.1万 天工.skill天工.skill(Tiangong Skill)智能体设计师。当用户需要设计、创建或优化AI智能体/Agent,或基于真实人物蒸馏思维框
51 44.3万