@double-codeing/flow2spec 3.0.17 → 3.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@double-codeing/flow2spec",
-  "version": "3.0.17",
+  "version": "3.0.18",
   "description": "在业务仓库初始化「文档驱动、可写回知识库」的 AI 协作骨架：项目根 .Knowledge 承载 stock-docs/req-docs 与机读路由，.cursor/.claude/.codex 写入 f2s-* 规则与技能（含 Karpathy 式编码行为准则 f2s-karpathy-guidelines，init 同步 rules / Codex topics / skills）；init 只落结构与模板，业务内容由各 f2s-* 技能在对话中维护。",
   "homepage": "https://github.com/Lands-1203/Flow2Spec#readme",
   "repository": {

package/templates/rules/f2s-flow2spec-unified-entry.mdc

@@ -79,6 +79,15 @@ alwaysApply: true
 - **禁止**在命中 **1b / 2** 后，未做上述可见说明便进入「多文件 + 依赖目录」的链式探源；每出现一个新的「入口符号」就再 `Grep` 一轮，属于典型反模式。
 - **HTTP 状态、错误正文、重定向与否**等事实，**不得以训练数据或他库经验代答**；须以当前仓库内**本次已读到的实现**为准。
 
+## 知识库落盘文风（全局，写 stock-docs / topics / index 时适用）
+
+**肯定式优先**：表述正确信息时，直接说"是什么 / 在哪里 / 怎么做"，禁止用"不是 X / 非 X / 不再是 X"来传达——即使旧描述是错的，否定旧版也会让读者在脑中锚定错误前提。
+
+- 错：`随包 import，非 window 注入`
+- 对：`通过 import { <符号> } from '<包名>' 引入`
+
+**例外（应显式否定）**：A、B 两种做法在逻辑上均正确，但项目已做出**排他性选择**时，须写出「不用 B」——不说清楚，读者无法判断 B 是否仍可选。
+
 ## 禁止项
 
 - **`templates/` 可下发约束**（经 `init` 会克隆到任意业务仓）：技能/规则/知识模板正文中的示例须**中性**——勿写特定业务域名称、单一组织 npm 包名、仅 Flow2Spec 产品仓存在的 `docs/` 路径；用 `<能力>`、`src/<模块>/` 等占位。

package/templates/skills/f2s-kb-feat/SKILL.md

@@ -82,7 +82,7 @@ description: 新增能力时补全实现与知识库；已实现则仅同步知
 写 `stock-docs` / `topics` / `index` 时遵守：
 
 1. **增量最小**：只追加或改写与**本次能力**直接相关的句段；禁止因「同步知识库」而全文重述背景、需求复述、与实现无关的教程式铺垫。
-2. **现行真值覆盖（禁止历史否定堆砌）**：约定从「与 A 有关」变为「与 B 有关」等时，应**删除或原位改写**与旧约定冲突的句子，正文只写**当前成立**的关系（例如直接写与 B 的边界与流程）。**禁止**在正确句后再叠「（不再与 A 有关）」「已与 A 脱钩」「原与 A 有关现已改」等括号、脚注或对照旧版的赘述。仅在用户明确要求写「迁移 / breaking 说明」时，可单开一小节简要列旧→新，且仍避免正文逐句否定旧版。
+2. **肯定式优先（见统一入口「知识库落盘文风」）**：直接写出正确描述，禁止用否定旧版来传达新约定；排他性选择除外。
 3. **不重复叙事**：同一事实在 `stock-docs` 与 `topics` **不要各写一长篇**；择一处写清可执行约定，另一处用短段落 + 链接指向，或仅列要点与引用路径。
 4. **条文化优先**：`topics` 以规则、边界、步骤、错误与配置要点为主；能用列表/表格表达的不用长段落。
 5. **篇幅上限（软约束）**：单次同步中，对**同一文件**的新增正文合计不宜超过约 **80 行**（不含代码块行）；超出则拆分为新 topic、或先写「摘要 + 详见代码路径/另一文档」，禁止单文件堆叠重复说明。

package/templates/skills/f2s-kb-fix/SKILL.md

@@ -78,7 +78,7 @@ description: 根据用户指出的实现或规则错误修正代码，并默认
 写 `stock-docs` / `topics` / `index` 时遵守：
 
 1. **增量最小**：只改与**本次修复**直接相关的段落或列表项；禁止借机重述整份方案、整段历史背景或与修复无关的说明。
-2. **现行真值覆盖（禁止历史否定堆砌）**：修复后约定从「与 A 有关」变为「与 B 有关」等时，应**删除或原位改写**仍写着旧约定的句子，正文只保留**当前成立**的表述。**禁止**叠写「（不再与 A 有关）」「原错误地与 A 绑定」等对照旧版的括号或脚注；除非用户明确要求「迁移说明」，否则不写旧→新对照长文。
+2. **肯定式优先（见统一入口「知识库落盘文风」）**：直接写出正确描述，禁止用否定旧版来传达新约定；排他性选择除外。
 3. **不重复叙事**：`stock-docs` 与 `topics` 不就同一修复各写长篇；一处写清「错因 / 正确约定 / 注意点」，另一处简短引用或链到该段。
 4. **条文化优先**：以「错误表现 → 根因 → 正确行为 / 边界」为序的短列表为主，避免散文式展开。
 5. **篇幅上限（软约束）**：单次同步中，对**同一文件**的新增或替换正文合计不宜超过约 **60 行**（不含代码块行）；超出则只保留与修复相关的最小说明，其余用「见提交/见某路径」代替。