Communitygithub.com

ProdaZhang/aidd

用一个AI进行功能设计头脑风暴,然后将经过验证的平台无关包交给另一个AI去构建。游戏或应用——一个技能,确定性检查器。

aidd 是什么?

AIDD(AI辅助设计→开发)是一个平台无关的AI代理技能,它将设计讨论转化为可交付的handoff包,使得另一个AI或人类开发者可以直接从该包开始实现。该技能的核心是两层架构:一个实时更新的项目脊柱(包括项目章程和清单)以及每个系统的生产循环。它包含确定性检查器(如配置检查、值验证、清单一致性检查等),确保在交接前达到“0个主要问题”。AIDD支持游戏、SaaS计费等多种领域,但不涉及技术栈选择和客户端/服务器实现——这些是下游任务。整个技能以单个文件夹形式安装(如Claude Code的`.claude/skills/`目录),所有方法、检查器、模板和示例都包含在内。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add ProdaZhang/aidd

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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。

进入时——自检,然后路由(主动推进)

  1. 脊柱是否存在?(project-charter + manifest)—— 否 → 从概念阶段开始构建。是 → 读取两者。
  2. 哪些系统尚未为 Final? 列出它们;询问这次推进哪个。
  3. 是否存在 Recheck 系统?(共享项已更改)→ 先通过完成/同步阶段解决。
  4. 编号范围冲突/依赖循环? 检查并报告。

阶段(读取对应的剧本,然后执行工作)

你想要做什么读取
概念:核心循环/平台/用户/拆分为系统/启动脊柱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 初始化。

相关技能