@yottameta/yotta-workflow 0.2.2 → 0.2.4

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: yotta-workflow
-description: "Universal cross-session, cross-project workflow standard for AI agents: 开工必读状态、状态就近存、进行中自动记流水/任务/决策、收工必留交接锚点。Use when starting or ending a working session, resuming a project, or whenever project state changes. 适合所有 AI 智能体的通用工作流。Not for one-off read-only questions."
-version: 0.1.3
+description: "跨会话/跨项目通用工作流标准：让任何 AI 智能体活过会话——开工必读状态、状态就近存 .workflow、进行中自动记流水/任务/决策、收工必留交接锚点。触发：开工/接手项目、续测、收工、跨会话恢复、要落盘、多步开发、项目状态变化、跨智能体协作。项目型会话自动初始化 .workflow 状态目录并按本协议全程执行；轻量一次性问答不强制初始化。所有 AI 智能体通用。"
+version: 0.2.4
 license: MIT
 agent_created: true
 metadata:
@@ -16,6 +16,39 @@ metadata:
 
 ---
 
+## 快速判定（先看这节，30 秒决定要不要用）
+
+> 这是全局层工作流标准，装上它就是为了让 AI 自动按此执行，**不需要用户每次提醒**。
+
+| 判断项 | 结论 |
+| --- | --- |
+| **这是什么** | 跨会话 / 跨项目的工作流协议：开工读状态 → 进行中记流水/任务/决策 → 收工留锚点。状态统一存本项目 `.workflow`。 |
+| **何时触发** | 涉及「项目」「续测」「跨会话」「要落盘」「多步开发」「收工」即触发；一次性只读问答不触发。 |
+| **怎么用（三步）** | ① 按「〇」定状态目录 → ② 存在就读 STATE/TASKS/ROADMAP/DECISIONS + 近期 logs；不存在就初始化 → ③ 全程按「二/三/四」执行，收工输出「五」锚点。 |
+| **是否初始化 `.workflow`** | **项目型会话**（有项目根 / 要落盘 / 多步开发）→ 自动初始化并全程执行；**轻量临时会话**（纯问答 / 一次性）→ 不初始化，只按需提示。 |
+| **AI 该记住什么** | 只记「项目状态类」：进度 / 任务 / 决策 / 流水。**不记**：AI 人格 / 用户偏好 / 关系 / 跨项目通用知识（非项目状态，不写入本技能状态文件）。 |
+---
+
+## 这个技能与智能体自带记忆的关系（本质）
+
+> 它**不取代**任何智能体的记忆，而是补足"自带记忆做不到"的那部分：**跨智能体共享、跨会话续接、统一的项目状态真相源 + 强制流程**。
+
+**智能体自带的记忆**（如 `AGENTS.md`、`CLAUDE.md`、`rules`、`memory/`、会话内上下文）通常是**单机、单智能体、无统一结构**的，有几个局限：
+- 只在"**这一个智能体**"里生效，别的智能体不读。
+- 各产品各写各的，项目状态会碎成多份、产生**多个真相源**。
+- 只提供"能存"，不规定"**何时读、何时写、写什么**"，靠 AI 自觉，容易漏。
+
+**本技能单独存在的价值**：
+- **跨智能体共用一套 `.workflow` 状态**：任何智能体读同一份 → 单一真相源。
+- **跨会话持久 + 无缝续接**：进度/任务/决策/流水落成文件，下个会话一读即续。
+- **强制流程纪律**：开工必读 → 进行中必记 → 收工必留锚点，不依赖 AI 自觉。
+- **状态结构统一**：STATE / TASKS / DECISIONS / ROADMAP / logs，AI 一读即知项目在哪、下一步做什么。
+
+**适用判断**：
+- **值得单独用**：多智能体协作同一项目、项目要长远跨会话做、或希望项目状态不碎成 N 份。
+- **不必单独用**：只用单一智能体、自带记忆够用、项目很轻 → 自带记忆即可，本技能是锦上添花。
+---
+
 ## 〇、状态文件位置判定规则
 
 > 说明：**状态目录**是项目内的共享隐藏目录，统一固定为 `.workflow\`（名称以 `.` 开头）。**对同一项目，任何智能体会话（无论 Codex / Cursor / Hermes / OpenCode…）都读写这一份共享状态目录**，以此保证"不同智能体协作共用一套状态"成立——而不是各智能体各建一份（那样会产生多个真相源，上一程记的状态下一程读不到）。技能可被安装分发到多个智能体，但状态目录命名与所用智能体无关，永远落在同一个 `.workflow\`。
@@ -78,10 +111,16 @@ metadata:
 2. **主动及时写流水**：**每做完一件事就追加**到当天的 `logs/YYYY-MM-DD.md`（不存在则新建），不攒到收工。流水记"做了什么、产出什么、踩了什么坑"。
 3. **决策落盘**：做出影响项目方向的决定（技术选型、命名、放弃某方案）时，当场写入 `DECISIONS.md`，写明背景和理由。
 4. **进度快照**：`STATE.md` 的"当前进度"保持最新，这是下个会话恢复的关键，不能滞后。
-5. **记忆分层**（按"重要性 + 范围"分三档，别都堆进一个文件）：
-   - **流水**：每件事的即时记录 → `logs/YYYY-MM-DD.md`（项目内）。
-   - **重要 / 长期记忆**：跨会话仍要用的项目事实、决定、进度 → 项目记忆文件 `STATE.md`、`TASKS.md`、`DECISIONS.md`、`ROADMAP.md`（项目内）。
-   - **跨项目记忆**：跨项目/跨会话都要用的通用知识、环境事实、红线 → **永久记忆文件**（如全局 `AGENTS.md`）。该文件保持精简，用**锚点**指向具体文件，不无限堆内容。
+5. **记忆分层（该记什么 / 不记什么）**：
+   - **要记（写入本项目 `.workflow`）**：
+     - 项目进度快照（当前做到哪、下步是什么）→ `STATE.md`
+     - 任务清单与状态（待办/进行中/完成）→ `TASKS.md`
+     - 影响方向的决策（技术选型/命名/放弃方案 + 背景理由）→ `DECISIONS.md`
+     - 长期目标与下一步计划 → `ROADMAP.md`
+     - 每天做了什么、产出、踩坑 → `logs/YYYY-MM-DD.md`
+   - **不记 / 不写**：
+     - 一次性闲聊、纯礼貌话、无长期价值的临时话
+     - AI 人格 / 用户偏好 / 称呼 / 关系 / 跨项目通用知识（非项目状态，不写入本技能状态文件）
 6. **防上下文压缩失忆**：凡是"下一个会话需要记得"的关键信息，**必须已经写进上面的文件**，不能只留在对话里；发现上下文变长/将被压缩时，先把关键状态落盘再继续。
 
 ---

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@yottameta/yotta-workflow",
-  "version": "0.2.2",
-  "description": "Universal cross-session, cross-project workflow standard for AI agents: 开工读状态、状态就近存、进行中记流水/任务/决策、收工留交接锚点。适合所有 AI 智能体的通用工作流。",
+  "version": "0.2.4",
+  "description": "跨会话/跨项目通用工作流标准：让任何 AI 智能体活过会话——开工读状态、状态就近存 .workflow、进行中记流水/任务/决策、收工留交接锚点。触发：开工/接手项目、续测、收工、跨会话、要落盘、多步开发、项目状态变化、跨智能体协作。所有 AI 智能体通用。",
   "license": "MIT",
   "keywords": [
     "agent-skills",