用途:本技能将 Apache Airflow 的 AIP(改进提案)转化为两种文档。未提供 PR 链接时进入“实现前模式”,依据 AIP 规范生成推测性用户故事,帮助 AIP 作者校验设计;提供 PR 链接时进入“实现后模式”,依据代码库实际实现生成经验证的配方手册。
调用方式:/aip-user-stories <AIP-URL-or-pasted-content> [<PR-URL>...] [<file>...]。无参数时打印用法摘要并停止。以 https://cwiki.apache.org/confluence/ 开头的是 AIP URL,以 https://github.com/apache/airflow/pull/ 开头的是 PR URL,其余为本地文件路径。
主要能力:从 URL 或粘贴内容提取 AIP 编号,结果写入 .claude/aip-{number}.md,文件已存在时先询问是否覆盖。实现后模式用 gh pr view 与 gh pr diff 获取 PR 信息,并以 PR 为线索向外探索模块、示例 DAG 和测试文件,交叉核对 AIP 功能是否已实现;代码块分已验证、改编、未验证三级。实现前模式中所有代码块均标记为推测性,并要求每个故事附上针对性的开放设计问题(API 易用性、边界情况、兼容性、可行性)。
使用方式:实现后模式需至少一个 PR URL;实现前模式会忽略文件路径参数并提示。版本可通过 PR diff 中的 versionadded 指令推断,否则需询问用户。Confluence 页面若抓取内容不完整需请用户粘贴。
限制:PR 只是发现线索而非边界,应以当前代码库状态为准;AIP 术语常与实现不一致,需以代码库校验名称。生成前后有一处需用户批准。官方未提供收费、价格或平台支持信息。