Investoday 技能创建规范

概览

本技能不是官方 $skill-creator 的替代品。创建或精修技能时，通用目录结构、资源组织和打包方法以官方 $skill-creator 为准；本技能只补充 Investoday 技能的触发描述、Frontmatter/YAML 字段、渐进式发现路由和交付检查。

前置依赖

• skill: skill-creator
• package: PyYAML (pip)
• python: >=3.11

输入要求

可接受输入

• 目标对象：Investoday skill 路径、skill 名称、SKILL.md 草稿或待评审的 skill 包。
• 任务类型：创建、修改、评审、补齐字段、检查触发、设计前置依赖、设计输入要求或校验发布前质量。
• 约束说明：是否允许改文件、是否只读、目标分发渠道、是否需要发布前检查。

最小输入

• 目标对象或规范主题。
• 任务类型。
• 输出目标，例如修改文件、只读评审、规范说明或校验清单。

推荐输入

• 目标 skill 的本地路径或完整 SKILL.md 内容。
• 需要遵守的 Investoday 约束，例如 frontmatter 格式、前置依赖、输入要求、subagent 流水线、版本号规则。
• 验收要求，例如必须运行哪些校验、是否需要子代理复核、是否需要发布。

可选输入

• 参考示例、用户真实触发词、反例触发词、目标运行时、目标模型规模。
• 输出格式偏好，例如问题清单、补丁说明、发布报告或规范摘要。

默认假设

• 未指定语言时，使用中文。
• 未指定输出格式时，使用 Markdown。
• 未明确要求发布时，不发布。
• 未明确允许修改时，先做只读分析或追问是否允许修改。
• 未明确要求生产操作时，不执行生产发布、外部发送或下架。

输入校验

• 如果给出路径，先确认路径存在并读取目标 SKILL.md。
• 如果给出 YAML/frontmatter，先确认可以解析。
• 如果涉及版本号，按语义化版本规则判断。
• 如果涉及前置依赖，校验正文“前置依赖”与 frontmatter requirements 一致。
• 如果涉及 subagent，运行或建议运行 scripts/validate_agents.py。

缺失输入处理

• 缺少目标对象、任务类型、是否允许修改、是否发布或目标环境时，先追问，不猜测关键事实。
• 一次最多追问 1-3 个阻塞问题，优先补齐目标对象、任务类型和高风险边界。
• 如果用户没有补齐关键输入，只能先做只读分析或输出待补充清单。
• 可从当前上下文或文件中可靠读取的信息，先读取再判断，不重复询问。

示例输入

按 Investoday 标准优化这个 skill：/path/to/skill。
重点检查 frontmatter、description、前置依赖、输入要求、subagent 流水线和 review checklist。
允许本地修改并运行校验，不发布。

反例输入

按 Investoday 标准优化一下。

原因：缺少目标对象、任务类型和输出目标，应先追问要优化哪个 Investoday skill，以及是只读评审还是允许修改。

优化一下。

原因：没有绑定 Investoday skill 或今日投资技能规范，不应触发本技能。

核心规则

