Skip to content

Commit e2e7282

Browse files
committed
refactor(cli): 移除 context pack 公开产品面
删除 context 公开子命令,收口 implementation-bridge 的默认输出为 happy path 直达 ce-work,并将项目记忆与团队知识的 change-scoped guidance 改成直接通过 memory/knowledge 入口获取。同步更新 README、workflow、 compatibility policy、skill 文案、版本号和回归测试。
1 parent 7442a59 commit e2e7282

32 files changed

Lines changed: 122 additions & 346 deletions

.agents/plugins/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "aisee-plugin",
3-
"version": "0.12.0",
3+
"version": "0.13.0",
44
"interface": {
55
"displayName": "Aisee Plugin",
66
"description": "Aisee plugin marketplace for OpenSpec, project memory, team knowledge, and Compound Engineering workflows."

CHANGELOG.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,14 @@
22

33
本项目遵循 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) 的结构,并使用 SemVer 管理版本。
44

5+
## [0.13.0] - 2026-06-14
6+
7+
### Changed
8+
9+
- 删除 `aisee context pack` 的公开 CLI 命令面;项目记忆与团队知识改为通过 `aisee memory search``aisee knowledge query` 直接提供 change-scoped guidance。
10+
- `aisee:implementation-bridge` 默认不再向用户展示 JSON 判定结果;ready 时直接交给 `ce-work`,只在异常或明确要求 handoff 时输出简短结果或 Brief。
11+
- README、workflow、best-practices、team knowledge 与 compatibility policy 同步移除 `context pack` 作为公开产品能力的默认叙事,统一收口到 “OpenSpec facts + memory/knowledge queries + bridge handoff rules”。
12+
513
## [0.12.0] - 2026-06-14
614

715
### Changed

README.en.md

Lines changed: 13 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -33,21 +33,21 @@
3333
3434
**Aisee** stands for **AI-Enhanced Software Engineering**.
3535

36-
Aisee Plugin is an AI software engineering plugin for OpenSpec workflows. It helps teams turn ambiguous ideas into reviewable requirements, UI content specifications, architecture context, OpenSpec changes, project memory, team knowledge guardrails, implementation-stage JSON decisions with optional handoff briefs, verification checks, and archive guardrails.
36+
Aisee Plugin is an AI software engineering plugin for OpenSpec workflows. It helps teams turn ambiguous ideas into reviewable requirements, UI content specifications, architecture context, OpenSpec changes, project memory, team knowledge guardrails, implementation handoffs, verification checks, and archive guardrails.
3737

3838
Aisee **does not replace OpenSpec**. OpenSpec remains the specification state machine and baseline source of truth. Aisee adds structured skills, project memory, team knowledge, JSON context tooling, and engineering handoff rules around OpenSpec.
3939

4040
It is especially relevant for maintainers who want Codex and other coding agents to work more reliably in open-source repositories:
4141

4242
- durable requirements and specifications instead of transient chat context;
43-
- machine-readable context packs and schema packs for implementation, review, and verification;
43+
- OpenSpec artifacts, schema packs, project memory, and team knowledge guardrails for implementation, review, and verification;
4444
- OpenSpec change planning that turns vague intent into reviewable deliverables;
45-
- machine-readable implementation-stage decisions with optional handoff briefs that help maintainers and contributors hand off PR-ready work;
45+
- explicit implementation handoffs and writeback rules that help maintainers and contributors hand off PR-ready work;
4646
- verification evidence and archive gates that close the loop before AI-assisted changes are treated as complete.
4747

4848
## OpenSpec Boundary
4949

50-
Aisee does not replace OpenSpec and does not maintain a second schema state machine. Aisee reads the current schema declaration only when handling OpenSpec changes, context packs, or schema pack checks; project memory and team knowledge remain guidance / guardrails.
50+
Aisee does not replace OpenSpec and does not maintain a second schema state machine. Aisee reads the current schema declaration only when handling OpenSpec changes or schema pack checks; project memory and team knowledge remain guidance / guardrails.
5151

