AISEE Plugin 是面向 OpenSpec 项目的 AI 软件工程插件。它提供一组 skills、schema packs、CLI 上下文工具和校验规则，用于在 OpenSpec change 生命周期内组织需求输入、UI 内容、技术上下文、实现交接和验证证据。

AISEE Plugin 不替代 OpenSpec。OpenSpec 仍然负责规范状态机、active changes、baseline specs、validate 和 archive。AISEE Plugin 的职责是在 OpenSpec 周围补充结构化输入、schema-aware authoring、机器可读 context pack、稳定 ID 追踪、契约读取和归档前检查。

状态与前提

项目	说明
当前状态	aisee-plugin 仓库标注为 early alpha；兼容治理仍在完善中。
运行前提	需要 Python 3.10+、Git、Node.js 和 OpenSpec CLI。
OpenSpec	需要单独安装；AISEE Plugin 不内置或替代 OpenSpec。
Compound Engineering	可作为实现、审查、测试消费方；不是使用 AISEE Plugin 的必需依赖。
本栏目范围	中文正文优先说明概念、边界和使用判断；英文页面暂保持稳定入口。

核心边界

对象	职责
OpenSpec	管理规范状态机、change artifacts、baseline specs、validate 和 archive。
AISEE Plugin	提供需求澄清、上下文整理、schema pack、context pack、ID 追踪、contract 读取和 verify / archive guard。
Aisee CLI	读取 OpenSpec 与 Aisee metadata，输出 JSON context view；这些输出不是第二份规范事实源。
Compound Engineering	可作为实现、审查、测试和知识沉淀的消费方；不是 AISEE Plugin 的必需依赖。

能力范围

能力	主要入口	说明
需求澄清	aisee:srs	将业务目标、范围、功能需求、非功能需求和验收标准整理为规划输入。
UI 内容规格	aisee:ui-content	描述页面内容、状态、操作、权限可见性和前端数据需求，不承担视觉设计职责。
技术上下文	aisee:architecture	记录技术事实、架构边界、平台约束、共享约定和风险。
Change 规划	aisee:change-plan	将已确认输入映射为可独立交付的 OpenSpec changes，并给出 schema 建议。
Change authoring	aisee:change-author	按目标 schema 的 artifact DAG 补齐当前 change 的文档。
Schema packs	aisee schemas install	提供 app、device、docsite、infra、security、quick-fix、quick-research、collaboration 等 schema。
Context packs	aisee context pack	为实现、验证和 review 生成面向目标的 JSON 上下文视图。
契约读取	aisee contract	以 manifest、summary、section 的方式暴露只读契约上下文，支持跨仓库协作。
团队知识	aisee knowledge、aisee:reflect、aisee:knowledge-curate	按需检索或整理经审查的工程经验；不作为规范事实源。
验证与归档检查	aisee:verify、aisee:archive-guard	检查 artifacts、tasks、source-map、测试和 review evidence 是否满足归档前要求。

推荐工作顺序

Aisee plugin

从输入整理到归档检查

Aisee Plugin 当前文档推荐先整理需求和上下文，再进入 OpenSpec change authoring，随后为实现、验证和归档提供目标化上下文与检查。

1

整理输入

把需求、页面内容和技术约束写成规划输入。

aisee:srs当前重点

整理业务目标、范围、功能需求、非功能需求和验收标准。

需求输入

ui-content / architecture当前重点

按需补充页面内容、交互状态、技术事实、约束和风险。

上下文输入

2

创建 Change

把已确认输入转换为 OpenSpec change。

aisee:change-plan说明

拆分可独立交付的 changes，并给出 schema 建议。

change 边界

aisee:change-author说明

按目标 schema 的 artifact DAG 补齐当前 change 文档。

artifact authoring

3

实现交接

为实现、审查和测试提供当前 change 的目标化上下文。

aisee context pack说明

读取 OpenSpec 与 Aisee metadata，输出 JSON context view。

context view

implementation / review / test风险

由 coding agent 或人工开发承接实现、审查和验证。

执行与证据

4

验证归档

在 archive 前检查 artifacts、tasks、evidence 和风险记录。

aisee:verify风险

检查当前 change 是否存在 artifact、contract、task 和 evidence 缺口。

verify report

aisee:archive-guard风险

归档前检查 validate、apply tracks、evidence 和 accepted risk。

archive gate

openspec archive已完成

由 OpenSpec 完成已验证 change 的归档。

baseline 更新

关系说明

• 依赖aisee:srs→aisee:change-plan已确认输入用于规划 change
• 下一步aisee:change-author→aisee context pack已 authored change 生成目标化上下文
• 验证implementation / review / test→aisee:verify实现和验证结果作为 evidence 进入检查
• 验证aisee:archive-guard→openspec archive通过归档检查后再执行 archive

当前重点说明风险已完成

这条顺序来自 Aisee Plugin 当前文档中的推荐流程。具体项目可以根据变更规模、schema 类型和风险面裁剪步骤；小型修复不需要展开完整 app schema。

使用约束

• SRS、UI Content、Design Spec 和 Architecture 是 change planning 的输入，不是 OpenSpec baseline。
• Context pack 是从当前 artifacts 派生的上下文视图，不应复制为长期规范文档。
• Contract service 提供只读契约上下文，不是 mock backend，也不是 API gateway。
• Team knowledge 只提供少量经审查的 guardrails，不能覆盖当前项目的 specs、changes 或人工决策。
• aisee:verify 和 aisee:archive-guard 只做检查与风险提示；最终归档仍由 openspec archive <change> 完成。

阅读顺序

页面	主题
从意图到 Change	前置输入如何进入 OpenSpec change。
Schema Packs 与 Authoring	schema 选择、artifact DAG 与 authoring 边界。
Context Packs 与 Contracts	context pack、contract service 和跨仓库读取方式。
Team Knowledge Guardrails	team knowledge 的检索、整理和写入边界。
Verify 与 Archive Guard	verify、archive guard、evidence 和 accepted risk。

贡献者: sincerly90

下一页从意图到 Change