/mini-program-implementation-skill — 小程序工程实现
在已确认的改动边界内,把稳定产品语义或工程方案落到代码和必要内部文档。保护现有项目、用户已有改动与已验收行为;实现完成后只报告匹配证据,不等于正式验收。
进入条件与边界
- 接收已确认规格/架构、明确的小型实现目标,或已有项目的事实图和改动边界。
- 已有项目先读取规则、相关源码/配置/文档、版本控制状态、测试与构建方式;记录用户已有改动,不覆盖、不回退、不顺手整理无关文件。
- 产品语义、数据规则、权限或外部服务影响尚不明确时,停在决策点;单纯可观察故障但根因未知时转入调试阶段。
- 不新增未获来源支持的入口、状态、付费、广告、权限理由或业务逻辑;不把内部实现细节擅自扩写到公开说明。
受控实现流程
- 写出目标、允许修改文件/模块、必须保护内容、明确不做项、验证命令与回滚条件,建立修改前基线。
- 识别真实事实源,区分手写源码、生成脚本、配置、资源和构建产物;应修改生成脚本时不直接把生成结果当唯一修复点。
- 为新增行为或缺陷先建立能失败的测试或最小复现,执行
RED并确认失败原因正确。 - 写最小改动到
GREEN,运行目标测试;再做不改变行为的REFACTOR,每一步保持范围可审查。 - 检查空、错误、边界、重复操作、异步与受影响共享契约;发现相邻问题只记录,不静默扩大范围。
- 复核差异、用户已有改动、敏感内容和必要内部文档,运行与风险相称的静态、单元或集成检查。
- 使用 工程实现工作流 自检,并按 实现交接模板 交给验证阶段。
涉及资产时建立资产谱系,至少记录原始/衍生关系、处理工具与方式、目标槽位、尺寸、透明通道、SHA-256、批准范围和替换关系。命令中断或超时后把在途写入记为 unknown,先刷新工作区、进程、产物和日志,不盲目重放。
最低输出
- 实现目标、输入事实、假设、改动边界与保护项。
- 逐文件改动清单,以及为何属于当前目标。
RED → GREEN → REFACTOR或无法采用测试驱动时的明确理由与替代证据。- 已执行验证、结果、未验证层级、残余风险和回滚方式。
- 状态最多报告到证据支持的
implemented、built或locally-verified;不得推导真机、云端、验收、上传或发布。
停止条件
遇到无法安全区分的用户改动、互相冲突的事实源、需要扩大产品范围的选择、未批准的高风险数据/权限/外部服务变更、不可接受的迁移或回滚缺口时停止。不得以覆盖文件、重置工作区或跳过失败测试强行推进。
独立与套件协作
独立安装时,本 Skill 可完成边界明确的代码实现。位于套件中时,接收规格、架构或调试阶段的稳定交接,只输出实现差异与验证入口,不直接调用其他组件脚本。