@double-codeing/flow2spec 3.0.18 → 3.0.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -9
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -48,19 +48,25 @@ AI: 开始改，预计 3 处文件。
|
|
|
48
48
|
|
|
49
49
|
---
|
|
50
50
|
|
|
51
|
-
## Flow2Spec
|
|
51
|
+
## Flow2Spec 做这些事
|
|
52
52
|
|
|
53
|
-
**①
|
|
54
|
-
`.Knowledge/` 结构化知识库：路由清单（manifest-routing.json）+ 关键词索引（matchers）+ 主题分片（topics）。AI
|
|
55
|
-
启动时只读该读的。
|
|
53
|
+
**① 跨会话记住项目上下文**
|
|
54
|
+
`.Knowledge/` 结构化知识库：路由清单（manifest-routing.json）+ 关键词索引（matchers）+ 主题分片（topics）。AI 启动时只读该读的，4.7 MB 源码压到 300 行精准上下文。
|
|
56
55
|
|
|
57
56
|
**② 路由清单让 AI 不翻仓库，只拿该拿的**
|
|
58
|
-
每次需求命中 1~4 个 topic，约 300 行。业务的硬约束——锁的 key、错误码、上限——都在
|
|
59
|
-
topic 里，AI 不用从源码猜。
|
|
57
|
+
每次需求命中 1~4 个 topic，约 300 行。业务的硬约束——锁的 key、错误码、上限——都在 topic 里，AI 不用从源码猜。
|
|
60
58
|
|
|
61
59
|
**③ f2s-* 技能改代码顺手更新知识**
|
|
62
|
-
`/f2s-kb-feat` 写功能时同步写 topic，`/f2s-kb-fix` 修 bug 时更正 topic
|
|
63
|
-
|
|
60
|
+
`/f2s-kb-feat` 写功能时同步写 topic，`/f2s-kb-fix` 修 bug 时更正 topic，`/f2s-git-commit` 提交前检查 topic 覆盖。改代码就是记知识，没有"单独维护文档"这件事。
|
|
61
|
+
|
|
62
|
+
**④ 需求到实现全链路：澄清 → 技术方案 → 代码**
|
|
63
|
+
`/f2s-req-clarify` 反问到无歧义，`/f2s-req-backend` 生成可直接实现的技术方案文档落到 `req-docs/`，AI 按方案实现，不靠口头约定。
|
|
64
|
+
|
|
65
|
+
**⑤ 任务清单跨会话追踪进度**
|
|
66
|
+
开启 `changeTracking` 配置后，`f2s-kb-feat` / `f2s-kb-fix` 等技能执行时自动创建带 checkbox 的 `task.md`，每步完成立即打钩落盘。新会话续作时自动加载剩余清单，不靠记忆、不靠口头，任务进度永远在磁盘上。用户侧的代办（执行 SQL、配环境变量、点审批）单独写入 `user-todos.md`，不混在 AI 步骤里。
|
|
67
|
+
|
|
68
|
+
**⑥ 文档驱动：PDF / MD 一键入知识库**
|
|
69
|
+
`/f2s-doc-add` 把已落地能力的源码聚合成初稿 → 终稿 → topics，`/f2s-doc-final` 把 PDF 或任意 MD 转成规范终稿格式。外部文档、历史方案都能变成可路由的知识。
|
|
64
70
|
|
|
65
71
|
---
|
|
66
72
|
|
|
@@ -117,7 +123,7 @@ npx @double-codeing/flow2spec@latest init
|
|
|
117
123
|
```
|
|
118
124
|
/f2s-req-clarify 一句话需求或粘贴 PRD ← 需求澄清
|
|
119
125
|
/f2s-req-backend ← 生成技术方案
|
|
120
|
-
自然语言：实现上面的技术方案 ← AI
|
|
126
|
+
自然语言：实现上面的技术方案 ← AI 开始实现（开启 changeTracking 时自动建任务清单）
|
|
121
127
|
（调试验证）
|
|
122
128
|
/f2s-kb-feat 新增 xxx 能力 ← 功能缺失时补能力
|
|
123
129
|
/f2s-kb-fix 修复 xxx ← 有 BUG 时修复
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@double-codeing/flow2spec",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.19",
|
|
4
4
|
"description": "在业务仓库初始化「文档驱动、可写回知识库」的 AI 协作骨架：项目根 .Knowledge 承载 stock-docs/req-docs 与机读路由，.cursor/.claude/.codex 写入 f2s-* 规则与技能（含 Karpathy 式编码行为准则 f2s-karpathy-guidelines，init 同步 rules / Codex topics / skills）；init 只落结构与模板，业务内容由各 f2s-* 技能在对话中维护。",
|
|
5
5
|
"homepage": "https://github.com/Lands-1203/Flow2Spec#readme",
|
|
6
6
|
"repository": {
|