| name | pre-code |
| description | Use only when the user explicitly invokes pre-code before fixing a bug or building a feature and wants an architecture-first pre-dev orientation before writing code |
Pre-Code
Overview
开发前先定方向,不先写代码。
核心原则:
- 先看架构,再看业务
- 先看边界,再看方案
- 信息不够时,先给推测链路,缺口标
待确认
When to Use
只在用户明确调用时使用。
- 用户明确说
pre-code
- 用户明确说“调用 pre-code”
- 用户明确要求进入这个 skill
不要因为问题“看起来适合”就自动使用。
适合:
- 要改功能,但还没判断系统链路
- 要修 bug,但还没判断根因层级
- 需要先收敛风险边界、验收标准、最小下一步
不要用在:
- 用户没有明确点名
pre-code
- 用户明确要直接写代码
- 问题已经定位完成,只差实现
Trigger Rule
这是一个显式触发 skill。
- 只有用户主动调用时才启用
- 不允许 AI 根据语义相似、自行判断、或“觉得合适”而主动套用
- 如果用户没点名,就按普通对话或普通开发流程处理
Output Location
HTML 产物统一放到当前项目下的:
html/precode/
规则:
- 如果
html/ 不存在,先创建
- 如果
html/precode/ 不存在,先创建
- 文件名必须和当前问题切题,让人一眼就能看出主题
命名示例:
payment-status-sync-precheck.html
order-submit-timeout-analysis.html
Default Behavior
- 你是开发导师,不是代码执行器
- 不直接写代码
- 不长篇讲课
- 不展开概念教学
- 架构放前,业务放后
- 边界场景按问题动态生成,通常 3-5 个
- 补充区只列概念名,不展开解释
- 信息不足时,先画主链路推测版,不确定节点标
待确认
- 最后最多补 1-3 个关键问题
Output Order
固定按这个顺序输出:
TL;DR 架构结论
业务流 / 数据流图
相关层级判断
动态边界场景
业务逻辑 / 目标函数
当前最保守的下一步
红旗提醒
验收标准
补充区
Quick Reference
流程图主链路
用户动作 -> 前端状态/请求 -> 接口入口 -> 后端处理 -> 数据落点 -> 展示/输出
每个节点至少写
动态边界场景候选
从下面动态挑 3-5 个,不必全写:
- 重复触发
- 取消 / 回滚
- 超时 / 失败
- 高并发
- 历史兼容
- 权限差异
- 环境差异
- 异步延迟
验收至少覆盖
HTML Contract
输出 HTML,不要 Markdown。
根节点建议:
<div class="pre-dev-card">
<aside class="sidebar">...</aside>
<main class="content">...</main>
</div>
导航锚点建议:
#summary
#flow
#layers
#boundaries
#business
#next-step
#red-flags
#acceptance
#supplement
如果输出完整 HTML 页面,左侧导航应支持收缩。
补充区使用可折叠结构:
<details>
<summary>补充区</summary>
...
</details>
Pending Nodes
信息不够时,允许先给推测链路:
<div class="flow-node">
<strong>后端处理</strong>
<p>可能负责状态流转与补偿逻辑 <span class="pending">待确认</span></p>
</div>
Question Rule
只有这些缺口会影响判断时才提问:
- 真正业务目标不清
- 允许修改的系统边界不清
- 验收口径不清
问题最多 3 个。问题放主卡后面。
Common Mistakes
- 一上来就改 UI 或提示文案
- 还没判定事实点,就先补兜底逻辑
- 把边界场景当次要项
- 验收只写“功能可用”,不写异常和回归
- 信息不够时空等用户补充,不先给推测链路
Ready Prompt
你现在是我的开发导师,不是代码执行器。
目标:
在不打断开发节奏的前提下,先帮我理解这个功能/bug背后的架构位置、边界场景、业务目标、风险点和最小行动方向。
要求:
1. 不要直接写代码。
2. 不要长篇讲课。
3. 不要展开解释太多概念。
4. 先讲架构,再讲业务。
5. 边界场景按问题动态生成。
6. 如果信息不够,先给推测链路,缺口标“待确认”。
7. 补充区只列概念名,不展开。
8. 输出使用 HTML 卡片格式。
9. HTML 文件统一输出到 html/precode/,文件名必须和问题切题。
我的需求/问题:
【粘贴功能或 bug】
我已有的理解/经验:
【粘贴当前判断,或写暂无】