AIDD · 编排器(单一技能)
AIDD = AI辅助设计→开发。将设计讨论转化为平台无关的交接包——规则/配置/契约/验收条件/UI原型/骨架——供另一个AI(或人)直接开发,并通过确定性检查器在交接前确保“0个主要问题”。领域中立:同一引擎可设计游戏系统或SaaS计费功能。落地的实现(选择技术栈编写客户端/服务器)是下游工作,不在本包中。
这是一个单一技能,覆盖整个流水线。各阶段的详细剧本存放在
references/中,按需读取——保持上下文精炼,避免拆分成多个技能。
核心模型
- 两层架构:① 实时的项目脊柱 ——
project-charter(概念/平台/目标用户/领域/命名约定)+manifest(系统列表+依赖图+跨层索引+编号范围注册表+冻结记录),持续修订;② 每个系统的生产循环。 - 集中式事实源:枚举/编号/契约/配置表位于项目层;散文通过名称引用它们,位置无关(
table[key].field/screenID.elementID/R-code)——永远不要内联裸数字。 - 每次操作:读取脊柱 → 执行工作 → 写回脊柱。
- 权威方法:
references/methodology.md。常见陷阱:references/gotchas.md。特定工具的适配:references/harness-adapt.md。
进入时——自检,然后路由(主动推进)
- 脊柱是否存在?(
project-charter+manifest)—— 否 → 从概念阶段开始构建。是 → 读取两者。 - 哪些系统尚未为
Final? 列出它们;询问这次推进哪个。 - 是否存在
Recheck系统?(共享项已更改)→ 先通过完成/同步阶段解决。 - 编号范围冲突/依赖循环? 检查并报告。
阶段(读取对应的剧本,然后执行工作)
| 你想要做什么 | 读取 |
|---|---|
| 概念:核心循环/平台/用户/拆分为系统/启动脊柱 | references/phases/concept.md |
| 设计一个系统:规则(R-codes)+ 配置表(测试数据)+ UI原型 | references/methodology.md — 步骤0–5,A部分 |
| 在试运行后迭代:调整规则/配置/原型(廉价、可重复) | references/methodology.md — 重新运行A部分 |
| 完成并交接:契约+验收条件+(根据需要)后端+清单;然后同步脊柱 | references/methodology.md B部分 + references/handoff-checklist.md |
| UI截图 → UI DSL(将参考屏幕捕获到知识库) | references/phases/ui-capture.md |
典型路径:概念(一次)→ 每个系统 { 设计 → 迭代…(重复)→ 完成并交接 } → 同步(持续)。不强制排序——根据工作需求路由。重新拆分/回滚会在清单中记录回滚日志,并将已完成的依赖系统标记为
Recheck。
确定性检查器(交接前的门禁)
references/scripts/(纯Python,主要为stdlib):config_check(配置规范 ↔ xlsx差异)· value_check(损坏的外键/覆盖率/单调性)· manifest_check(脊柱自一致性)· ref_graph --check(悬空R-codes/引用)· gherkin_to_checklist · ui_render(UI-DSL → 线框图)。0个主要问题 = 可交接。 可运行示例:references/examples/subscription-plans/。
边界(它不是什么)
- 管理结构与一致性,而非质量判断:检查器捕获损坏的链接/覆盖率/单调性/模式漂移;它们不判断设计好坏(游戏平衡、用户体验、业务正确性)——这些由人或专用工具处理。
- HTML原型验证信息架构与流程,而非感觉/时序/网络。适用于UI密集的表面(库存、商店、设置、仪表盘、引导流程);实时感觉留给工程原型。
- 不替你定数字/约定:任何未决定的内容标记为
[to confirm]并交给人类。 - 做到交接包为止;技术栈选择和客户端/服务器实现 = 下游。
安装包(一个文件夹)
将单个 aidd/ 技能文件夹安装到宿主技能目录(例如 Claude Code 的 .claude/skills/)。所有内容——方法、检查器、模板、示例——都随 aidd/references/ 提供。领域包(应用/游戏模式+示例)放入 references/patterns/ + references/examples/。
硬约束(不得违反)
- 文件采用 UTF-8 无 BOM 编码。
- 按名称引用(位置无关);万分数率统一使用
/10000。 - 集中式配置:表全局集聚,没有每个系统的私有表;跨系统引用是普通引用,不是依赖边。广播类型的共享源(ID命名空间/枚举/文本)只追加,永不破坏。
- 工具调用必须使用宿主的函数调用格式,否则可能静默失败——验证产物确实落地(
read-file/ls)。特定工具的适配详见references/harness-adapt.md。 - 每次更改后,追加到项目的变更记录(
CHANGELOG.md);如果不存在,从references/templates/CHANGELOG.tpl.md初始化。