5252
When Aisee handles OpenSpec artifacts, it acts only as a parser / checker / projector. `openspec validate` and `openspec archive` remain OpenSpec responsibilities.
5353

@@ -58,7 +58,7 @@ Codex can write, review, and fix code, but the results are less reliable when a
5858
Aisee supplies that workflow layer:
5959

6060
- it turns intent into durable OpenSpec changes, planning docs, and reusable project memory;
61-
- it helps maintainers first reduce implementation entry into reusable JSON decisions, and only turn them into human-readable handoff briefs when needed;
61+
- it helps maintainers reduce implementation entry into clear handoff rules, and only turn them into human-readable briefs when needed;
6262
- it lets Codex read against the same context boundaries across implementation, review, verification, and archive;
6363
- it gives open-source projects clearer engineering constraints for AI-assisted contribution flows.
6464

@@ -72,7 +72,7 @@ Aisee makes that context explicit:
7272
- separate requirements, UI content, architecture context, and change planning;
7373
- create and complete OpenSpec changes while reading required artifacts from the current schema;
7474
- keep OpenSpec as the only persistent specification source of truth;
75-
- generate machine-readable context packs for implementation, verification, and review;
75+
- expose durable project memory and team knowledge guardrails without replacing OpenSpec facts;
7676
- constrain document-local numbering through skills/templates to reduce invented or duplicated labels;
7777
- check whether artifacts, tasks, source maps, tests, and review evidence are closed before archive.
7878

@@ -102,7 +102,7 @@ OpenSpec
102102
Manage active changes, baseline specs, validate, apply, and archive
103103
104104
Aisee CLI
105-
Read OpenSpec/Aisee metadata and emit JSON context packs
105+
Read OpenSpec/Aisee metadata and provide project memory, team knowledge, and helper checks
106106
107107
Compound Engineering or another coding agent
108108
Implement, review, test, and produce evidence
@@ -154,10 +154,9 @@ On-demand extensions:
154154
- **Architecture context**: `aisee:architecture` records technical facts, constraints, reusable capabilities, global engineering conventions, and artifact hints.
155155
- **Schema-aware change planning**: `aisee:change-plan` maps confirmed inputs into independently deliverable OpenSpec changes.
156156
- **OpenSpec schema pack**: includes app, device, docsite, infra, security, quick-fix, quick-research, and collaboration schemas.
157-
- **Context packs**: `aisee context pack` provides optional project memory and team knowledge injection for the current change without replacing OpenSpec facts.
158157
- **Project memory**: `aisee memory` retrieves and writes current-repository long-lived guidance without replacing OpenSpec facts.
159158
- **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.
160-
- **Controlled memory injection**: `aisee context pack` injects `project_memory` or `knowledge` only when explicitly requested and does not own implementation-stage routing.
159+
- **Controlled memory and knowledge retrieval**: `aisee memory` and `aisee knowledge` provide direct retrieval entrypoints without owning implementation-stage routing.
161160
- **Verification and archive guardrails**: `aisee:verify` and `aisee:archive-guard` diagnose gaps and risks before archive.
162161
- **Harness design**: CLI contract tests and normalized skill eval cases keep the workflow stable.
163162

@@ -304,8 +303,8 @@ aisee doctor --json
304303

