@aipper/aiws-spec

本包存放 aiws 的规范与模板（单一真值来源，SSOT），供 @aipper/aiws CLI 读取并生成/更新目标仓库文件。

通常你只需要安装并使用 CLI：

npx @aipper/aiws init .

内容

• templates/workspace/：workspace 模板（真值文件、tool-native commands/skills、hooks、门禁脚本等）
• docs/spec-contract.md：模板契约（required/optional、managed markers、tool matrix、.aiws/manifest.json 约定）
• docs/cli-interface.md：CLI 行为语义（定义为主）
• docs/aiws-governance-positioning.md：aiws 作为工作流治理内核的定位、分层与边界
• docs/aiws-bootstrap-routing-design.md：bootstrap/router 与 Codex / Claude / OpenCode 目录对齐设计
• docs/superpowers-collaboration-adoption.md：吸收 superpowers 与协同模式的范围、非目标与分阶段路线
• docs/workflow-stage-contracts.md：核心 ws-* workflow 的人类可读阶段契约说明（由 JSON 真值生成）
• docs/workflow-stage-contracts.json：dashboard / API 共用的机器可读阶段契约真值
• docs/workflow-stage-contracts.schema.json：阶段契约 JSON 的结构约束
• docs/workflow-governance-rules.md：阶段推断规则的人类可读说明（由 JSON 真值生成）
• docs/workflow-governance-rules.json：change status/next/dashboard 共用的机器可读阶段推断规则（含 dual review / finish gate 缺口）
• docs/workflow-governance-rules.schema.json：阶段推断规则 JSON 的结构约束
• docs/workflow-router-rules.md：默认 bootstrap/router 的人类可读说明（由 JSON 真值生成）
• docs/workflow-router-rules.json：using-aiws / ws-router 共用的机器可读路由规则真值
• docs/workflow-router-rules.schema.json：router 规则 JSON 的结构约束
• docs/workflow-review-gates.md：双审查与完成前验证 gate 的人类可读说明（由 JSON 真值生成）
• docs/workflow-review-gates.json：ws-spec-review / ws-quality-review / ws-verify-before-complete 共用的机器可读 gate 真值
• docs/workflow-review-gates.schema.json：review gate JSON 的结构约束
• docs/workflow-delegation-contracts.md：原生多 agent 委托合同的人类可读说明（由 JSON 真值生成）
• docs/workflow-delegation-contracts.json：原生 delegation 的角色/边界/工件/降级策略真值
• docs/workflow-delegation-contracts.schema.json：delegation contract JSON 的结构约束
• docs/opencode-omo-adapter.md：OpenCode + oh-my-opencode 的适配边界、角色映射与 fallback 约定
• docs/opencode-omo-validation-checklist.md：OpenCode + oMo 的真实项目验收清单（探测、启用、损坏配置、fallback）
• templates/workspace/.opencode/oh-my-opencode.json.example：保守的项目级 oMo agent 建议配置（只覆盖 agents）
• docs/collaboration-artifacts.md：analysis/patches/review/evidence 的协同工件目录与生命周期约定