Home / nocodemrli / mini-program-engineering-skill-suite · skills/mini-program-product-spec-skill/SKILL.md · GitHub

mini-program-product-spec-skill skillA

Name: mini-program-product-spec-skill
Author: nocodemrli

mini-program-product-spec-skill is agent-read markdown (skill) from nocodemrli/mini-program-engineering-skill-suite: Convert a vague mini-program idea, feature request, or partially documented product into an evidence-calibrated product specification with target users, core problem, version-one scope, main and exception flows, page responsibilities, state matrices, and testable acceptance criteria. Use when users ask to define an MVP, clarify requirements, organize product flows, specify page behavior, resolve ambiguous product states, or prepare a stable handoff before architecture or implementation. Separate.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# /mini-program-product-spec-skill — 小程序产品规格

把模糊想法收敛为可交接、可验证的小程序产品规格。只定义“用户需要什么、在什么条件下发生什么”，不决定代码结构，也不直接实现页面。

## 输入与边界

- 可接收一句想法、需求记录、原型、现有页面说明或只读项目事实图。
- 先区分用户已确认事实、当前产品事实、有依据的假设、未知项和未来规划。
- 缺少的信息不会改变核心闭环时，采用最小且明确标注的假设继续；会实质性改变用户、价值、数据规则、付费、权限或主流程时，列为决策点。
- 不发明按钮、入口、奖励、社交、付费、广告、数据规则或异常处理来填满页面。
- 不决定代码结构、框架、数据库、API 形态或微信平台配置；这些分别交给架构和平台阶段。

## 规格流程

1. 写出目标用户、发生场景、核心问题、用户期望结果和成功条件。
2. 划定第一版最小闭环，分别记录 `本版包含`、`本版不包含` 和 `未来候选`。
3. 用“触发 → 用户动作 → 系统反馈 → 状态变化 → 完成结果”描述主流程。
4. 对无数据、加载中、失败、权限拒绝、重复操作、退出恢复和不可达条件补异常流程。
5. 建立页面清单，只写页面职责、入口、出口和依赖的已确认状态，不写视觉或代码方案。
6. 为关键页面和对象建立状态矩阵，明确状态来源、可见内容、允许动作和迁移条件。
7. 将每条验收标准写成可观察行为；优先使用 `Given / When / Then`，避免“体验良好”“正常显示”等不可测试措辞。
8. 使用 [产品规格工作流](references/specification-workflow.md) 自检，再按 [产品规格模板](assets/product-specification.md) 交付。

## 最低输出

- 目标用户、核心问题、价值主张与成功条件。
- 已确认事实、假设、未知项和待用户决策项。
- 第一版范围、明确不做项与未来候选。
- 主流程、异常流程、页面职责与状态矩阵。
- 可测试验收标准，以及产品层仍未覆盖的风险。
- 交给架构阶段的稳定语义和不可擅自改变项。

## 停止条件

当核心用户、核心价值或关键数据规则存在互斥解释，且任一选择都会实质性改变主流程时，停止在决策点，不用假设替用户拍板。若用户要求直接编码但产品语义尚不稳定，先交付最小规格和阻塞项。

## 独立与套件协作

独立安装时，本 Skill 可单独产出产品规格。位于完整套件中时，遵守套件共享的事实优先、确认门禁、证据状态和脱敏规则；只把规格产物交给后续阶段，不调用其他组件脚本。

Read the whole file at its exact version.

How to install

Latest version

mdr add nocodemrli/mini-program-engineering-skill-suite/mini-program-product-spec-skill@git:20260813.cfc2393

Exact content

mdr add nocodemrli/mini-program-engineering-skill-suite/mini-program-product-spec-skill@sha256:9d7d764ffea30e26

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

[![mdr](https://markdownregistry.com/badge/art_a3im5imtomo5d4df.svg)](https://markdownregistry.com/a/art_a3im5imtomo5d4df)

0 badge views in 30 days

Versions

version	committed	commit	size	audit
git:20260813.cfc2393 latest	2026-08-13	cfc2393	3,524 B	A	view

Audit of the latest version

A 17 of 17 checks passed. Deterministic, no model, same answer every run.

pass: Frontmatter block present
pass: Frontmatter declares a name
pass: Frontmatter declares a description
pass: Size between 200 bytes and 200 KB (3524 bytes)
pass: No zero-width or bidi control characters
pass: No instruction hidden inside an HTML comment
pass: No link to an exfiltration or paste host
pass: No credential-shaped string
pass: No instruction to send local credentials anywhere
pass: No text hidden with inline styles
pass: No prompt-injection phrasing
pass: No curl or wget piped into a shell
pass: No recursive delete of root, home or parent
pass: No instruction to read or print local credentials
pass: No base64 blob over 200 characters
pass: No link to a raw IP address
pass: No script tag

Source

GitHub

nocodemrli/mini-program-engineering-skill-suite · 77 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_a3im5imtomo5d4df
GET https://markdownregistry.com/api/v1/resolve?ref=nocodemrli/mini-program-engineering-skill-suite/mini-program-product-spec-skill
GET https://markdownregistry.com/api/v1/blob/9d7d764ffea30e26ffbd131e5a66ba23e2ef1fe5597546c8d993f95fe7f05a8d

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from nocodemrli/mini-program-engineering-skill-suite

mini-program-engineering-suite skill

nocodemrli/mini-program-engineering-skill-suite · SKILL.md · Orchestrate evidence-first engineering for WeChat and other mini programs from a vague idea or existing repository…

v3.1.13 · audit A · 77 stars

evidence-first-engineering skill

nocodemrli/mini-program-engineering-skill-suite · foundation/SKILL.md · Apply evidence-first engineering discipline to any agent-built software project: fact discovery before action…

git:20260830.6436a4c · audit A · 77 stars

mini-program-architecture-skill skill

nocodemrli/mini-program-engineering-skill-suite · skills/mini-program-architecture-skill/SKILL.md · Translate a confirmed mini-program product specification or bounded feature into an implementable architecture covering…