techspeclisted
Install: claude install-skill chilohwei/decidekit
# TechSpec
把最终 PRD + Demo + 约束转成面向研发的产品逻辑与交互阐述文档。不要重写 PRD;必须补齐行为规则、边界条件、验收标准、异常状态、权限、数据/API 影响、发布回滚和实现注意事项。
## 输入要求
- 最终 PRD 或需求摘要。
- Demo blueprint 或当前实现边界。
- 目标技术栈、平台约束、已知风险。
- GitHub release / 发布 / 回滚要求。
- 已知 fake/real 边界和开放工程问题。
## 输出结构
- 背景与目标
- 非目标
- 产品逻辑:业务规则、状态流转、权限和数据可见性
- 交互说明:页面、组件、输入校验、错误处理、空态/加载态/成功态/失败态
- 边界条件:异常、极限输入、并发、权限不足、数据缺失、回滚触发
- 数据/API 影响:字段、接口、幂等、错误码、埋点、日志、可观测性
- 验收标准:主路径、负向路径、回归点、发布后验证
- 发布与回滚
- 实现注意事项和任务拆分
- 风险和待确认
## Gate
- Ready: 研发能按文档理解产品逻辑、交互行为、边界条件、验收标准和实现约束。
- Blocked: 缺最终 PRD、核心交互路径、边界条件、验收标准、权限/数据规则或发布回滚要求。
## 产物形态
- Command layer: `delivery-spec.md`,工程交付规格,包含 traceability、测试、发布和回滚。
- Standalone legacy: `techspec/techspec.md`,面向研发的产品逻辑、交互行为、边界条件、验收标准和实现约束文档。
- Optional `techspec/techspec-check.json`: 需要 gate 校验或机器跟踪时输出。
- 不产生 Demo URL、代码或外部写入。
完成后建议:handoff / implementation。
## Soul And Lens
- Product Mode: translate product intent into engineering rules while preserving the human reason, interaction meaning, boundary cases, and acceptance truth.
- Lens Mode: when explicitly invoked for non-product work, use `lens/techspec-lens.md` as execution logic, boundaries, acceptance, and implementation notes.
- Style: follow [../../references/soul.md](../../references/soul.md), [../../references/thinking-frameworks.md](../../references/thinking-frameworks.md), [../../references/lens-mode.md](../../references/lens-mode.md), and [../../references/output-style.md](../../references/output-style.md).
## Shared bundle relationship
This skill