305304
- [Documentation site](https://aisee.wiki): Aisee guides, workflows, and release notes.
306305
- [Aisee Workflow](docs/workflow.en.md): end-to-end guidance from setup, requirement clarification, change authoring, implementation handoff, verification, and archive.
307-
- [Aisee Best Practices](docs/best-practices.en.md): conventions for sources of truth, schemas, contracts, context packs, reuse-first routing, review, and archive when using Aisee with OpenSpec.
308-
- [Compatibility Policy](docs/compatibility-policy.en.md): compatibility boundaries for CLI JSON, schema packs, context packs, plugin content, and experimental capabilities.
306+
- [Aisee Best Practices](docs/best-practices.en.md): conventions for sources of truth, schemas, contracts, reuse-first routing, review, and archive when using Aisee with OpenSpec.
307+
- [Compatibility Policy](docs/compatibility-policy.en.md): compatibility boundaries for CLI JSON, schema packs, plugin content, and experimental capabilities.
309308
- [Plugin Marketplace](docs/plugin-marketplace.en.md): responsibilities of plugin manifests, marketplace listings, PyPI/pipx, and the Codex install path.
310309
- [Team Knowledge Guardrails](docs/team-knowledge.en.md): experimental status, usage, and gaps before stability for shared team knowledge.
311310
- [Aisee Team Knowledge Architecture](docs/architecture/aisee-team-knowledge.md): team knowledge guardrail retrieval, card/pack boundaries, CLI onboarding, and read model.
@@ -411,10 +410,6 @@ aisee openspec ensure --json
411410
aisee plugin inspect --json
412411
aisee schemas list --json
413412
aisee schemas check --json
414-
aisee context pack --change <change> --for ce-work --project-memory --json
415-
aisee context pack --change <change> --for ce-work --knowledge --json
416-
aisee context pack --change <change> --for aisee-verify --project-memory --json
417-
aisee context pack --change <change> --for aisee-verify --knowledge --json
418413
aisee memory inspect --json
419414
aisee memory list --json
420415
aisee memory search --query "<task>" --json
@@ -439,7 +434,6 @@ Key CLI rules:
439434
- `aisee memory` manages current-repository project memory; `aisee/cache/memory-index.json` is a deletable rebuildable cache.
440435
- `aisee/cache/knowledge-index.json` is also a deletable and rebuildable cache; team knowledge persists in pinned pack/card files.
441436
- `aisee knowledge promote-batch` only writes the local team knowledge worktree; it does not commit, push, or create PRs.
442-
- OpenSpec artifacts and `source-map.md` are formal inputs for context packs.
443437
- `bootstrap --plan` is a read-only plan and does not perform broad initialization writes.
444438
- `aisee openspec ensure` installs or refreshes project-local OpenSpec instructions/skills and also aligns the global profile. It does not replace `aisee:init`.
445439
- `aisee knowledge query` returns only a small number of guardrails. By default it reads pack manifests and card frontmatter; `--debug` is required for matched card body excerpts.
@@ -456,7 +450,7 @@ aisee memory search --query "commit style" --json
456450
aisee memory search --query "test command" --type stack --include-body --json
457451
aisee memory add --type pref --title "Commit message language" --summary "Use Chinese commit messages by default." --body "Project commit messages should be Chinese and follow AGENTS.md." --source-ref AGENTS.md --priority high --json
458452
aisee memory update-index --json
459-
aisee context pack --change <change> --for ce-work --project-memory --json
453+
aisee memory search --query "current implementation task" --json
460454
```
461455

462456
Rules:
@@ -496,7 +490,6 @@ aisee knowledge install --json
496490
aisee knowledge update --json
497491
aisee knowledge query --phase implementation --surface cli --query "public CLI JSON" --json
498492
aisee knowledge query --from-change <change> --for ce-work --json
499-
aisee context pack --change <change> --for ce-work --knowledge --json
500493
aisee knowledge promote-batch --curation <path> --team-path ../aisee-team-knowledge --pack web-app --json
501494
```
502495

@@ -594,8 +587,8 @@ python scripts/smoke_release.py --with-pipx
594587

595588
### Ongoing Compatibility Governance
596589

597-
- Keep CLI JSON, project memory, team knowledge, context packs, marketplace plugin content, and skill contracts aligned with the Compatibility Policy; when a public contract changes, update tests, migration notes, and release notes together.
598-
- Use real-project dogfood to verify memory retrieval, context pack handoffs, and knowledge guardrails instead of expanding abstract flows just to cover schema types.
590+
- Keep CLI JSON, project memory, team knowledge, marketplace plugin content, and skill contracts aligned with the Compatibility Policy; when a public contract changes, update tests, migration notes, and release notes together.
591+
- Use real-project dogfood to verify memory retrieval, implementation handoffs, and knowledge guardrails instead of expanding abstract flows just to cover schema types.
599592

600593
### Later
601594

0 commit comments

Comments
 (0)