facts
用可验证的事实文件管理项目规范，实现人机协同开发。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：facts。 它的用途是：用可验证的事实文件管理项目规范，实现人机协同开发。 完整的 Skill 内容见：https://321skill.com/skills/facts/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用 facts 技能，帮我初始化当前项目的规范文件，并检查一下我们有哪些已实现和待实现的功能点。” 它会运行 `facts init` 创建 `.facts` 文件，然后运行 `facts check` 生成一份清晰的报告，列出所有 `@implemented`（已实现）、`@spec`（待开发）和 `@draft`（草案）状态的事实，让你快速掌握项目全貌。
介绍
facts 是一个用于管理项目规范的技能。它通过一个名为 .facts 的纯文本文件，将项目需求、设计决策和实现状态以“事实”的形式记录下来，并用 @draft、@spec、@implemented 等标签追踪其生命周期。每个事实都可以关联一个 shell 命令，用于自动验证该声明是否在代码中成立。
使用时，开发者或 AI 智能体可以运行 facts check 命令来验证所有事实，快速了解项目进度（哪些已实现、哪些在开发、哪些还是草案）。AI 智能体可以利用配套的 facts-discover、facts-refine、facts-implement 等技能，自动扫描代码库、将草案细化为规格、并推动规格的实现与验证，形成一个从构思到落地的自动化工作流。
它非常适合需要清晰、可执行规范来对齐团队或指导 AI 智能体进行开发的工程师、技术负责人和项目经理。尤其适用于敏捷开发、远程协作或人机协同编码的场景，能有效减少沟通歧义，确保实现与设计一致。
建议从 facts init 开始，让工具根据你的技术栈生成初始事实文件。定期运行 facts check 来同步项目状态，并鼓励 AI 智能体主动使用相关技能来推进事实的生命周期，从而将规范管理真正融入开发流程。
核心特点
与传统的文档或需求管理工具不同，facts 的核心在于“可验证性”和“AI 可操作性”。它将规范分解为原子事实并允许附加验证命令，使 AI 智能体能够自动检查、推进并实现这些规范，而不仅仅是静态记录。
注意事项
不适合管理高度抽象、难以用具体命令验证的宏观战略或纯商业需求。
常见问题
facts 文件和普通的 README 或需求文档有什么区别？
facts 文件是结构化、可验证、供 AI 操作的动态规范，每个事实都有明确的生命周期状态和可选的验证命令，而传统文档是静态的、供人阅读的描述。
AI 智能体如何参与 facts 的工作流？
AI 可以通过配套技能自动发现代码中的事实、将草案细化为具体规格、并尝试实现规格，最后运行验证命令并更新事实状态，实现规范的自动化推进。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/facts/raw/index.md 读取 facts 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/facts/raw/index.md（查看排版版本）