用途:当某个新需求无法归入现有能力时,用本技能在所属 tier 包下新建一个能力(capability),把相关需求与验证器归组。创建能力后,再分别用 simready-foundation-add-requirement 添加需求、用 simready-foundation-add-validator 添加可执行校验。
主要能力:创建能力文件夹与概览文档 capability-<slug>.md(含目的、范围、需求表、相关能力、验证说明);创建 requirements.md(含 {requirements-table} 与需求文档 toctree);按需建立 requirements/ 目录;在计划验证器时添加 validation.py 占位结构,否则在概览中记录延迟验证;更新父组 toctree、组落地页与共享全局能力中心;在需要注册新验证模块时更新所属 tier 的 capabilities/init.py,并在 simready-foundation-core 退役前保持共享旧聚合导入中心同步。
使用方式:编辑前先阅读 AGENTS.md、nv_core/sr_specs/docs/guides/guides.md、naming_conventions.md、features_expansion_workflow.md、相邻能力文件夹、capabilities.md 及所属 tier 的 capabilities/init.py。需收集或推断 capability_group、owning_tier、capability_slug、display_name、scope、requirement_prefix、initial_requirements、validator_scope。命名遵循:组与文件夹用 snake_case,概览为 capability-<folder_name>.md,需求文档用 kebab-case。作者阶段无需网络、API key 或外部服务。
适用场景:为工厂连接点等新需求族建立能力并注册需求索引与验证计划。
限制:不要用本技能创建新功能或 profile 版本,应交给相应技能;范围不明确时不要臆造需求 ID,应记录命名问题;目标校验与注册路径不清晰时不要添加可执行验证器;不要为单一功能建薄包装能力;能力文档应围绕需求族而非 profile 工作流;验证状态须明确,未完成的验证器必须标注。资源 assets/openai.yaml 仅保留可选 UI 元数据,非必需。