用途:在 pegasystems/constellation-ui-gallery 仓库中新建或补全 Pega Constellation DX 组件,使其达到仓库交付标准;默认是完整实现组件,而非仅生成脚手架,并用实际检查验证结果,仅修改源码文件(除非用户明确要求生成产物)。
适用场景:在 src/components/ 下创建新的 Pega_Extensions_<Name> 组件;为组件补充 config.json 属性、Storybook 文档或测试;实现 PConnect/PCore 交互(动作、值更新、case 上下文、容器行为);校验组件是否符合 Constellation 风格、无障碍与仓库约定。
使用前需明确:组件名称与类型(Field、Template 等)、预期用户行为与数据绑定或动作、需写入 config.json 的设计器属性、可参照的相似组件,以及任务是仅文档、可运行行为还是发布级校验。
用法要点:先查看仓库参考并研究最接近的现有组件;优先使用内置指南,只有在需要确认 API 细节时才查 Pega 官方文档。组件目录为 src/components/Pega_Extensions_<Name>,通常包含 index.tsx、config.json、Docs.mdx、demo.stories.tsx、demo.test.tsx,必要时加 styles.ts、localizations.json 与辅助模块。优先使用 @pega/cosmos-react-core 与仓库已有依赖及函数式 React 模式;样式应主题感知,优先使用 token、styled-components 和 rem 单位,避免直接操作 DOM。新增非默认 Storybook 故事时需在 Docs.mdx 的 Example 章节用 Story 块列出。注册或发现文件(如 src/component-list.json)需在组件要出现在画廊时更新;生成产物(src/component-list.js、Pega_Extensions/、store/)视为构建产物,除非明确要求否则不手改。
校验命令:npm run lint、npm run test(可针对性或全量),涉及注册或打包时另做构建或画廊校验。报告需说明假设,例如运行时数据不可用、Storybook 中 PConnect 为模拟、API 依据仓库示例推断而非实际平台验证。
限制:不得虚构 DX 组件元数据;不得手改生成的 bundle 或发布产物(除非明确要求);仓库已有合适选项时不要为图方便新增依赖;若请求意味着可用组件,不得半途而废。成功标准是目录符合命名与文件约定,config.json、实现、文档、故事与测试彼此一致,PConnect/PCore 用法有仓库模式或官方指南支撑,并清楚报告校验结果与未决假设。