@double-codeing/flow2spec 3.0.11 → 3.0.12
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/package.json +1 -1
- package/templates/knowledge/index.md +3 -1
- package/templates/knowledge/manifest-matchers.json +30 -0
- package/templates/knowledge/manifest-routing.json +19 -1
- package/templates/knowledge/matchers/m-change-tracking.json +17 -0
- package/templates/knowledge/matchers/m-req-plan.json +15 -0
- package/templates/knowledge/topics/f2s-req-plan.md +27 -0
- package/templates/knowledge/topics/f2s-task.md +45 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@double-codeing/flow2spec",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.12",
|
|
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": {
|
|
@@ -26,9 +26,11 @@
|
|
|
26
26
|
| stock-docs-vs-req-docs | `.Knowledge/topics/f2s-stock-docs-vs-req-docs.md` | stock-docs / req-docs 目录分工 | stock：[目录边界说明](.Knowledge/stock-docs/<目录边界说明>.md)（可选） |
|
|
27
27
|
| fallback-triage | `.Knowledge/topics/f2s-fallback-triage.md` | 未命中或低置信度：分诊与澄清 | stock：[路由分诊说明](.Knowledge/stock-docs/<分诊说明>.md)（可选） |
|
|
28
28
|
| config-precheck | `.Knowledge/topics/f2s-config-precheck.md` | 执行 `f2s-*` 前读 `flow2spec.config.json` / 编排开关 | Codex 长文：仓库根 `.codex/topics/f2s-config-check.md`；[路由摘要](topics/f2s-config-precheck.md) |
|
|
29
|
+
| f2s-task | `.Knowledge/topics/f2s-task.md` | 变更追踪、`.task/` 任务清单与跨会话续作 | 长文：配置根 `rules/f2s-task.*`；Codex：`.codex/topics/f2s-task.md` |
|
|
30
|
+
| f2s-req-plan | `.Knowledge/topics/f2s-req-plan.md` | 需求/方案规划与实现；始终维护 `.task/` | 技能：`skills/f2s-req-plan/SKILL.md`；依赖 `f2s-task` |
|
|
29
31
|
|
|
30
32
|
每主题保留 **1–3 条** 可点击摘要链接；全量路径对照写入 `.Knowledge/migration-report.md`（迁移场景）。
|
|
31
|
-
其中 **`implement-tech-design`**、**`stock-docs-vs-req-docs`**、**`config-precheck`** 在 `topics/` 内为**路由摘要**；执行长文见配置根 **`rules/f2s-*.md(c)`**；使用 Codex 时见 **`.codex/AGENTS.md`**、**`.codex/topics/f2s-*.md`**（`f2s-config-check` 与 `AGENTS` 前置同源，按需打开）。
|
|
33
|
+
其中 **`implement-tech-design`**、**`stock-docs-vs-req-docs`**、**`config-precheck`**、**`f2s-task`** 在 `topics/` 内为**路由摘要**；执行长文见配置根 **`rules/f2s-*.md(c)`**；使用 Codex 时见 **`.codex/AGENTS.md`**、**`.codex/topics/f2s-*.md`**（`f2s-config-check` 与 `AGENTS` 前置同源，按需打开）。
|
|
32
34
|
|
|
33
35
|
---
|
|
34
36
|
|
|
@@ -30,6 +30,36 @@
|
|
|
30
30
|
"f2s-config-inject",
|
|
31
31
|
"changeTracking"
|
|
32
32
|
]
|
|
33
|
+
},
|
|
34
|
+
"m-change-tracking": {
|
|
35
|
+
"includeAny": [
|
|
36
|
+
"changeTracking",
|
|
37
|
+
"变更追踪",
|
|
38
|
+
"任务追踪",
|
|
39
|
+
"任务清单",
|
|
40
|
+
".task",
|
|
41
|
+
"续作",
|
|
42
|
+
"继续上次任务",
|
|
43
|
+
"todo.json",
|
|
44
|
+
"task.md",
|
|
45
|
+
"f2s-task",
|
|
46
|
+
"任务清单归档",
|
|
47
|
+
"跨会话"
|
|
48
|
+
]
|
|
49
|
+
},
|
|
50
|
+
"m-req-plan": {
|
|
51
|
+
"includeAny": [
|
|
52
|
+
"f2s-req-plan",
|
|
53
|
+
"任务规划",
|
|
54
|
+
"任务清单设计",
|
|
55
|
+
"需求规划",
|
|
56
|
+
"创建任务清单",
|
|
57
|
+
"规划需求",
|
|
58
|
+
"req-plan",
|
|
59
|
+
"需求实现",
|
|
60
|
+
"按需求实现",
|
|
61
|
+
"按方案规划"
|
|
62
|
+
]
|
|
33
63
|
}
|
|
34
64
|
}
|
|
35
65
|
}
|
|
@@ -16,7 +16,9 @@
|
|
|
16
16
|
"implement-tech-design": ".Knowledge/topics/f2s-implement-tech-design.md",
|
|
17
17
|
"stock-docs-vs-req-docs": ".Knowledge/topics/f2s-stock-docs-vs-req-docs.md",
|
|
18
18
|
"fallback-triage": ".Knowledge/topics/f2s-fallback-triage.md",
|
|
19
|
-
"config-precheck": ".Knowledge/topics/f2s-config-precheck.md"
|
|
19
|
+
"config-precheck": ".Knowledge/topics/f2s-config-precheck.md",
|
|
20
|
+
"f2s-task": ".Knowledge/topics/f2s-task.md",
|
|
21
|
+
"f2s-req-plan": ".Knowledge/topics/f2s-req-plan.md"
|
|
20
22
|
},
|
|
21
23
|
"taskToTopicRules": [
|
|
22
24
|
{
|
|
@@ -43,6 +45,22 @@
|
|
|
43
45
|
"topics": [
|
|
44
46
|
"stock-docs-vs-req-docs"
|
|
45
47
|
]
|
|
48
|
+
},
|
|
49
|
+
{
|
|
50
|
+
"task": "change-tracking",
|
|
51
|
+
"matcherId": "m-change-tracking",
|
|
52
|
+
"matcherPath": ".Knowledge/matchers/m-change-tracking.json",
|
|
53
|
+
"topics": [
|
|
54
|
+
"f2s-task"
|
|
55
|
+
]
|
|
56
|
+
},
|
|
57
|
+
{
|
|
58
|
+
"task": "req-plan",
|
|
59
|
+
"matcherId": "m-req-plan",
|
|
60
|
+
"matcherPath": ".Knowledge/matchers/m-req-plan.json",
|
|
61
|
+
"topics": [
|
|
62
|
+
"f2s-req-plan"
|
|
63
|
+
]
|
|
46
64
|
}
|
|
47
65
|
]
|
|
48
66
|
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# f2s-req-plan（路由摘要）
|
|
2
|
+
|
|
3
|
+
> 长文见配置根 **`skills/f2s-req-plan/SKILL.md`**。
|
|
4
|
+
> **`.task/` 真值源**：配置根 **`rules/f2s-task.*`**（Codex：`.codex/topics/f2s-task.md`）。
|
|
5
|
+
> 设计背景：[Flow2Spec 任务清单与变更追踪](../stock-docs/<任务清单说明>.md)（可选）。
|
|
6
|
+
|
|
7
|
+
## 依赖
|
|
8
|
+
|
|
9
|
+
执行本主题前须先读依赖主题 **`f2s-task`**（`manifest-routing.topicDependencies`）。
|
|
10
|
+
|
|
11
|
+
## 作用
|
|
12
|
+
|
|
13
|
+
从技术方案或需求描述出发：**续作分诊 → 草稿确认 → 按 f2s-task 落盘 → 实现 → 归档**。
|
|
14
|
+
|
|
15
|
+
1. 步骤 0：`flow2spec.config.json` + **`f2s-task` 全文**
|
|
16
|
+
2. `f2s-task`「任务开始」：检查 `todo.json` / keywords 续作
|
|
17
|
+
3. 草稿确认（主 agent）
|
|
18
|
+
4. 落盘 `task.md` / `context.md` / `user-todos.md` / `todo.json`（`linkedSkill: f2s-req-plan`）
|
|
19
|
+
5. 实现并按步打钩；用户代办写 `user-todos.md`
|
|
20
|
+
6. 满足归档门禁后移入 `completed/<YYYYMMDD>-<task-name>/`
|
|
21
|
+
|
|
22
|
+
不依赖 `changeTracking`，但 **始终** 服从 `f2s-task`。
|
|
23
|
+
|
|
24
|
+
## 下一步
|
|
25
|
+
|
|
26
|
+
- 技能全文：`skills/f2s-req-plan/SKILL.md`
|
|
27
|
+
- 任务规则：`rules/f2s-task.*` 或 `.codex/topics/f2s-task.md`
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# f2s-task（路由摘要）
|
|
2
|
+
|
|
3
|
+
> 长文见配置根 **`rules/f2s-task.*`**。
|
|
4
|
+
> 体系化设计说明（两种模式、目录、`todo.json`）：[Flow2Spec 任务清单与变更追踪](../stock-docs/Flow2Spec-任务清单与变更追踪.md)。
|
|
5
|
+
|
|
6
|
+
## 作用
|
|
7
|
+
|
|
8
|
+
变更追踪规则（`alwaysApply: true`）。当对应技能的 `changeTracking.*` 为 `true` 时，技能执行前后自动创建、逐步更新、最终归档 `.task/` 下的任务清单，支持跨会话续作。
|
|
9
|
+
|
|
10
|
+
## 生效范围
|
|
11
|
+
|
|
12
|
+
| 配置项 | 对应技能 |
|
|
13
|
+
| --- | --- |
|
|
14
|
+
| `changeTracking.feat` | `f2s-kb-feat` |
|
|
15
|
+
| `changeTracking.fix` | `f2s-kb-fix` |
|
|
16
|
+
| `changeTracking.implement` | `f2s-implement-tech-design` |
|
|
17
|
+
|
|
18
|
+
`f2s-req-plan` 不受配置约束，始终创建任务清单。
|
|
19
|
+
|
|
20
|
+
## 目录结构
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
.task/
|
|
24
|
+
├── todo.json ← 活跃任务索引（仅主 agent 写）
|
|
25
|
+
├── active/<task-name>/
|
|
26
|
+
│ ├── task.md ← checklist（执行步骤）
|
|
27
|
+
│ ├── context.md ← 涉及文件、文档链接
|
|
28
|
+
│ └── user-todos.md ← 须用户执行的代办（改库、配环境等）
|
|
29
|
+
└── completed/<YYYYMMDD>-<task-name>/
|
|
30
|
+
├── task.md
|
|
31
|
+
├── context.md
|
|
32
|
+
└── user-todos.md
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
用户代办**必须**落在与 `task.md` 同目录的 **`user-todos.md`**，细则见配置根 **`rules/f2s-task.*`**。
|
|
36
|
+
|
|
37
|
+
## 跨会话续作
|
|
38
|
+
|
|
39
|
+
新会话开始时若存在 `todo.json`，规则自动将用户首条消息与各条目 `keywords` 匹配：
|
|
40
|
+
- 命中 → 展示剩余 checklist，**摘要 `user-todos.md` 中未完成项（若有）**，加载 `linkedSkill` 对应技能文件作为执行上下文，提示是否继续
|
|
41
|
+
- 无命中 → 不打扰，正常响应
|
|
42
|
+
|
|
43
|
+
## 下一步
|
|
44
|
+
|
|
45
|
+
读配置根 `rules/f2s-task.*` 获取完整规则（目录结构、todo.json 格式、任务生命周期、Hook 配置）。
|