NocodeMrLi/mini-program-engineering-skill-suite / skills/mini-program-implementation-skill
mini-program-implementation-skill
UnverifiedImplement bounded features and fixes in existing or new mini-program codebases while preserving repository rules, user-owned changes, approved behavior, assets, framework conventions, and evidence boundaries. Use when users ask to write or modify mini-program code, implement a confirmed specification or architecture, add a scoped feature, remove behavior semantically, update internal documentation required by a change, or carry out a well-defined small fix that does not require root-cause investigation. Establishes a baseline and change boundary, applies test-driven small steps, distinguishes source from generators and build artifacts, verifies the affected contract, and never reports source completion as device validation, formal acceptance, upload, or release.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.5 KB |
| agents/openai.yaml | config | 300 B |
| assets/implementation-handoff.md | markdown | 1.3 KB |
| references/cloud-asset-delivery-workflow.md | markdown | 2.7 KB |
| references/implementation-workflow.md | markdown | 8.2 KB |
references/implementation-workflow.md
View on GitHub# 工程实现工作流与触发场景
## 实施检查表
- 基线包含规则、Git/文件状态、相关测试、生成关系与用户已有改动。
- 每个修改文件都能直接映射到用户目标;删除行为覆盖模板、样式、状态、计算和资源引用。
- 新行为或缺陷有先失败的测试/复现;测试期望独立于被测实现,不以源码关键词代替行为证据。
- 共享状态、接口或数据契约变化覆盖正常、空、错误、边界和重复操作。
- 源码、生成脚本、构建产物和平台状态没有混写;只报告实际执行到的验证层级。
- 云资产/批量导入按 manifest、executor、verifier、report 分离;长任务有界并发、进度与失败清单,部分远端数据按唯一键补齐。
- 会改变运行行为的派生资产使用候选版本、单一激活源、原子切换和可审计回滚,不直接覆盖当前激活版。
## 代表场景
### 场景 1:正常场景——按已确认规格增加局部功能
已有事实图、页面行为和验收标准。先固定允许修改文件与测试命令,写失败测试,再用最小代码实现;不得顺手重构相邻模块或增加未确认入口。
### 场景 2:正常场景——语义删除已有行为
用户明确不要某个提示。检查渲染、样式、状态、计算、事件和资源引用,删除整个语义链,并运行相邻状态回归;不能只用 CSS 隐藏。
### 场景 3:边界场景——工作区已有用户改动
目标文件存在未提交修改。先识别哪些属于用户、哪些属于本任务;能安全叠加时做最小补丁并逐块复核,无法区分时停止请求方向,不能回退或覆盖。
### 场景 4:失败场景——测试与事实源冲突
旧测试要求的行为与当前已确认规格相反。保留冲突并确定当前权威事实源;没有证据前不改测试来“变绿”,也不按旧测试改变产品语义。
### 场景 5:不应触发——只有症状没有根因
用户只说真机偶发白屏且没有稳定复现。应先进入调试流程建立证据链,而不是直接猜测文件并修改。
### 场景 6:边界场景——远端已有部分资产
先读远端数量、唯一键和分布基线,再按 manifest 幂等补齐缺失项;完整性复验通过前不写“资产交付完成”,不得清库后全量重传。
## 创建请求的客户端占位
调用创建接口前缓存请求标识的页面,结果按协议分为“已成功、明确未创建、结果未知”。无资源编号或用户取消界面不能推断远端未创建。
- 明确未创建:只释放对应本次请求的临时占位,显示真实拒绝原因;其他未结业务仍受原规则约束,不删除远端记录或自动重试。
- 结果未知:保留原请求标识,按已核查询/幂等合同恢复;重进或重复点击不能换键重建。
- 成功与晚到结果:缓存更新绑定当前请求/尝试;旧拒绝不能清掉新请求占位,旧成功不能覆盖新状态。
原创小程序测试调用实际页面方法及缓存边界,覆盖本地前置拒绝、服务端明确未创建、无编号超时、已创建丢响应、重进、重复点击和晚到;分别断言缓存、可继续操作和服务写入次数,不能只测服务返回码或源码关键词。
## 主项目正常预览交付
实施批次按 [质量、推进与及时反馈](../../mini-program-project-intake-skill/references/intake-workflow.md) 定义用户可验收增量、正常入口和必要质量门,优先消除实际效果交付阻塞;不能只累计内部测试而长期不给开发者可见结果。隔离演练有具体风险、待补断言和接回条件,无新增风险或改动时不重复已有合格验证。
准备好且可安全接入的功能及时进入主项目普通入口,开发者用现有工具普通编译、手机预览并反馈;用户选择手动编译时尊重分工。界面可见、测试身份、真实交易/写入与正式开放分别控制,不为显示入口打开生产交易总门,也不把未验真实交易当作无交易界面的一律阻塞。
沿普通启动到业务页、入口、弹窗核已获准操作,保留对应云写入/交易门禁;启动、进页、点击的账户写入、上传、扣额及收费调用必须逐项核。无付款不等于无副作用,目录隔离不证明云环境隔离。生产构建和预览参数不能误开受限入口;直接确认也应在实际写入边界受控。
独立展示页、隔离测试、模拟器、手机及用户验收分别报告;隐藏参数/特殊启动页不证明主流程可用。单功能包/二维码只用于明确隔离需要、尚不能安全接入或现有工具无法覆盖,记录接回主项目条件并复用有效产物。
## 验证交接
新增来源/恢复或独立目录行为时,依[规格](../../mini-program-product-spec-skill/references/specification-workflow.md)及[架构](../../mini-program-architecture-skill/references/architecture-workflow.md)核真实前态、最小原子记录、旧值读取与全量关系/草稿,当前入口不改变恢复去向。分别测试有来源/未知来源、保留/获准迁移、空目录/派生筛选、移除选项/真正删除,不强加一种产品政策。
多入口同轮保存、确认副作用、前台退出与原业务未知按[运行时合同](../../mini-program-ui-device-skill/references/runtime-state-and-layout-contracts.md)执行真实调用方及持久边界;既有版本/权限/幂等/恢复保护不因体验修复放宽。普通完成后立即返回由程序处理,不能把Promise/锁/冲突变成用户等待、清缓存或重复点的步骤。
连续保存的正例也逐步核字段来源:写入前的持久值、提交载荷、整对象复制/覆盖、后续增量及调用方读回分别记录。`++`、写入次数或一次成功不能证明版本持续递增;旧对象被重新复制后,增量可能反复作用在同一旧值上。只报告实际算出或读回的状态序列,不能把成功路径当默认正确。 最小覆盖反证:旧快照 `stale={revision:4}`,每次 `current={...stale}; current.revision++`,连续两次读回都为5,而不是5、6;保留未知初值时可写“两次写入但计数重新从旧快照起算”,不要另补未经核实的数值。该示例只核表达式;业务并发判断仍逐次代入实际参数和调用顺序。
涉及刷新、展示、取消和编辑保存时执行[运行时状态合同](../../mini-program-ui-device-skill/references/runtime-state-and-layout-contracts.md),核新查询发生、完整界面复位、跨await归属、成功清理代次和显式空值隔离。共享交互列全入口;动作菜单与含输入表单分别守退出/内容保护。使用实际Page/Component调用方及可控持久/事件边界,不以孤立守卫或源码词命中替代行为。
交给验证阶段的内容只包括目标、差异、保护项、执行证据、未覆盖层级、残余风险和回滚方式。实现报告不得使用 `accepted`、`device-verified`、`uploaded` 或 `released`,除非另有对应独立证据。
## 预览、确认与最终写入调用链
仅实现[获准破坏性操作](../../mini-program-product-spec-skill/references/specification-workflow.md)时,沿实际Page/Component→领域/服务→权威存储传递同一确认身份、动作模式及相关对象/内容/关系版本,不另起删除框架。分页缓存不能定义全量范围,客户端摘要不能授予权限。确认相关依赖校验和生效写入在[同一原子边界](../../mini-program-architecture-skill/references/cloud-state-and-write-contracts.md),校验后到写入前的并发也受保护,不能只比较数量。
相关变化使旧确认失效并刷新可读清单;无关对象/全局修订变化不误阻断。不自动接受新范围、不无限重试、不增加无必要确认。先按已有政策保存输入,失败保留;事务失败无部分生效,未知响应用原键查证且继续核作用域/载荷。既有旧保存/草稿/撤销不能复活已清除对象,无关合法修改保留;没有相关机制则子项N/A。交接前置→普通入口→操作→可见/持久结果,查看/取消零业务写入;不将模拟清除写成真实云完成。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |