Investoday 技能创建规范

概览

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

前置依赖

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

输入要求

可接受输入

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

最小输入

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

可选输入

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

默认假设

未指定语言时，使用中文。
未指定输出格式时，使用 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 工作流前置依赖。

工作流程

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

意图路由

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

| route id | 用户意图 | 用户信号 | 必要输入 | Agent 自动触发 | 进入工作流 | 输出 | |---|---|---|---|---|---|---| | create_skill | 新建 Investoday skill | 创建、新建、从需求生成、搭建 skill | 主题、目标用户、能力边界或已有需求 | 必须依次 Spawn skill_commander to plan the route and scope、Spawn skill_engineer to create the skill files、Spawn skill_reviewer to review the skill、Spawn skill_acceptance to verify requirement coverage、Spawn skill_evaluator to test trigger quality | 使用 $skill-creator 后补齐 Investoday 规范 | skill 文件或草稿 | | update_skill | 修改已有 Investoday skill | 优化、补齐、调整、工程化修改已有 SKILL.md | 目标 skill 路径或内容、任务类型、修改授权 | 必须按改动规模执行：小修补 Spawn skill_engineer to implement the scoped update 后 Spawn skill_reviewer to review the update；结构性变更升级为完整 major_update Spawn 序列 | 读取目标 skill，按本规范修改并校验 | 补丁说明和验证结果 | | review_skill | 只读评审或发布前检查 | 检查、评审、核验、能不能过规范 | 目标 skill 路径或内容、检查范围 | 必须 Spawn skill_reviewer to review the skill read-only 后 Spawn skill_evaluator to evaluate trigger and workflow quality；不得触发 skill_engineer | 读取 references/review-checklist.md，不改文件 | P1/P2/P3 问题清单 | | evaluate_skill | 工程化评估 | 工程化评估、触发评估、质量评估、正反例、边界用例、评估报告、对比有无 skill | 目标 skill 路径或内容、评估范围、是否允许生成评估用例 | 必须 Spawn skill_evaluator to run engineering evaluation planning and evidence checks；只读，不直接改文件 | 读取 references/evaluation-standard.md，按风险等级评估触发、执行质量和证据缺口 | 评估用例、评分维度、结论和改进建议 | | explain_standard | 解释规范 | frontmatter、requirements、前置依赖、输入要求、意图路由、subagent 怎么写 | 规范主题或字段名 | 简单解释不 Spawn；涉及冲突或归属判断时 Spawn skill_commander to decide rule ownership and workflow | 读取对应 reference，只解释不修改 | 规范说明或模板片段 | | diagnose_trigger | 触发排查和小模型评测 | 没触发、30B 是否友好、description 是否够 | 目标 description、SKILL.md 或 skill 路径 | 必须 Spawn skill_evaluator to diagnose trigger quality and small-model risks；需要修改时重新进入 update_skill | 读取 references/frontmatter-standard.md 和目标 SKILL.md | 触发诊断和改进建议 | | design_inputs | 设计输入要求 | 必填输入、缺失输入、示例输入、反例输入 | 目标 skill 或业务场景 | 落文件或输出可写章节时必须 Spawn skill_commander to scope the input contract、Spawn skill_engineer to draft the section、Spawn skill_reviewer to review gaps | 读取 references/input-requirements-standard.md | 输入要求章节或评审意见 | | design_intent_routing | 设计目标 skill 的意图路由 | 意图路由、任务分派、工作流选择、歧义处理 | 目标 skill、能力列表或业务场景 | 落文件或输出可写章节时必须 Spawn skill_commander to define routes、Spawn skill_engineer to draft routing、Spawn skill_reviewer to verify route-agent coverage | 读取 references/intent-routing-standard.md | 意图路由章节或评审意见 | | design_subagents | 设计 subagent 和流水线 | Agent 列表、质量流水线、@agent-xxx、agents/ 目录 | 目标 skill、任务类型、角色需求 | 落文件或输出可写章节时必须 Spawn skill_commander to define agent roles、Spawn skill_engineer to draft agents and pipeline、Spawn skill_reviewer to verify invocation declarations | 读取 references/subagent-standard.md | Agent 模板建议或校验意见 | | handoff_publish | 发布、上架、下架或设默认版本 | 上传、发布到 Skill Store、设默认版本、下架 | 发布目标或包路径 | 执行 no_agent_handoff，不 Spawn；必须转交发布管理 skill | 转交 $investoday-data-market-admin 或相应发布 skill | 路由建议，不执行发布 | | clarify | 关键信息不足 | 缺目标对象、任务类型、修改权限、目标环境 | 缺失项本身 | 执行 no_agent_clarify，不 Spawn；用户补齐后重新路由 | 追问 1-3 个阻塞问题 | 待补充清单 |

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，但仍必须执行转交或追问。