• 技能创建流程、目录结构、渐进式加载、references/、scripts/、assets/ 的使用边界，以官方 $skill-creator 为准。
• 本技能只声明 Investoday 侧的 YAML 字段、扩展元数据、依赖声明、触发描述和检查规则。
• 如果本技能与官方 $skill-creator 的通用规范冲突，通用规范以官方 $skill-creator 为准；Investoday 元数据字段以本技能为准。
• 不要在本技能里重复维护官方已有的通用技能规范。
• 同一条规则只保留一个主归属文件；其他文件只做短引用，避免多文件重复和逻辑不一致。
• 本技能自身保留 references/*-standard.md 作为创建器规范库；创建或优化普通业务/目标 skill 时，不得默认复制这些 *-standard.md 到目标 skill。
• 目标 skill 的 references/ 只生成运行时真正需要读取的业务 reference，例如业务规则、输入示例、字段映射、评分口径、API 摘要或少量领域示例；不要把本技能的 frontmatter、输入要求、意图路由、subagent、脚本安全、交付回执等创建器标准文件当模板库批量落盘。
• 如果目标 skill 确实需要独立 reference，应在目标 SKILL.md 的参考路由或工作流程中写明读取条件，并让文件内容服务目标业务执行；只为“符合规范”“方便以后看”而复制 *-standard.md 属于反模式。
• 触发条件必须写进 frontmatter description。正文和 references/ 只在技能触发后才可靠可见，不能承担初始触发职责。
• 触发词不是 Use when 的同义词。触发词是真实用户话术样例；Use when 必须同时包含触发场景、用户意图、对象范围、典型触发词和边界。完整规则见 references/frontmatter-standard.md。
• 面向 30B 或更小模型时，优先使用明确短句、真实用户话术、Use when / Do not use 和可验证步骤。
• name 必须小于 64 字符；description 必须控制在 1024 字符以内，避免 Codex、Qoder、OpenCode 等运行时跳过或截断技能。
• Investoday 技能的最小 frontmatter 必须包含 name、title、description、version、tags；如果有底层依赖 skill 或其他包，必须包含 requirements 或 requires。
• 如果技能有底层依赖，正文必须提供“前置依赖”小节，按 skill、package、cli、python、node 列出；具体格式见 references/frontmatter-standard.md。
• 每个 Investoday skill 必须提供“输入要求”小节，说明可接受输入、最小输入、推荐输入、可选输入、默认假设、输入校验、缺失输入处理、示例输入和反例输入；完整格式见 references/input-requirements-standard.md。
• 多能力 Investoday skill 必须提供“意图路由”小节，说明触发后如何按用户意图进入不同工作流；完整格式见 references/intent-routing-standard.md。
• 依赖另一个 skill 时，frontmatter 用 requirements.skills 作为运行时主声明，并同步到 metadata.clawdbot.requires.skills 便于市场或目录发现；正文优先用 $skill-name 提醒模型显式使用，兼容旧运行时可补充 /skill-name 或按精确 skill 名称读取。完整写法以 references/frontmatter-standard.md 为准。
• Agent 唤起优先使用 Spawn {codex_name} to {task} 的自然语言格式；@agent-{agent-id} 只作为别名或展示名，/skill-name 只用于真实 skill，不能用 /subagent:xxx、/agent:xxx 或 /role:xxx 伪装 subagent。
• 每个带质量流水线的 Investoday skill 必须写明 Agent 自动触发策略：在哪些 route、风险等级、改动规模或交付阶段自动 Spawn 哪些 agent；不能只列 Agent 名称。
• 创建或更新其他 skill 时，如果某个场景需要 Agent，必须在目标 skill 的“意图路由”或“Agent 流水线”中显式写出具体唤起句式，例如 Spawn skill_reviewer to review ...；只在 agents/*.toml、metadata 或 pipeline 列表中声明 agent 名称不算完成自动唤起规范。
• 创建、结构性更新、触发描述修改、脚本/外部服务变更、发布前评审，或用户手动要求“工程化评估”时，必须按 references/evaluation-standard.md 判断评估等级；小修补可只做轻量检查，不能把完整评估目录变成所有改动的硬负担。
• 长期维护、团队共享或对外分发的 skill 应在根目录维护 CHANGELOG.md；CHANGELOG 只记录用户可见变化、兼容性、验证和风险，不承载运行时规则。生命周期规则见 references/lifecycle-standard.md。
• create_skill、update_skill、review_skill、evaluate_skill、diagnose_trigger、design_inputs、design_intent_routing、design_subagents 命中后，最终回复必须使用固定交付回执格式；除用户明确指定其他格式外，不得省略“完成的需求”和“多代理流水线（本次）”。完整规则见 references/final-delivery-standard.md。
• 复杂脚本、外部服务、MCP/HTTP/CLI 接入、Few-shot 示例和反模式检查分别按 references/script-safety-standard.md、references/integration-standard.md、references/example-patterns-standard.md、references/anti-patterns-standard.md 执行。
• 优化本创建器或创建/优化目标 skill 时，必须按 references/example-patterns-standard.md 判断是否需要合理增加 Few-shot；复杂输出、分支判断、固定格式、脚本/接口边界或模型容易跑偏的场景，默认应补正例、变体例和反例/边界例。
• 创建或修改 scripts/*.py 时，必须按 Google Python 风格指南维护有用的模块文档字符串、函数/方法文档字符串和内部注释；完整规则见 references/script-safety-standard.md，评审项见 references/review-checklist.md。
• agents/*.toml 是可注册模板；但 agent-required route 的执行前提是真实 Agent 可 Spawn。Spawn 不可用或失败时，必须停止该 route 的完成路径并报告阻塞或失败。
• subagent 的职责详情拆到 agents/*.toml 模板；SKILL.md 只保留 Agent 列表、触发方式、流水线和失败处理。
• 放在 skill 包内的 agents/*.toml 是可注册模板，不等于自动创建 subagent；只有复制或安装到运行时识别的 agent 目录后才会成为真实 subagent。
• Investoday skill 的 SKILL.md 不允许提及今日投资 API Key 的具体环境变量名；环境变量规则见 references/frontmatter-standard.md。
• 优化或创建目标 skill 时，原则上不能把本机相关路径写进 skill 正文、frontmatter、metadata、requirements、examples 或 reference；应使用相对路径、占位路径、环境变量占位或平台无关描述，保持 skill 跨平台通用性。
• 用户给出的本地路径只作为本次读取、修改或验证的输入，不应原样沉淀为目标 skill 的长期规范。
• 特殊情况确实需要写运行时路径、平台路径或本机路径时，必须单独向用户说明原因、适用平台、不可移植风险和替代写法，确保用户知晓该 skill 的跨平台限制。

何时使用

• 用户要创建、调整、评审或验证 Investoday 技能。
• 用户要优化 SKILL.md 的 description、Use when、Do not use、触发词或渐进式发现。
• 用户要统一 Investoday 技能的 Frontmatter/YAML、依赖声明、输入要求、权限字段或发布前检查。
• 用户要为 Investoday skill 设计意图路由、任务分派、歧义追问或越界转交规则。
• 用户要定义 subagent 描述规范、区分 $skill-name、/skill-name 与 Spawn agent_name to ...、拆分 agents/ 目录、设计多角色质量流水线、定义 Agent 自动触发条件，或要求 Skill 创建/更新时多 subagent 协作。
• 用户要做工程化评估、触发评估、质量评估、正反例/边界用例、脚本安全检查、外部服务接入边界判断、CHANGELOG 或生命周期维护。
• 用户要为当前创建器或目标 skill 增加、评审或优化 Few-shot、Before/After、Diff、评分示例、正例、反例或边界例。
• 用户要固定最终输出、交付回执、多代理流水线表格、Agent 启用状态、未启用原因、工作内容、工作结果或注意事项展示规则。
• 用户明确提到小模型、30B、触发不稳定、skill 没被调用、description 不会命中。
• 典型话术：“这个 Investoday SKILL.md 怎么写”“按今日投资标准检查这个 Investoday 技能包”“按今日投资标准补齐 metadata 和 requirements”“Investoday skill 前置依赖怎么写”“Investoday skill 输入要求怎么写”“这个 Investoday 技能能不能过官方 quick_validate”。

规则归属与去重

• 同一条规则只保留一个主归属文件。
• SKILL.md 只保留触发、路由、边界、核心流程和输出契约。
• references/frontmatter-standard.md 是 frontmatter 字段、版本号、依赖和格式规则的主归属。
• references/input-requirements-standard.md 是输入要求、缺失输入处理、输入示例和反例输入的主归属。
• references/intent-routing-standard.md 是意图路由、任务分派、歧义处理和越界转交的主归属。
• references/review-checklist.md 是检查项主归属，不重复展开字段解释。
• references/evaluation-standard.md 是工程化评估、自动/手动评估触发、评估等级和评估报告的主归属。
• references/final-delivery-standard.md 是最终交付回执、固定输出结构、多代理流水线表格和注意事项隐藏规则的主归属。
• references/script-safety-standard.md 是脚本安全、危险操作、路径、依赖和跨平台检查的主归属。
• references/integration-standard.md 是外部服务、MCP/HTTP/CLI 接入边界的主归属。
• references/example-patterns-standard.md 是 Before/After、Diff、Few-shot 和评分示例的主归属。
• references/anti-patterns-standard.md 是常见反模式和负向审查项的主归属。
• references/lifecycle-standard.md 是版本、CHANGELOG、评估证据、发布前复核和归档维护的主归属。
• 其他文件需要引用规则时，只写短引用和读取条件，不复制完整段落。
• 如果多个文件出现同一规则的不同版本，以主归属文件为准，并同步删除或改写重复内容。
• 上述 *-standard.md 是 investoday-skill-creator 的创建器规范库，不是目标 skill 的默认交付物。目标 skill 应保留自己的业务 reference；除非目标 skill 本身也是规范创建器或审核器，并且文件被运行时明确路由读取，否则不要生成或复制同名 standard 文件。

不要使用

• 用户只是调用某个 Investoday 业务 skill 做投研、数据查询或文本分析。
• 用户只问官方通用 skill 目录结构、打包方式、脚本资产组织，且没有 Investoday 字段或元数据要求。
• 用户要求修改非 Investoday 技能，除非明确要套用 Investoday 内部分发标准。
• 用户要求 Dify 工作流设计、业务分析 skill 正文设计、数据接口调用、Skill Store / ClawHub 上架发布、默认版本设置、下架或安全扫描结论判断；这些任务应交给对应业务或发布管理 skill。
• 用户只问普通 Python/Node 项目依赖、非 Investoday skill 的通用依赖，或 Dify 工作流前置依赖。

工作流程

1. 先判断任务是否属于 Investoday 技能创建、精修、评审、规范解释、触发诊断，或输入要求、意图路由、subagent 设计；如果不是，转回官方 $skill-creator 或对应业务 skill。
2. 使用 $skill-creator，用它确定通用创建方法、目录结构和资源组织方式。
3. 先按“意图路由”确定唯一 route id，再按 metadata.clawdbot.quality_pipeline.route_agent_pipelines 和“Agent 自动触发策略”执行 Agent 调度门。除 clarify、handoff_publish 或明确标为 no_agent_* 的 route 外，命中 route 后必须先 Spawn 对应 agent 流水线；不能只读取 reference 后直接修改、评审或交付。
4. 创建、更新或评审 Skill 时，按“Agent 自动触发策略”和“Subagent 质量流水线”执行多角色流程。当前流水线和失败处理以本节为准，通用 subagent 写法和 agents/*.toml 模板规则见 references/subagent-standard.md。
5. 读取 references/frontmatter-standard.md，确定 Investoday 的 YAML 字段、触发描述、兼容边界和小模型友好要求。
6. 需要设计或评审输入要求时，读取 references/input-requirements-standard.md，补齐输入对象、最小输入、缺失输入处理和示例。
7. 需要设计或评审意图路由时，读取 references/intent-routing-standard.md，补齐用户意图、必要输入、工作流、歧义处理和转交边界。
8. 按官方 $skill-creator 编写或精修技能正文和资源；只把核心流程放在 SKILL.md，详细业务规则放入按需 references。
9. 按本技能规范补齐 description、Investoday 元数据、依赖字段、输入要求、意图路由、权限字段和 Use when / Do not use 边界。
10. 创建或更新目标 skill 的 references/ 时，先判断该文件是否会被目标 skill 运行时读取；只生成业务执行必需的 reference，不复制本技能的 *-standard.md 规范库。
11. 如果改动涉及 description、意图路由、脚本、外部服务、Agent 流水线、发布前评审，或用户手动要求工程化评估，读取 references/evaluation-standard.md，按改动风险选择轻量、标准或完整评估。
12. 如果涉及脚本、外部服务、示例、反模式或生命周期维护，分别读取对应 reference；交付前读取 references/review-checklist.md，完成触发、渐进式发现、字段、输入要求、意图路由、subagent 流水线、目标 references 去污染、工程化评估和验证检查。
13. 命中创建、修改、评审、评估、触发诊断、输入设计、意图路由设计或 subagent 设计 route 后，最终回复必须读取 references/final-delivery-standard.md 并按固定交付回执输出；clarify、handoff_publish、简单 explain_standard 和用户指定其他格式是例外。

意图路由

意图路由只在本技能已经触发后使用，用于判断用户这次要做什么；初始触发仍由 frontmatter description 决定。创建或优化其他 Investoday skill 时，也应按 references/intent-routing-standard.md 为目标 skill 设计同类路由。

Agent 自动触发策略

本技能触发后，先按“意图路由”确定唯一 route，再立即执行 Agent 调度门。用户不需要每次手动要求“起 agent”；除 clarify、handoff_publish 或 metadata.clawdbot.quality_pipeline.route_agent_pipelines 映射到 no_agent_* 的 route 外，必须先按 route 映射的 pipeline Spawn agent。

运行时或模型不得把“Agent 自动触发策略”理解为可选建议。只要 route 进入创建、更新、评审、触发诊断、输入设计、意图路由设计或 subagent 设计，就必须先完成对应 agent 步骤，再执行文件修改、最终评审或交付结论。不得因为未自动发起委派、改动很小、赶时间或自认为信息充分而绕过真实 Spawn。用户明确说“不要使用 agent / 只要当前模型处理”时，不得继续宣称完成 agent-required route，只能转为受限说明、草稿建议或追问确认。

metadata.clawdbot.quality_pipeline.route_agent_pipelines 是机器可读映射，必须覆盖“意图路由”中的全部 route id。每个 route 必须声明 pipeline；no_agent_handoff 和 no_agent_clarify 表示该 route 不触发 agent，但仍必须执行转交或追问。

自动 Spawn 时使用 Spawn {codex_name} to {task}，并在 Spawn 指令里给出 route id、目标文件、检查范围、只读/可写边界和输出要求。运行时不支持 subagent、对应 agent 不存在或 Spawn 失败时，必须把必需 Agent 标记为 失败 或 未启用，并停止该 agent-required route 的完成路径；不得用当前主会话补齐后宣称多代理流水线完成。不得把未自动发起委派作为合理原因。

当本技能用于创建或更新其他 skill 时，也必须把这个要求写进目标 skill：只要目标 skill 的某个 route 或流水线需要 Agent，目标 skill 的“Agent 自动触发”列或“Agent 流水线说明”就必须出现具体 Spawn {codex_name} to {task} 句式。只写 skill_reviewer -> skill_evaluator、只声明 route_agent_pipelines、或只放 agents/*.toml 模板，都不足以保证自动唤起。

Skill 与 Agent 唤起格式

正文要求使用其他 skill 时，优先使用 $skill-name 显式唤起；完整模板、依赖字段和缺失处理见 references/frontmatter-standard.md。

Use $skill-creator.
Use $investoday-skill-creator.

正文要求使用 Agent / subagent 时，优先使用 Codex 自然语言委派格式，并写真实 agents/*.toml 中的 name：

Spawn skill_reviewer to review the current Investoday skill changes for invocation format, frontmatter, references, agents, and validation gaps.
Wait for all agents and summarize blocking issues, non-blocking risks, and next actions.

@agent-{agent-id} 可作为人类可读别名、metadata 展示名或旧运行时适配名；不要把它写成 slash 命令。/skill-name 只作为旧运行时兼容写法，不作为 Investoday 新增规范的主写法。

Subagent 质量流水线

创建、更新、评审或验收 Investoday Skill 时，先按“Agent 自动触发策略”决定是否触发以下角色流水线。对 agent-required route，真实 Spawn 是进入完成路径的前置条件；如果当前运行时不支持 subagent、对应 agent 不存在或 Spawn 失败，不得用主会话模拟缺失 Agent 后宣称完成。

SKILL.md 只定义何时使用这些角色、流水线顺序和失败处理。每个 subagent 的可注册定义模板放在 agents/*.toml；这些模板不会在 skill 包内自动生效，只有安装或复制到运行时识别的 agent 目录后才会成为真实 subagent。

Agent 模板映射

Agent 流水线说明

• 新建 skill：由 create_skill route 自动触发 Skill 指挥官 -> Skill 工程师 -> Skill 审核师 -> Skill 验收官 -> Skill 评测官。
• 大版本更新或跨文件结构性修改：由 update_skill route 自动触发 Skill 指挥官 -> Skill 工程师 -> Skill 审核师 -> Skill 验收官 -> Skill 评测官。
• 小修补：由 update_skill route 自动触发 Skill 工程师 -> Skill 审核师。
• 只读评审：由 review_skill route 自动触发 Skill 审核师 -> Skill 评测官。
• 工程化评估：由 evaluate_skill route 自动触发 Skill 评测官；创建、结构性更新或发布前评审也可根据改动风险自动进入评估标准。
• 只问规范：默认当前模型直接解释；涉及多规则冲突或归属判断时自动使用 Skill 指挥官角色。

正文要求使用 subagent 时，必须写成 Spawn {codex_name} to {task}。不要使用 /subagent:xxx、/agent:xxx 或 /role:xxx，因为 slash 命名空间只用于真实 skill 的旧兼容入口。通用 subagent 描述规范、agents/*.toml 模板、metadata 和失败处理写法见 references/subagent-standard.md。

参考路由

• 通用技能创建、目录结构、资源组织、打包：使用 $skill-creator。
• Frontmatter/YAML、description 触发词、兼容边界、小模型友好写法：读取 references/frontmatter-standard.md。
• 输入要求、最小输入、默认假设、缺失输入处理、示例输入和反例输入：读取 references/input-requirements-standard.md。
• 意图路由、任务分派、歧义处理和越界转交：读取 references/intent-routing-standard.md。
• 当前 Agent 列表和多角色质量流水线：使用“Subagent 质量流水线”章节。
• Subagent 描述规范、agents/ 模板目录、Spawn agent_name to ...、@agent-xxx 与 $skill-name 边界：读取 references/subagent-standard.md。
• 最终交付回执、完成需求清单、多代理流水线表格、Agent 执行状态、工作内容、工作结果和注意事项隐藏规则：读取 references/final-delivery-standard.md。
• 工程化评估、触发用例、质量用例、轻量/标准/完整评估等级：读取 references/evaluation-standard.md。
• 脚本安全、危险操作确认、跨平台命令、外部输入和路径校验：读取 references/script-safety-standard.md。
• MCP、HTTP、CLI 或外部服务接入边界：读取 references/integration-standard.md。
• Before/After、Diff、Few-shot、评分示例、创建器自身优化或目标 skill 创建/优化时的示例增补判断：读取 references/example-patterns-standard.md。
• 大杂烩、黑话 description、Wiki 化正文、无验证点等反模式：读取 references/anti-patterns-standard.md。
• 版本、CHANGELOG、评估证据、发布前复核和归档：读取 references/lifecycle-standard.md。
• 发布或交付前评审：读取 references/review-checklist.md。
• 如果用户给出具体 skill 路径，先读目标 SKILL.md，再按上述路由读取必要 reference。
• 本节列出的 references/*-standard.md 是本创建器运行时读取的规范库；用于指导目标 skill，而不是默认复制到目标 skill。目标 skill 只保留自身业务运行时会读取的 reference，并在目标 SKILL.md 中写清读取条件。

官方工具

• 目标是官方严格兼容格式时，使用 $skill-creator 并使用其官方校验器。
• 目标是 Investoday 最小格式或扩展格式时，官方校验器可能拒绝 title、version、tags、requirements；这属于兼容边界，应改用 YAML 解析、字段清单和目标平台校验。
• 新建技能、打包技能、目录结构问题，使用 $skill-creator 后再使用它提供的初始化、校验或打包工具。
• 本技能提供 scripts/validate_agents.py，用于只读校验 metadata.clawdbot.quality_pipeline 与 agents/*.toml 的一致性；该脚本不安装、不复制、不注册 subagent。
• 本技能提供 scripts/validate_skill_rules.py，用于只读校验禁止的具体凭证变量名、## 前置依赖 与 frontmatter requirements 的一致性，以及 ## 输入要求、## 意图路由 和对应规范 reference 的基础结构。
• 本技能包含 agents/*.toml 作为 Codex agent 模板；这些文件只用于创建或注册 subagent，不替代 SKILL.md 的触发和流程说明。

设计标准

高质量 Investoday skill 必须满足：

• 只看 description 就能判断该不该触发。
• 触发后只看 SKILL.md 就知道下一步怎么做。
• 用户或 AI 只看“输入要求”就知道要提供哪些输入、缺少哪些输入时要如何补齐。
• 用户或 AI 只看“意图路由”就知道触发后进入哪个工作流、是否追问或转交。
• 复杂字段、规则和示例按需放进 references/，并在 SKILL.md 给出读取条件。
• 创建或优化 skill 时，必须判断是否需要 Few-shot；需要时优先在目标业务 reference 或 examples/ 中提供可模仿的正例、变体例和反例/边界例。
• 普通业务/目标 skill 不默认携带本创建器的 *-standard.md 规范库；只有运行时真正需要的业务 reference 才进入目标 references/。
• 重复、脆弱或发布前检查步骤优先脚本化；没有脚本时要给出明确验证命令或人工检查点。
• 工程化评估按改动风险分级：触发、路由、脚本、外部服务、Agent 流水线或发布前变更需要留下评估证据；小修补说明轻量检查理由即可。
• 长期维护或对外分发的 skill 在根目录维护 CHANGELOG.md；运行时规范仍留在 SKILL.md 和 references/。
• 需要 subagent 参与的 skill，应优先提供 agents/*.toml 模板；模板职责与 SKILL.md 的 Agent 列表必须一致。
• 输出契约清楚，命中交付型 route 后最终回复必须稳定使用固定交付回执，并说明完成需求、多代理流水线、验证结果和未验证风险。

小模型友好规则

• description 使用真实用户会说的话，例如“创建 Investoday skill”“优化 Investoday SKILL.md”“为 Investoday skill 补触发词”“为什么没触发”“让 30B 也能用”。
• 避免抽象宣传词，例如“智能提升能力”“强大的技能平台”；改成任务词、对象词、文件词和命令词。
• Workflow 用编号步骤；边界用明确的 Use when 和 Do not use。
• Reference Routing 必须写出“什么情况读哪个文件”。
• 不依赖模型自行推断隐藏规范；关键约束必须在 SKILL.md 或被路由的 reference 中出现。

失败处理

• YAML 不能解析：先指出具体字段、缩进或引号问题，不继续做发布或打包判断。
• 官方校验失败且原因是 title、version、tags、requirements 等字段：说明这是官方严格兼容格式与 Investoday 最小/扩展格式的兼容边界，不直接删除字段，先确认目标分发渠道。
• requirements.skills 与 metadata.clawdbot.requires.skills 不一致：以 requirements.skills 为主，并建议同步展示字段。
• reference 文件缺失：停止并报告缺失路径，不凭记忆补全规则。
• 工程化评估缺少目标对象、评估范围或可用样例：先输出评估计划和待补用例，不假装已有量化结论。
• 涉及真实密钥、token、生产发布、下架或外部发送：停止并要求确认，或转交对应发布/管理技能。

输出格式

• 命中 create_skill、update_skill、review_skill、evaluate_skill、diagnose_trigger、design_inputs、design_intent_routing、design_subagents 后，最终回复必须使用 references/final-delivery-standard.md 的固定交付回执。
• 固定交付回执必须包含“一、完成的需求”和“二、多代理流水线（本次）”；“三、注意事项”仅在存在未验证项、剩余风险、未发布/未同步、必需 Agent 未启用或失败等情况时显示。
• “多代理流水线（本次）”表格列固定为：Agent名称、执行状态、未启用/失败原因、工作内容、工作结果；工作内容 写做了什么，工作结果 写结论、产物或是否通过。
• clarify 只追问阻塞问题；handoff_publish 使用发布管理 skill 的格式；简单 explain_standard 可直接回答；用户明确指定其他输出格式时，用户格式优先。
• 评审任务在固定回执的“完成的需求”中保留 P1/P2/P3 finding 摘要；只读任务必须明确未修改文件。

交付要求

创建或精修技能时，最终说明：

• 使用固定交付回执列出完成的需求、多代理流水线和必要注意事项。
• 创建或修改了哪些文件。
• frontmatter 采用了官方严格兼容格式、Investoday 最小格式还是 Investoday 扩展格式。
• description 中放入了哪些真实触发词、Use when 判断规则和排除边界。
• Investoday 扩展字段、依赖字段和权限字段如何设置。
• “输入要求”如何说明可接受输入、最小输入、缺失输入处理、示例输入和反例输入。
• “意图路由”如何把用户意图映射到工作流、reference、subagent 或越界转交。
• 渐进式发现如何组织：哪些内容在 SKILL.md，哪些内容按需放入 references/、scripts/ 或 assets/。
• 如果定义 subagent，说明 SKILL.md 的流水线和 agents/*.toml 模板如何对应，以及这些模板是否已经被安装到真实运行时。
• 如果触发工程化评估，说明评估等级、用例来源、已覆盖的正例/反例/边界、未量化的风险和后续补证据项。
• 如果维护 CHANGELOG，说明根目录 CHANGELOG.md 记录了哪些用户可见变化；不要把 CHANGELOG 当作运行时规则来源。
• 已完成哪些验证，还有哪些风险或未验证项。