@double-codeing/flow2spec
Advanced tools
在业务仓库初始化「文档驱动、可写回知识库」的 AI 协作骨架：项目根 .Knowledge 承载 stock-docs/req-docs 与机读路由，.cursor/.claude/.codex 写入 f2s-* 规则与技能（含 Karpathy 式编码行为准则 f2s-karpathy-guidelines，init 同步 rules / Codex topics / skills）；init 只落结构与模板，业务内容由各 f2s-* 技能在对话中维护。
Flow2Spec 用于在业务仓库初始化一套可持续的 AI 协作结构：
.Knowledge/.cursor/、.claude/、.codex/）集中管理项目知识，同时不破坏各工具原生的 rules/skills 加载机制。
🎬 在线演示：组内分享用的 13 页 HTML PPT（脱敏版）——https://lands-1203.github.io/Flow2Spec/
←→翻页，S打开演讲者模式。源文件见 presentations/flow2spec-intro-public/。
npx @double-codeing/flow2spec@latest init
npx @double-codeing/flow2spec@latest init cursor claude codex
可选：全局安装 CLI 后，可在仓库根直接使用 flow2spec init …（与上文等价）：
npm install -g @double-codeing/flow2spec@latest
init 完成后的目录结构：
| 路径 | 用途 |
|---|---|
.Knowledge/stock-docs/ | 架构说明、终稿等沉淀文档 |
.Knowledge/req-docs/ | 需求澄清与技术方案 |
.Knowledge/topics/ | 主题路由摘要 |
.Knowledge/template/ | 终稿与技术方案模板 |
.Knowledge/manifest-routing.json + matchers/ | 机器可读路由与关键词索引 |
配置根/rules/ + 配置根/skills/ | 各工具规则与技能入口 |
flow2spec.config.json | 控制 subAgent、switchAgentVerification、changeTracking（各技能独立子项），默认均为 false |
init只做结构与模板补齐，业务文档内容由f2s-*技能维护。详见 Flow2Spec使用说明。
包升级后可在业务仓库用 /f2s-kb-upgrade 对齐知识库模板与路由；细则见 使用说明。
所有技能均以 f2s-* 前缀或主题名在 Agent 内触发。以下按业务场景分组，标明推荐执行链路与前置条件。
前置要求：涉及「旧库迁移」或「包模板对齐」时，需先在本地安装最新 CLI：
npm install -g @double-codeing/flow2spec@latest其余场景以仓库内已初始化的规则与技能为准。
从 PRD 到代码落地的完整路径。
任务清单控制：
f2s-req-plan强制创建任务清单；f2s-implement-tech-design是否使用任务清单取决于changeTracking.implement配置。
| 场景 | 执行链 | 产出 |
|---|---|---|
| 有 PRD，需澄清后出方案并落地 | f2s-req-clarify → f2s-req-backend → f2s-implement-tech-design → f2s-kb-feat | 澄清纪要 → 技术方案 → 实现+知识库 |
| 已有方案，需强制任务清单后实现 | f2s-req-plan |
| 可确认任务清单与实现编排 |
将非结构化信息（口述、草稿、外部文档、代码）转化为可检索的知识资产。
| 场景 | 执行链 | 产出 |
|---|---|---|
| 从口述/草稿到终稿 | f2s-doc-arch → f2s-doc-final → f2s-ctx-build | 架构初稿 → 规范终稿 → 主题路由 |
| 外部文档转知识库 | f2s-doc-final → f2s-ctx-build | 可检索 Markdown + 路由索引 |
| 存量代码/散稿补录 | f2s-doc-add 或 f2s-kb-sync | 自动提取能力 → 主题索引 |
缺陷修复、迭代与上下文同步。
| 场景 | 技能 |
|---|---|
| 修复缺陷 | f2s-kb-fix |
| 新增功能 | f2s-kb-feat |
| 同步已实现能力 | f2s-kb-sync |
| 解决合并冲突 | f2s-kb-merge |
一次性或周期性的结构化维护。
| 场景 | 技能 | 注意事项 |
|---|---|---|
旧版迁移（rules/skills 散稿 → .Knowledge） | f2s-kb-migrate | 一次性；执行前备份 |
| 模板对齐（包升级后同步） | f2s-kb-upgrade | 可重复执行 |
.Knowledge/ 只放业务文档与索引，不放规则执行文件。rules/ skills/ 始终在配置根，保证 Claude/Cursor/Codex 按各自方式加载。rules/ 目录，通过 .codex/AGENTS.md + skills/ + .codex/topics/*.md承载约束入口。FAQs
在业务仓库初始化「文档驱动、可写回知识库」的 AI 协作骨架：项目根 .Knowledge 承载 stock-docs/req-docs 与机读路由，.cursor/.claude/.codex 写入 f2s-* 规则与技能（含 Karpathy 式编码行为准则，init 同步 rules / Codex topics / skills）；init 只落结构与模板，业务内容由各 f2s-* 技能在对话中维护。
The npm package @double-codeing/flow2spec receives a total of 144 weekly downloads. As such, @double-codeing/flow2spec popularity was classified as not popular.
We found that @double-codeing/flow2spec demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
A misconfiguration gave three Anthropic models internet access, and one, believing it was in a simulation, shipped a credential-stealing package to PyPI.
Security News
/Company News
Socket has joined the new Composer and Packagist sponsorship program as a launch sponsor, supporting the team that keeps PHP's package ecosystem secure.
Research
/Security News
Benign-looking npm packages split malicious functionality across a dependency chain that deploys a cross-platform RAT targeting Alibaba developers.