用途:该技能用于为项目创建或刷新持久化上下文:PRODUCT.md 记录产品事实,DESIGN.md 记录已观察或明确选择的视觉系统。两者分开维护,因为它们变更原因不同。
主要能力:解析项目根目录,读取现有 PRODUCT.md、DESIGN.md、产品文档、包元数据、路由、代表性 UI、token 与共享组件;判断所需模式(产品上下文、设计文档或两者),并各自决定创建、刷新或保持不动。只根据仓库证据进行推断,把代码视为证据而非用户批准;仅就无法推断的关键产品事实或视觉承诺提问。修改已有文件前说明是刷新、合并还是替换,绝不静默覆盖。写入最小准确文档,未决事项标注未决。
PRODUCT.md 内容:主要用户与场景、待完成任务、产品目的与成功标准、能力与限制、运行环境与术语、已确认定位、证据与品牌承诺、平台与无障碍要求。不得写入配色、字体、组件、页面概念或推测性营销主张。
DESIGN.md 内容:仅在存在可记录视觉系统时创建,例如已有界面、显式 token 或组件库、已选定并实现的视觉方向、经用户批准的设计系统。不得为未实现项目虚构。记录颜色与语义角色、字体角色、间距与响应式结构、层级边框圆角、重复组件与状态、交互与动效约定、具体 do/don't 规则。按 token 文件与 CSS 自定义属性、框架主题配置、共享组件、全局样式、渲染输出顺序扫描。使用规范章节名与顺序,机器可读 frontmatter 为准。
刷新规则:仅当持久事实变化时刷新;局部组件变更不刷新 DESIGN.md。
限制:不初始化钩子、运行时服务、隐藏状态或项目专属工作流配置;不要求任一文件先于其他技能存在;未经确认不替换事实文案或品牌承诺;不将描述性文档变为改版提案;不创建设计简报或额外配置文件。完成标准是每条写入声明有仓库证据或用户明确确认,已有文件被保留或有意更新,缺失信息如实标注。