f2s-kb-fix

A repair workflow for correcting implementation or rule mistakes in a Flow2Spec project and updating its built-in knowledge base. The knowledge base stores reusable project rules and guidance.

In plain words
What is it for?
Use it after fixing code or project rules, particularly when task files, knowledge topics, revisions, or automated knowledge updates are involved.
Why use it?
It makes the corrected rule available for future work and checks for conflicts before changing shared knowledge.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/double-coding-lab/flow2spec/f2s-kb-fix
Any agent
npx skills add double-coding-lab/Flow2Spec --skill f2s-kb-fix
Clone the repo
git clone --depth 1 https://github.com/double-coding-lab/Flow2Spec

Made for: Claude Code, Codex.

Per session 40 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,346 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00040 $0.02346
Opus 5 $0.00020 $0.01173
Sonnet 5 $0.00008 $0.00469
Haiku 4.5 $0.00004 $0.00235

Measured 2d ago against content hash a6c0db881412, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

f2s-kb-fix scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/f2s-kb-fix/SKILL.md · 113 lines

How it starts

The opening of the file, as written. The whole thing — 113 lines — stays where its author put it; the contents beside it link to each section on GitHub.

任务路径:凡 .task/ 落盘与续作,**必须以 rules/f2s-task 解析的 TASK_ROOT 为准(.task.task/<developerId>;config → git → legacy)。下文若仍出现 .task/todo.json / .task/active/,均视为 TASK_ROOT/... 的简写

执行口径:f2s-kb-fix 默认"修代码 + 同步 .Knowledge",无需用户额外要求"请同步知识库"。

KB 自动合并协议(必须)

本技能不得把“人工执行命令”作为用户流程。修复完成后,由 agent 自己完成知识候选生成、合并、构建与校验:

  1. 将本次修复后的正确规则/实现边界转换为 kb-delta 草稿,记录 taskIddeveloperIdbaseRevisionschanges 与修复证据;若 changeTracking.fix=true 且已有任务目录,可把 delta 落在当前 TASK_ROOT/active/<task-name>/kb-delta.json,否则可在内存中形成等价对象。changes 可使用 appendBody / replaceBody / updateFrontmatter;确需新主题时使用 createTopic,并可携带 taskRulematcher 让路由一并接入。
  2. 写入 .Knowledge 前,必须用 flow2spec kb plan <delta> 或等价内部能力预演;若 topic revision 不一致,停止自动写入,转入语义合并说明。
  3. 可自动合并时,由 agent 调用 flow2spec kb apply <delta> 或等价内部能力写入 topic,并随后执行 flow2spec kb buildflow2spec kb check
  4. 用户只看到“修复与知识库已同步 / 有语义冲突需确认 / 已跳过入库及原因”,不要求用户手动执行 kb plan/apply/build/check

编排(主 / 子 agent)

  • 两字段(subAgent / switchAgentVerification)语义以统一入口为唯一事实源:Cursor/Claude 读配置根 rules/f2s-flow2spec-unified-entry.*Codex.codex/topics/f2s-flow2spec-unified-entry.md(与上同源,flow2spec init 镜像)。本处不复述。
  • 代码子包(bug 修复类实现代码):subAgent=true 时可外包给子 agent 执行。
  • 文档子包(rules / skills / topics / stock-docs 等文风类改动):默认不拆,由主 agent 直接编写,以保证「现行真值覆盖 / 篇幅上限 / 禁历史否定堆砌」等文风合规。
  • 若确需外包文档改动:子侧只输出「原位替换 diff」(before / after 小段),不得整文件重写;由主 agent 合并落盘。
  • 写权硬约束:manifest-routing.json / .Knowledge/index.md 恒由主 agent 落盘,子 agent 不得触碰。
  • 落盘侧自验。

/修正能力(f2s-kb-fix)

输入

  • 用户描述违规点、正确写法、可选范围。

步骤

步骤 0:变更追踪(仅当 changeTracking.fix: true

执行前读取 flow2spec.config.json,若 changeTracking.fix: true

  • 检查 .task/todo.json 是否存在活跃任务,将用户描述与 keywords 匹配。
  • 命中 → 加载对应 task.md,展示剩余清单,在已有任务中继续。
  • 无命中 → 创建新任务(见 f2s-task 规则),将步骤 1–4 写入 task.md 作为任务 checklist。
  • 执中必写盘:每完成 task.md 中一步,同一会话内立即 Edit 将该步 [ ][x];禁止积压打钩或口头完成代替写盘(见 f2s-task「中断与会话结束」「归档门禁」)。
  • 用户代办:凡须用户改库、配环境、回归验证等项,同会话内追加写入 .task/active/<task-name>/user-todos.md(见 f2s-task);新建任务时若无代办可写占位说明。

Read the full file on GitHub · 113 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 113 lines · 40 tokens per session scan A a6c0db881412

Subscribe to this mod's changes

f2s-kb-fix is a skill published in the GitHub repository double-coding-lab/Flow2Spec (47 stars, last pushed 4d ago), licensed MIT. It adds 40 tokens to every session and 2,346 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

obra/superpowers · 37 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens

babysit-pr

Babysit a GitHub pull request after creation by continuously polling review comments, CI checks/workflow runs, and mergeability state until the PR is merged/closed or user help is required. Diagnose failures, retry likely flaky failures up to 3 times, auto-fix/push branch-related issues when appropriate, and keep…

openai/codex · 114 tokens

imagegen

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output…

openai/codex · 113 tokens