用途:用于把项目上下文以最快方式交给 AI,使 AI 在每次会话开始时已知项目,减少重复解释。资料称其目标是让项目达到 100% ✪ AI-readiness,并面向时间紧张的使用者;深入掌握格式可转向 faf-expert,一键完成可转向 faf-wizard。
主要能力与机制:.faf 是 IANA 注册的上下文格式(application/vnd.faf+yaml),为可移植、由你拥有的类型化文件,任何 AI 可读,无需专属清单、不锁定厂商。faf-cli 有 21 个槽位,按应用类型决定必需槽位,不适用槽位可 slotignored 并排除出分母。AI 会检测技术栈与语言,从目标句和 README 中播种 who/what/where,how 来自技术栈检测,why 与 when 通常需要你自己回答;无法来源的内容留空,不编造。
使用方式:资料给出的最快路径为:faf auto(检测技术栈并从 README 播种)、faf score(查看数值与空槽)、faf go(确认已播种的 W,回答剩余 1–2 项)、faf score(达到 100%)、faf sync(可选,把上下文推入 CLAUDE.md / AGENTS.md)。目标句应具体,泛泛表达会被忽略。6 个 W 建议写成 3–4 词标签。
适用场景:单人或时间敏感的项目,希望快速生成可被多种 AI 读取的上下文,尤其是 CLI、API、全栈等不同应用类型,只填写真正相关的槽位。
限制:资料提醒仅在任务明确匹配来源与本地项目上下文时使用;应用前应验证命令、生成代码、依赖、凭据与外部服务行为;示例不能替代环境测试、安全审查或对破坏性/高成本操作的用户批准。团队/企业版有更多槽位,但不属于 faf-cli。许可证为 MIT,属于 FAF 技能家族。