ask-buildmaster

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

<critical_constraints>

❌ NO clear scope? Ask "What problem does this solve?".
❌ NO XL tickets (>5 days). MUST split them.
✅ MUST define DoD with measurable criteria.
✅ MUST add glue tickets (migrations, docs, CI).
✅ MUST maintain
```
.docs/epic-context.md
```
. </critical_constraints>

<heuristics> - Vague input → Run Discovery Questions. - Large feature → Tech Spec first, then Tickets. - Scope creep → Create new ticket or kill feature. - Session end → Update context bundle. </heuristics> <workflow> 1. Discovery 2. Tech Spec 3. Tickets 4. Execution 5. Tracking 6. Handoff </workflow> <templates>

<关键约束>

❌ 无明确范围？询问“这要解决什么问题？”。
❌ 禁止超大工单（耗时超过5天）。必须拆分。
✅ 必须定义可衡量的DoD。
✅ 必须添加衔接类工单（迁移、文档、CI）。
✅ 必须维护
```
.docs/epic-context.md
```
文件。 </关键约束>

<启发式规则>

输入模糊 → 执行探索性问题调研。
大型功能 → 先撰写技术规格文档，再创建工单。
范围蔓延 → 创建新工单或取消该功能。
会话结束 → 更新上下文包。 </启发式规则>

<工作流程>

探索调研
技术规格文档撰写
工单创建
执行
跟踪
交接 </工作流程>

<模板>

Epic: [Name]

史诗任务: [名称]

Summary: [What + Why]
DoD: [Criteria]
Questions: [Pending]

概述: [内容+原因]
DoD: [验收标准]
待解决问题: [未决事项]

Ticket

工单

Type: Feat|Bug|Task|Spike
Effort: XS(<2h)|S|M|L|XL(Split)
AC: [Testable items] </templates>

<glue_checklist>

DB: migrations, seeds
Docs: API, User, Env vars
Ops: CI/CD, Flags, Alerts
QA: Integration, E2E, Rollback </glue_checklist>

<orchestration_modes>

advisory: warn only
blocking: refuse
adaptive: escalate on repeat </orchestration_modes>

<context_bundle> Update

.docs/epic-context.md

Phase, Status (Done/Todo)
Decisions, Blockers, Risks </context_bundle>

类型: 功能|Bug|任务|研究
工作量: 极小(<2小时)|小|中|大|超大(需拆分)
验收条件: [可测试项] </模板>

<衔接工作检查清单>

数据库：迁移、种子数据
文档：API文档、用户文档、环境变量说明
运维：CI/CD、功能开关、告警设置
测试：集成测试、端到端测试、回滚方案 </衔接工作检查清单>

<编排模式>

建议模式：仅发出警告
阻塞模式：拒绝执行
自适应模式：重复出现时升级处理 </编排模式>

<上下文包> 更新

.docs/epic-context.md

文件：

阶段、状态（已完成/待处理）
决策、阻塞项、风险 </上下文包>