page-contract-and-spec

星标12

分支2

更新时间2026年7月22日 07:02

Create or update structured page contracts and readable page specifications from confirmed decisions, state machines, and a runnable prototype. Use when formal pages need stable Page, Action, and State IDs; when prototype behavior must become testable acceptance facts; or when page documentation must be synchronized without inventing APIs or restoring removed fields.

安装

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

来源

yuxuanliu1238-droid

yuxuanliu1238-droid/engineering-prototype-kit

打开 GitHub 仓库查看创作者相关仓库

下载

页面契约与说明

必读顺序

AGENTS.md 和 project.config.json。
当前有效正向、负向决策。
状态机。
目标页面现有契约。
当前原型。
当前页面说明。
关联 CR。

字段说明和模板见 references/contract-spec-format.md。

页面契约

每个正式页面包含：

稳定 Page ID、端、角色、目标和实现状态；
预览入口；
页面区块和数据字段；
动作、状态、规则、外部集成、异常；
Given/When/Then 验收事实。

动作必须包含前置条件、校验、成功、失败、下一页面、数据影响和实现状态。状态必须包含进入条件、可见变化、允许动作和恢复方式。

页面说明

区分：

当前原型已实现；
部分实现；
计划中；
待确认。

移动端按用户旅程组织；后台按页面结构、字段、状态、功能、权限、异常和接口建议组织。

防错

mock、隐藏字段、旧截图不构成需求。
负向决策命中的字段不得写回正文或待确认问题。
未确认接口只写占位，不得写真实 URL 或错误码。
原型和契约不一致时报告同步未完成。
ID 进入正式契约后不随意修改。

验证

修改后运行 pnpm contracts:validate。如果原型行为变化，同时运行与风险等级匹配的页面和链接检查。

关联 CR 时，分别登记 contract、prototype、page-guide 产物，并用 supports 关联验收 ID。

完成标准

页面、动作和状态 ID 唯一。
契约与原型一致。
验收事实可观察。
页面说明没有覆盖高优先级事实。
未实现能力没有伪装为已实现。

同仓库更多 Skills

同仓库

business-discovery

yuxuanliu1238-droid/engineering-prototype-kit

Organize contracts, proposals, meeting notes, screenshots, interface notes, and verbal requirements into confirmed facts, goals, roles, core objects, flows, assumptions, open questions, dependencies, and risks. Use before planning a demo, preparing a business interview, or when source materials conflict and must not be silently turned into requirements.

2026-07-2212

change-and-delivery-governance

yuxuanliu1238-droid/engineering-prototype-kit

Register and process change requests through explicit authorization, readiness, human-intervention, evidence, and delivery gates. Use when a user says record, plan, start, implement, review, synchronize, unblock, or deliver a CR; asks whether AI may execute; or needs typed artifacts and validation without silently closing or freezing work.

2026-07-2212

decision-and-domain

yuxuanliu1238-droid/engineering-prototype-kit

Classify review feedback into positive decisions, negative decisions, visual preferences, unresolved business questions, and technical questions, then model core domain objects and testable state machines after confirmation. Use when feedback changes product outcomes, multiple pages disagree on state meaning, or a rule must be protected from accidental restoration.

2026-07-2212

prototype-sop-orchestrator

yuxuanliu1238-droid/engineering-prototype-kit

Inspect and guide an AI-assisted engineering prototype project through gated stages while classifying execution state, AI policy, readiness, human intervention, and completion artifacts. Use when a product manager asks where to start, what can run now, why work is blocked, what to do next, to continue an existing project, or to coordinate prototype delivery without crossing approval gates.

2026-07-2212

requirement-quality-review

yuxuanliu1238-droid/engineering-prototype-kit

Run a read-only audit across task control, decisions, state machines, page contracts, runnable prototypes, page specifications, readiness evidence, and typed artifacts. Use when checking structural completeness, authorization, human-intervention packets, consistency, removed-item residue, review readiness, or P0/P1/P2 evidence before fixes.

2026-07-2212

name	page-contract-and-spec
description	Create or update structured page contracts and readable page specifications from confirmed decisions, state machines, and a runnable prototype. Use when formal pages need stable Page, Action, and State IDs; when prototype behavior must become testable acceptance facts; or when page documentation must be synchronized without inventing APIs or restoring removed fields.

页面契约与说明

必读顺序

AGENTS.md 和 project.config.json。
当前有效正向、负向决策。
状态机。
目标页面现有契约。
当前原型。
当前页面说明。
关联 CR。

字段说明和模板见 references/contract-spec-format.md。

页面契约

每个正式页面包含：

稳定 Page ID、端、角色、目标和实现状态；
预览入口；
页面区块和数据字段；
动作、状态、规则、外部集成、异常；
Given/When/Then 验收事实。

动作必须包含前置条件、校验、成功、失败、下一页面、数据影响和实现状态。状态必须包含进入条件、可见变化、允许动作和恢复方式。

页面说明

区分：

当前原型已实现；
部分实现；
计划中；
待确认。

移动端按用户旅程组织；后台按页面结构、字段、状态、功能、权限、异常和接口建议组织。

防错

mock、隐藏字段、旧截图不构成需求。
负向决策命中的字段不得写回正文或待确认问题。
未确认接口只写占位，不得写真实 URL 或错误码。
原型和契约不一致时报告同步未完成。
ID 进入正式契约后不随意修改。

验证

修改后运行 pnpm contracts:validate。如果原型行为变化，同时运行与风险等级匹配的页面和链接检查。

关联 CR 时，分别登记 contract、prototype、page-guide 产物，并用 supports 关联验收 ID。

完成标准

页面、动作和状态 ID 唯一。
契约与原型一致。
验收事实可观察。
页面说明没有覆盖高优先级事实。
未实现能力没有伪装为已实现。