Fibo Skills
当你在 FiboCode 内置终端里驱动 Agent CLI（Claude Code、Codex，或任何支持 Skills 的 Agent CLI）时，Fibo Skills 会把 FiboCode 的规格驱动工作流教给这个 Agent。它们是可选项——不装终端一样能用——但装上后，Agent 就拥有与 FiboCode 一致的头脑风暴 → 规格 → 计划 → 执行 → 同步闭环，产出直接落进 .fibo/ 文档体系，而不是游离在代码库之外。
Skills 是 Agent 按需加载的一组指令。Fibo Skills 开源发布，安装到你的 Agent里，而非安装到 FiboCode 中。
Skills 仓库： github.com/Alenkz12/FiboSkills
Skills 一览
这是一套工作流，而非一堆互不相干的命令。前五个 Skills 按阶段首尾相接，后两个是独立能力：
| Skill | 阶段 | 一句话用途 |
|---|---|---|
fibo-brainstorming | 想清楚 | 把模糊意图收敛成签字确认的 AC 列表 |
fibo-writing-plan | 定方案 | 由规格产出 design.md 与 plan.md |
fibo-executing-plan | 写代码 | 按顺序逐个执行计划任务 |
fibo-recording-diff | 留记录 | 把真实 diff 转成可逐 hunk 阅读的 diff.md |
fibo-conventions | 守规范 | 命名、注释、文档与提交同步的统一规则 |
fibo-code-analysis | 读代码 | 产出 file → structure → folder 的分层分析镜像 |
fibo-skills-reviewer | 自维护 | 审查 Skill 文件自身的措辞质量 |
fibo-brainstorming —— 先把需求问清楚
任何会改变外部可见行为的改动之前调用：它一次只问一个问题（能给选项时给选项），把"我想加个功能"收敛成 EARS 语法的验收标准（AC）列表，等你明确签字后才落成 spec.md。它不写生产代码、不跑测试、不提交——只负责让需求不含糊。
fibo-writing-plan —— 把规格变成方案与任务
规格签字后调用：读 spec.md，产出同目录下的 design.md（HOW，每条设计决策都挂上 ↔ AC 标记）与 plan.md（任务清单，每个任务写明涉及的 AC、涉及文件、验收方式）。AC 覆盖率不足 100%、或任务引用了不存在的 AC，它会拒绝落盘。
fibo-executing-plan —— 严格串行地执行计划
按 plan.md 的顺序逐个执行任务，不并发，以避免多任务同时写文件产生冲突。每个任务只被允许改动其清单内的文件；任务失败时停下来问你（跳过 / 中止 / 重试），不会擅自回滚。全部完成后打印实现报告，并自动接上 diff 记录与文档同步。
fibo-recording-diff —— 让改动可被阅读
实现完成后调用：从真实 diff 生成以 hunk 为单位的说明，按合理的阅读顺序编排文件，为每个 hunk 附上代码锚点与必要的 Mermaid 逻辑视图，解释"这段改动为什么存在、与周围逻辑如何衔接"。它不改代码、不改 AC。
fibo-conventions —— 文档与注释的统一口径
写任何 Markdown、加任何代码注释、在 .fibo/docs/ 下建任何文件时都适用：Mermaid 用法、码 / 文 / 图 标签格式、路径规则、命名规则、注释与代码的同步要求，以及提交前基于 .fibo/index.json 基线的批量文档增量同步流程。
fibo-code-analysis —— 结构化的代码分析产出
用于生成 .fibo/analysis 下的结构化分析结果，也用于理解与扩展 FiboCode 自身的分析流水线：提示词选择、并发策略、磁盘布局与各语言提示词。它与应用内的「代码分析」是同一套理解范式的两个入口。
fibo-skills-reviewer —— 给 Skill 自己做体检
只审查 Skill 文件的措辞质量：逻辑矛盾、逻辑缺口、指代不清、冗余漂移、维护性旁白泄漏等。它只改"怎么说"，不改"规则是什么"；发现真正的规则冲突时会停下来交由你裁决。
安装：Claude Code
Claude Code 从 .claude/skills/ 目录读取 Skills。放在项目级只作用于该代码库，放在用户级则处处可用：
# Project level (recommended: travels with the repo, so team and agent share one rule set)
git clone https://github.com/Alenkz12/FiboSkills .claude/skills
# Or user level (available in every project)
git clone https://github.com/Alenkz12/FiboSkills ~/.claude/skills
重启 Claude Code（或开启新会话），fibo-* Skills 便会出现在 Skills 列表中。用 /fibo-brainstorming 主动调用，或直接描述任务、让智能体自动匹配对应阶段。
安装：Codex 及其他智能体
Skill 文件是带 YAML frontmatter 的纯 Markdown，因此在各类智能体间可移植。先克隆到你希望的位置：
git clone https://github.com/Alenkz12/FiboSkills
- 自带 Skills 机制的智能体 —— 按它自己的文档，把 Skills 目录指向克隆出来的这份文件即可。
- 只读指令文件的智能体 —— 在它的指令文件（如
AGENTS.md）中写明这些 Skills 的位置与用途，让它在对应阶段自行读取。
验证是否生效
在 FiboCode 的内置终端里让智能体做一件小事，比如"给这个仓库加一个配置项"。生效时它不会直接改代码，而是先进入头脑风暴阶段向你确认 AC，随后留下 spec.md、design.md、plan.md，并将它们放在 .fibo/docs/specs/<feature>/ 下。
保持更新
Skills 以 git 克隆的形式存在，拉取最新版只需一行：
cd .claude/skills && git pull
求助渠道
- 在 github.com/Alenkz12/FiboSkills 浏览完整技能集。
- 在 GitHub Discussions 提问交流。
- 在 Issue 跟踪页反馈问题。