可实施开发设计

使用要求

面向具备仓库及文件访问能力的 Codex 类智能体。说明文件不提供浏览器、测试工具、凭据、项目数据或修改外部系统的权限；其他宿主可能需要适配。

已确认的需求、决策、验收条件及相关样本
可访问仓库规则、实际代码、结构与迁移信息及现有文档
完整产品设计需 develop-closed-loop 的交付参考文档；新页面设计需未随包提供的 frontend-design-lab
关键机制判断需有可取得的实现依据或适度的获授权检查；机制探针不替代业务验收。

快速开始

下载后先检查包内说明，再将 ZIP 解压至暂存目录。
安装合集时，将六个 Skill 文件夹及同级 shared 文件夹复制到项目的 .agents/skills/ 或个人的 ~/.agents/skills/。保持相对目录结构，不要把合集外层目录当成一个 Skill 安装。
安装单独 ZIP 时，将其中的同名文件夹放入所选 Skills 目录，并保留其内部 shared 资源。覆盖前备份同名 Skill，避免重复安装。
在 Codex 中使用准确的 $write-design-doc 调用；未被发现时可重启宿主。任务需要流程交接时，另行安装相应配套 Skill。

适用场景

在实现已确认需求前准备开发设计。
审查既有设计中的复用假设、遗漏入口、契约冲突及恢复不确定性。

使用步骤

固定范围、权威来源、决定、真实样本与适用入口。按实际风险选择验证深度，明确的局部改动可使用简短设计。
从拟复用或修改的机制反查调用方和消费者，包括旁路、后台任务及其它输出，逐项说明受影响入口的归属。
通过实际实现、已有检查或获授权的最小隔离机制实验，核实优先级、兼容、幂等、原子性及恢复等关键保证。
用一套权威契约接通输入、校验、分支、状态、持久化、可见结果与失败恢复。字段名称常见且一致，保留必要反馈，只有用户明确要求才添加解释性页面文案。
连续走读正常、拒绝和恢复场景，用相关反例挑战假设；修订后重新核对受影响契约、调用方和结果。
最后判断就绪，分别说明文档完整性、契约一致性与机制可行性，依据证据报告 READY FOR IMPLEMENTATION、PARTIALLY READY 或 BLOCKED 及局限。

交付内容

项目 .talking-us/ 或现有权威位置中的开发设计及适用数据库、接口文档。
REQ/AC 映射、受影响入口归属、关键机制依据、明确未知项及待实现后执行的验收。
包内包含设计验证参考、字段与文案共享规则，以及仅供维护时使用的七组评估样例和独立判据。

局限

不实现产品、不改配置或业务数据、不执行迁移，也不自动发布。只读检查及隔离机制实验受已有授权约束，不产生业务副作用。
机制探针不等于真实业务验收。未来实现尚无运行验收本身不阻塞设计就绪；核心保证未经核实则不能整体就绪。
文档可解析、链接存在或用例数量多，不等于机制可行或跨模型可靠。评估样例用于维护，不是每次项目设计的必做项。

示例提示词，非实际执行案例

使用 $write-design-doc，结合仓库审查已批准的导出设计。反查所有调用方和消费者，用当前可取得的依据核实重试与兼容假设，走读失败恢复反例并修订权威契约。报告就绪状态及未验证边界，不实现功能、不执行迁移。

Skill 内部

SKILL.md

---
name: write-design-doc
license: MIT
description: >-
  Write or review implementable development, database, and API designs from confirmed requirements and the actual project. Verify critical mechanisms, cross-layer contracts, and failure recovery before judging handoff readiness.
  Clarify missing product decisions first. Deliver design only; do not automatically develop the product or execute migrations.
---

# Implementable Development Design

Enable developers to implement from the design and understand the basis and limits of critical technical judgments. Document completeness, specification consistency, and mechanism feasibility are separate checks. State evidence for all three when judging readiness.

Maintain this task's design and authorized project documents, without changing product code, configuration, business data, or deployment. Within existing authorization, inspect current behavior, run existing targeted checks, or conduct minimal mechanism experiments without business side effects in a temporary isolated directory. This does not authorize real-data writes, paid external calls, or complete feature development.

## 1. Fix Scope and Choose Verification Depth by Risk

包含文件 · 12

write-design-doc/LICENSE
write-design-doc/MANIFEST.json
write-design-doc/README.md
write-design-doc/SKILL.md
write-design-doc/agents/openai.yaml
write-design-doc/evals/cases.md
write-design-doc/evals/rubric.md
write-design-doc/references/design-invariants.md
…

可直接实施的开发设计