| route id | 自动触发条件 | 自动 Agent 流水线 | 不触发或降级条件 | |---|---|---|---| | create_skill | 用户允许创建文件，或要求从需求生成完整 Investoday skill | skill_commander -> skill_engineer -> skill_reviewer -> skill_acceptance -> skill_evaluator | 不允许因只要草稿建议而跳过必需 Agent；用户禁用 agent 或 Spawn 不可用时不得宣称完成 | | update_skill | 会修改 SKILL.md、frontmatter、requirements、意图路由、输入要求、Agent 流水线、agents/*.toml、脚本或版本号 | 小修补用 skill_engineer -> skill_reviewer；结构性或跨文件变更用完整 major_update 流水线 | 不允许因小修补而跳过必需 Agent；用户禁用 agent 或 Spawn 不可用时不得宣称完成 | | review_skill | 用户说检查、评审、发布前检查、能不能过规范，或任务要求只读质量判断 | skill_reviewer -> skill_evaluator | 如果目标文件缺失或输入不足，先走 clarify | | evaluate_skill | 用户手动要求工程化评估，或创建/结构性更新、触发描述修改、脚本/外部服务变更后需要独立评估证据 | skill_evaluator | 仅小修补且不影响触发、流程、脚本、依赖或交付时，可记录轻量评估理由 | | diagnose_trigger | 用户说没触发、30B、小模型、description、Use when、误触发或触发词 | skill_evaluator；若需要修改，再进入 update_skill 对应流水线 | 只问概念解释时走 explain_standard | | design_inputs / design_intent_routing / design_subagents | 用户要求把规范落到目标 skill，或输出可直接写入的章节 | skill_commander -> skill_engineer -> skill_reviewer | 只解释规范、不落文件时走 explain_standard；落文件或交付可写章节时不得跳过必需 Agent | | explain_standard | 默认不 Spawn，当前模型直接解释；涉及多个规范冲突或归属判断时使用 skill_commander | 可选 skill_commander | 用户只问简单字段含义时不触发 | | handoff_publish | 不由本技能 Spawn 发布 agent，必须转交发布管理 skill | 无 | 高风险生产操作不在本技能内执行 | | clarify | 不 Spawn，先追问阻塞输入 | 无 | 用户补齐输入后重新路由 |

自动 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 模板映射

| 角色 | 推荐显示名 | Codex Spawn name | 模板 | |---|---|---|---| | Skill 指挥官 | @agent-skill-commander | skill_commander | agents/skill_commander.toml | | Skill 工程师 | @agent-skill-engineer | skill_engineer | agents/skill_engineer.toml | | Skill 审核师 | @agent-skill-reviewer | skill_reviewer | agents/skill_reviewer.toml | | Skill 验收官 | @agent-skill-acceptance | skill_acceptance | agents/skill_acceptance.toml | | Skill 评测官 | @agent-skill-evaluator | skill_evaluator | agents/skill_evaluator.toml |

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 当作运行时规则来源。
已完成哪些验证，还有哪些风险或未验证项。