本文へ移動
cccskills
無料GitHub で公開

mini-program-architecture-skill

Translate a confirmed mini-program product specification or bounded feature into an implementable architecture covering modules, pages, components, services, canonical state sources, data models, interfaces, permissions, failures, caching, concurrency, idempotency, migration, rollback, external dependencies, and architecture decision records. Use when users ask how to structure a mini program, design data or APIs, divide frontend and cloud responsibilities, evolve an existing system safely, or prepare implementation after product semantics are stable. Preserves product meaning, current repository constraints, user-owned changes, and verifiable acceptance behavior rather than redesigning the product for technical convenience.

インストール方法を見る

含まれるファイル(5)

  • SKILL.md4.0 KB
  • agents/openai.yaml295 B
  • assets/architecture-decision-record.md1.9 KB
  • references/architecture-workflow.md2.4 KB
  • references/cloud-state-and-write-contracts.md7.2 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

/mini-program-architecture-skill — 小程序工程架构

把已经确认的产品语义映射为可实现、可验证、可迁移和可回滚的工程方案。架构服务于产品约束,不改变产品语义来迁就技术方案。

进入条件与边界

  • 需要一份稳定的产品规格、明确功能边界,或现有项目的只读事实图。
  • 已有项目先读取规则、当前源码与配置、Git 状态和必须保护的用户改动;优先延续已经有效的工程模式。
  • 若目标用户、主流程或关键数据规则仍有实质冲突,退回产品决策点,不用架构选择掩盖歧义。
  • 不直接实现代码,不决定未确认的按钮、奖励、付费、权限理由或业务状态。

架构流程

  1. 列出输入事实、产品不变量、质量目标、约束、未知项和不在本轮范围内的内容。
  2. 将页面职责映射为页面、组件、领域服务、平台适配层和外部依赖,明确每层所有权。
  3. 为关键事实指定唯一规范状态源,说明派生状态、生命周期、刷新时机与跨页同步。
  4. 定义数据模型、标识、版本、校验、读写边界和敏感字段;说明本地、云端或第三方的权威关系。涉及云端状态或持久化时按 云端状态、配置与写入安全合同 约束三态恢复、配置组、适配器和存储不变量。
  5. 定义 API 或云函数契约、认证与权限、错误分类、超时、重试、降级和可观察证据;外部服务明确“返回”和“业务结果有效”是不同门禁。
  6. 针对重复请求、离线恢复、多端写入和异步回调,明确缓存、并发、幂等与一致性策略;一次性写入和创建型幂等必须给出存储层约束及稳定重试结果。
  7. 若涉及存量数据或接口,写出兼容、迁移、灰度、回滚条件和失败后的恢复路径。
  8. 比较至少一个可行替代方案,记录选择理由、代价和需要重新评估的触发条件。
  9. 使用 架构工作流 自检,并按 架构决策记录模板 输出 ADR 与实施交接。

最低输出

  • 架构范围、事实、产品不变量、质量目标与未知项。
  • 页面/组件/服务/平台层边界及依赖方向。
  • 状态源、数据模型、接口、权限与失败策略。
  • 条件触发时的权威三态、配置完整性、适配器契约、作用域隔离、秘密摘要、有效结果提交和真实依赖健康合同。
  • 缓存、并发、幂等、一致性、迁移和回滚方案。
  • 外部依赖风险、可观察性和对应产品验收行为。
  • ADR:选择、替代方案、代价、验证方式与重新评估条件。

停止条件

关键产品语义未确认、当前项目存在无法保护的未知改动、核心外部能力不可核验,或数据迁移没有可接受回滚路径时,停止并报告具体缺口。不要用“实现时再说”隐藏高影响决策。

独立与套件协作

独立安装时,本 Skill 可基于给定规格完成架构设计。位于完整套件中时,遵守共享工程门禁和证据状态;只接收阶段产物、输出 ADR 和实施边界,不调用其他组件脚本。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Apply evidence-first engineering discipline to any agent-built software project: fact discovery before action, evidence-calibrated status reporting, explicit change boundaries and stage gates, controlled confirmation for risky or external actions, sensitive-information redaction for anything shared publicly, and resumable continuity after interruptions. Use when users ask an agent to take over an existing codebase, deliver a feature across stages, verify whether work is actually complete, judge release readiness, or keep conclusions honest about what is proven versus assumed. This foundation skill is domain-neutral; vertical suites (for example mini-program engineering) build on it by adding domain facts and platform rules.

日本語の概要は準備中です。原文の説明を表示しています。

NocodeMrLi/mini-program-engineering-skill-suite872026年10月9日 更新

Diagnose and fix mini-program failures through reproducible, evidence-driven root-cause analysis across source, state, asynchronous timing, caches, mock data, build versions, platform behavior, devices, cloud calls, and external services. Use when users report white screens, crashes, stale or jumping values, missing data, intermittent behavior, permission failures, performance stalls, device-only defects, API or cloud-function errors, source-versus-build mismatches, or regressions whose cause is not yet established. Freezes the observation environment, ranks competing hypotheses, runs discriminating checks, creates a failing regression test before repair, covers analogous states, and never hides a known failure with longer waits, swallowed errors, forced success, or cosmetic patches.

日本語の概要は準備中です。原文の説明を表示しています。

NocodeMrLi/mini-program-engineering-skill-suite872026年10月9日 更新

Orchestrate evidence-first engineering for WeChat and other mini programs from a vague idea or existing repository through project discovery, product specification, architecture, implementation, debugging, device adaptation, verification, and release readiness. Use when users ask to build a mini program from zero to one, take over an existing mini-program project, deliver a cross-stage feature, diagnose project status, coordinate development and testing, or judge whether a mini program is ready to upload or release. Enforces fact discovery, change boundaries, stage gates, evidence-calibrated status, sensitive-information redaction, and continuity after side questions.

日本語の概要は準備中です。原文の説明を表示しています。

NocodeMrLi/mini-program-engineering-skill-suite872026年10月9日 更新

Implement 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.

日本語の概要は準備中です。原文の説明を表示しています。

NocodeMrLi/mini-program-engineering-skill-suite872026年10月9日 更新

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. Separates facts, user decisions, assumptions, unknowns, and future ideas; never invents product logic merely to complete a screen or technical plan.

日本語の概要は準備中です。原文の説明を表示しています。

NocodeMrLi/mini-program-engineering-skill-suite872026年10月9日 更新

Perform a read-only, evidence-first intake of an existing mini-program repository before planning or modifying code. Use when users ask to take over, understand, audit, resume, scope, or continue a WeChat or other mini-program project; when project facts may conflict with historical documents; or when an agent needs the framework, rules, Git state, build path, risks, unknowns, protected behavior, and change boundary. Produces a project fact map and handoff without changing code, installing dependencies, building artifacts, or claiming runtime, device, cloud, upload, acceptance, or release status.

日本語の概要は準備中です。原文の説明を表示しています。

NocodeMrLi/mini-program-engineering-skill-suite872026年10月9日 更新

NocodeMrLi のスキルをすべて見る

このスキルの問題を報告する