Merge branch 'feature/context-pack-memory-companion'

Author: sincerely90

.agents/plugins/marketplace.json

@@ -1,6 +1,6 @@
 {
   "name": "aisee-plugin",
-  "version": "0.11.3",
+  "version": "0.12.0",
   "interface": {
     "displayName": "Aisee Plugin",
     "description": "Aisee plugin marketplace for OpenSpec, project memory, team knowledge, and Compound Engineering workflows."

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 本项目遵循 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) 的结构，并使用 SemVer 管理版本。
 
+## [0.12.0] - 2026-06-14
+
+### Changed
+
+- `aisee context pack` 收缩为 current change 的 metadata scan + 可选 `project_memory` / `knowledge` 注入 companion，不再默认生成 `ce-work` / `aisee-verify` / review 的 target-specific execution projection。
+- `aisee:implementation-bridge` 改为默认直接读取当前 change artifacts，并只向 `ce-work` 输出“先读什么、完成后回写什么”的读取策略与 apply tracks / evidence 提醒；仅在显式需要时附带 memory / knowledge 注入。
+- `aisee:verify` 与 `aisee:archive-guard` 改为默认直接读取当前 change artifacts、schema 和 evidence，不再把 `context pack --for aisee-verify` 当作主路径。
+- README、workflow、best-practices、context pack contracts 与 CLI help 同步更新为 “OpenSpec facts + optional memory/knowledge companion” 语义。
+
 ## [0.11.3] - 2026-06-13
 
 ### Changed

README.en.md

@@ -154,10 +154,10 @@ On-demand extensions:
 - **Architecture context**: `aisee:architecture` records technical facts, constraints, reusable capabilities, global engineering conventions, and artifact hints.
 - **Schema-aware change planning**: `aisee:change-plan` maps confirmed inputs into independently deliverable OpenSpec changes.
 - **OpenSpec schema pack**: includes app, device, docsite, infra, security, quick-fix, quick-research, and collaboration schemas.
-- **Context packs**: `aisee context pack` generates JSON context for implementation, verification, and review.
+- **Context packs**: `aisee context pack` provides optional project memory and team knowledge injection for the current change without replacing OpenSpec facts.
 - **Project memory**: `aisee memory` retrieves and writes current-repository long-lived guidance without replacing OpenSpec facts.
 - **Team knowledge guardrails**: `aisee knowledge` retrieves a small number of reviewed engineering lessons through pack/card protocols without turning the knowledge repository into a second specification source.
-- **Lightweight context routing**: `aisee context pack` parses sources, local numbers, candidate paths, and evidence entries when `source-map.md` exists.
+- **Controlled memory injection**: `aisee context pack` injects `project_memory` or `knowledge` only when explicitly requested and does not own implementation-stage routing.
 - **Verification and archive guardrails**: `aisee:verify` and `aisee:archive-guard` diagnose gaps and risks before archive.
 - **Harness design**: CLI contract tests and normalized skill eval cases keep the workflow stable.
 
@@ -411,10 +411,10 @@ aisee openspec ensure --json
 aisee plugin inspect --json
 aisee schemas list --json
 aisee schemas check --json
-aisee context pack --change <change> --for ce-work --json
 aisee context pack --change <change> --for ce-work --project-memory --json
 aisee context pack --change <change> --for ce-work --knowledge --json
-aisee context pack --change <change> --for aisee-verify --json
+aisee context pack --change <change> --for aisee-verify --project-memory --json
+aisee context pack --change <change> --for aisee-verify --knowledge --json
 aisee memory inspect --json
 aisee memory list --json
 aisee memory search --query "<task>" --json

README.md

@@ -154,11 +154,11 @@ Compound Engineering = 可选的执行 / 审查 / 测试消费方
 - **技术架构上下文**：`aisee:architecture` 记录技术事实、约束、可复用能力、全局工程约定和 artifact hints。
 - **Schema-aware change planning**：`aisee:change-plan` 将已确认输入映射为可独立交付的 OpenSpec changes。
 - **OpenSpec schema pack**：提供 app、device、docsite、infra、security、quick-fix、quick-research、collaboration 等 schema。
-- **Context packs**：`aisee context pack` 为实现、验证和 review 生成 JSON 上下文。
+- **Context packs**：`aisee context pack` 为当前 change 提供可选的项目记忆与团队知识注入，不替代 OpenSpec facts。
 - **轻量 schema 兼容**：`aisee context pack` 与 `aisee:implementation-bridge` 可直接消费 OpenSpec 官方 `spec-driven` 及其它轻量 schema；不会因为缺少 Aisee 专属增强字段而拒绝生成 bridge 上下文。
 - **项目记忆**：`aisee memory` 受控检索和写入当前仓库长期 guidance，不替代 OpenSpec 事实源。
 - **团队知识 Guardrails**：`aisee knowledge` 基于 pack/card 协议按需检索少量已审查工程经验，不把知识库变成第二份规范事实源。
-- **轻量上下文路由**：`aisee context pack` 在 `source-map.md` 存在时解析来源、编号、候选路径和 evidence 入口。
+- **受控记忆注入**：`aisee context pack` 只在显式启用时注入 `project_memory` 或 `knowledge`，不承担实现阶段执行路由。
 - **验证与归档门禁**：`aisee:verify` 和 `aisee:archive-guard` 在 archive 前诊断缺口和风险。
 - **Harness 设计**：通过 CLI contract tests 和规范化 skill eval cases 保持工作流稳定。
 
@@ -411,10 +411,10 @@ aisee openspec ensure --json
 aisee plugin inspect --json
 aisee schemas list --json
 aisee schemas check --json
-aisee context pack --change <change> --for ce-work --json
 aisee context pack --change <change> --for ce-work --project-memory --json
 aisee context pack --change <change> --for ce-work --knowledge --json
-aisee context pack --change <change> --for aisee-verify --json
+aisee context pack --change <change> --for aisee-verify --project-memory --json
+aisee context pack --change <change> --for aisee-verify --knowledge --json
 aisee memory inspect --json
 aisee memory list --json
 aisee memory search --query "<task>" --json

docs/best-practices.en.md

@@ -141,12 +141,11 @@ Use `source-map.md` and context pack's rebuildable scan view as context entries;
 
 ## 8. Context Pack Is A Read Entry, Not A New Document
 
-`aisee context pack` gives AI a small and targeted context:
+`aisee context pack` is useful when you explicitly want to inject a small amount of project memory or team knowledge:
 
 ```bash
-aisee context pack --change <change> --for ce-work --json
-aisee context pack --change <change> --for aisee-verify --json
-aisee context pack --change <change> --for ce-code-review --json
+aisee context pack --change <change> --for ce-work --project-memory --json
+aisee context pack --change <change> --for ce-work --knowledge --json
 ```
 
 Rules:
@@ -161,10 +160,9 @@ Rules:
 Before creating tasks, entering implementation, proposing reviewer lenses, or recommending a next step, check existing workflows and skills first:
 
 - When there is no explicit change, return to requirements clarification, change-plan, or the current change itself rather than relying on a dedicated flow command.
-- When there is an explicit change, read the target context pack first, such as `aisee context pack --change <change> --for ce-work --json`.
-- `reusable_workflow_candidates` in the `ce-work` context pack is a routing hint only, not a source of truth.
-- Use `ce-plan` only when `requires_ce_plan=true`; its conclusions must be written back to the current schema apply tracks, and only source-map schemas write back to `source-map.md`.
-- When `requires_ce_plan=false` and paths/tasks are clear, prefer `aisee:implementation-bridge -> ce-work`.
+- When there is an explicit change, read the current change artifacts, schema, `tasks.md`, `source-map.md` when applicable, and evidence entrypoints directly.
+- Only read `aisee context pack --change <change> --for ce-work --project-memory --json` or `--knowledge --json` when you explicitly need that optional guidance.
+- `aisee:implementation-bridge` should tell `ce-work` what to read first and how to write back `tasks.md` / apply tracks and evidence after implementation.
 - Do not create execution, code-review, or test agents that overlap with CE responsibilities.
 
 Interface, UI, hardware, firmware, security, and verification differences should remain schema-aware check lenses. When Aisee reviewers are needed, use only the read-only consistency roles `aisee-change-architect`, `aisee-spec-reviewer`, and `aisee-implementation-reviewer`.

docs/best-practices.md

@@ -141,12 +141,11 @@ data-model.md
 
 ## 8. Context pack 是读取入口，不是新文档
 
-`aisee context pack` 适合给 AI 提供小而准的上下文：
+`aisee context pack` 适合在显式需要时给 AI 注入小而准的项目记忆或团队知识：
 
 ```bash
-aisee context pack --change <change> --for ce-work --json
-aisee context pack --change <change> --for aisee-verify --json
-aisee context pack --change <change> --for ce-code-review --json
+aisee context pack --change <change> --for ce-work --project-memory --json
+aisee context pack --change <change> --for ce-work --knowledge --json
 ```
 
 使用规则：
@@ -161,10 +160,9 @@ aisee context pack --change <change> --for ce-code-review --json
 创建任务、进入实现、提出审查角色或推荐下一步前，先检查已有 workflow 和 skill：
 
 - 无明确 change 时，先回到需求澄清、change-plan 或当前 change 本身。
-- 有明确 change 时，优先读取目标 context pack，例如 `aisee context pack --change <change> --for ce-work --json`。
-- `ce-work` context pack 的 `reusable_workflow_candidates` 只是路由提示，不是事实源。
-- `requires_ce_plan=true` 时才按需使用 `ce-plan` 细化执行顺序；结论必须回写当前 schema apply tracks，只有 source-map schema 才回写 `source-map.md`。
-- `requires_ce_plan=false` 且 paths/tasks 清楚时，优先 `aisee:implementation-bridge -> ce-work`。
+- 有明确 change 时，默认直接读取当前 change artifacts、schema、`tasks.md`、`source-map.md`（若适用）和 evidence 入口。
+- 只有明确需要项目记忆或团队知识时，才额外读取 `aisee context pack --change <change> --for ce-work --project-memory --json` 或 `--knowledge --json`。
+- `aisee:implementation-bridge` 只负责提示 `ce-work` 先读什么，以及完成后如何回写 `tasks.md` / apply tracks 和 evidence。
 - 不创建与 CE 重叠的执行、代码审查或测试 agent。
 
 接口、UI、硬件、固件、安全和验证差异应作为 schema-aware check lenses。需要 Aisee reviewer 时，只使用 `aisee-change-architect`、`aisee-spec-reviewer`、`aisee-implementation-reviewer` 这三个只读一致性审查 role。

docs/compatibility-policy.en.md

@@ -80,6 +80,7 @@ Rules:
 - `facts.derived` represents CLI-derived views;
 - `knowledge.matches` is optional guardrail output and must not pollute `facts.parsed` or `facts.derived`;
 - `project_memory.matches` appears only with explicit `--project-memory` and must not pollute `facts.parsed` or `facts.derived`;
+- `--for <target>` only scopes optional injection retrieval and no longer promises target-specific execution / verify / review projections;
 - context packs may grow, but default output must stay bounded;
 - new targets must document consumer, read order, and missing-field behavior.
 

docs/compatibility-policy.md

@@ -80,6 +80,7 @@
 - `facts.derived` 表示 CLI 派生视图；
 - `knowledge.matches` 是可选 guardrails，不得污染 `facts.parsed` 或 `facts.derived`；
 - `project_memory.matches` 只在显式 `--project-memory` 时出现，不得污染 `facts.parsed` 或 `facts.derived`；
+- `--for <target>` 只限定可选注入层的检索边界，不再承诺 execution / verify / review 的 target-specific 投影；
 - context pack 可以变大，但默认输出必须保持可控；
 - 新 target 必须说明消费方、读取顺序和缺失字段处理方式。