@aipper/aiws-spec 0.0.32 → 0.0.34

package/templates/workspace/.claude/skills/ws-preflight/SKILL.md

@@ -1,55 +0,0 @@
----
-name: ws-preflight
-description: 预检（提交前快速检查与建议）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在开始任何“写代码/改配置/落盘文件”之前，对齐工作区真值文件，避免规则漂移。
-
-阶段定位：
-- workflow 入口阶段；负责判断当前仓库是否具备继续执行其它 `ws-*` 阶段的前置条件。
-
-必需输入：
-- 当前项目根目录候选路径
-- `AI_PROJECT.md`
-- `REQUIREMENTS.md`
-- `AI_WORKSPACE.md`
-
-必需输出：
-- `Root:` 当前项目根
-- `Found:` 实际读取到的真值文件
-- `Missing:` 缺失项
-- `Key rules:` 3-8 条约束摘要
-- `Next:` 若真值齐全，建议进入 `$ws-plan` 或 `$ws-dev`；若缺失，建议先 `aiws init .`
-
-阻断条件：
-- 无法确定项目根目录
-- 缺失任一真值文件
-
-完成判定：
-- 使用者已经知道当前仓库能否继续进入后续阶段，以及必须遵守的约束与下一步入口。
-
-执行步骤（强制）：
-1) 定位项目根目录：
-   - 优先：`git rev-parse --show-toplevel`
-   - 若失败：停止并让用户确认当前目录是否为项目根（不要猜测）。
-2) 在项目根目录读取以下文件（存在则必须读取；缺失则明确报告缺失项，不要臆测内容）：
-   - `AI_PROJECT.md`
-   - `REQUIREMENTS.md`
-   - `AI_WORKSPACE.md`
-3) 若缺失任意真值文件：不要继续“写代码/改配置/落盘文件”。先输出缺失项，并给出下一步建议：
-   - `npx @aipper/aiws init .`（或 `aiws init .`）初始化真值文件
-   - 然后重新执行 `$ws-preflight`
-4) 输出：
-   - `Root:` <项目根路径>
-   - `Found:` <实际读取到的文件列表>
-   - `Missing:` <缺失文件列表>
-   - `Key rules:` 3–8 条 bullet（范围/禁止项/必须产物/必须验证命令）
-5) 若存在 `.gitmodules`：
-   - 输出 submodule 列表：`git config --file .gitmodules --get-regexp '^submodule\\..*\\.path$'`
-   - 检查每个 submodule 是否配置 `submodule.<name>.branch`（缺失则提示先运行 `$ws-submodule-setup`；否则 `aiws validate .` 会失败）
-
-安全：
-- 不打印 secrets；遇到疑似敏感值只提示“存在风险”但不要复述原文。
-- 不执行破坏性命令。

package/templates/workspace/.claude/skills/ws-pull/SKILL.md

@@ -1,18 +0,0 @@
----
-name: ws-pull
-description: `aiws pull` 的薄包装入口
----
-
-# ws-pull
-
-`aiws pull` 的薄包装入口。
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws pull
-elif command -v aiws >/dev/null 2>&1; then
-  aiws pull
-else
-  npx @aipper/aiws pull
-fi
-```

package/templates/workspace/.claude/skills/ws-push/SKILL.md

@@ -1,18 +0,0 @@
----
-name: ws-push
-description: `aiws push` 的薄包装入口
----
-
-# ws-push
-
-`aiws push` 的薄包装入口。
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws push
-elif command -v aiws >/dev/null 2>&1; then
-  aiws push
-else
-  npx @aipper/aiws push
-fi
-```

package/templates/workspace/.claude/skills/ws-quality-review/SKILL.md

@@ -1,56 +0,0 @@
----
-name: ws-quality-review
-description: 质量审查（行为回归 / 测试覆盖 / 实现质量）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：
-- 审查当前改动的行为正确性、边界条件、测试覆盖和实现质量
-- 把“代码/行为层 findings”优先落盘到 `changes/<change-id>/review/quality-review.md`
-
-阶段定位：
-- review 子 gate；负责实现质量、行为回归与验证覆盖审查。
-
-必需输入：
-- 当前 `git diff`
-- 已执行的验证结果
-- 相关代码 / 配置 / 测试文件
-- 若存在：`changes/<change-id>/analysis/`、`patches/`、已有 review 文件
-
-必需输出：
-- `证据（Evidence）:` `changes/<change-id>/review/quality-review.md` 或回退 `.agentdocs/tmp/review/quality-review.md`
-- `主要发现（Findings）:` 高到低排序的问题 / 风险 / 缺失测试
-- `下一步（Next）:` 最小修复项与回归命令
-
-阻断条件：
-- 没有可审改动
-- 没有任何验证上下文
-- 无法写 review 证据
-
-完成判定：
-- 已落盘 quality review 证据，且 findings / 测试缺口 / next 明确。
-
-步骤（建议）：
-1) 先读取 `git diff`、验证结果与相关代码。
-2) 检查：
-   - 行为是否可能回归
-   - 边界条件 / 失败路径是否覆盖
-   - 测试是否足以支撑改动
-   - 是否存在明显复杂度、耦合、可维护性或性能问题
-3) 将结论落盘到：
-   - 默认：`changes/<change-id>/review/quality-review.md`
-   - 回退：`.agentdocs/tmp/review/quality-review.md`
-4) 输出：
-   - `证据（Evidence）:`
-   - `主要发现（Findings）:`
-   - `测试缺口（Gaps）:`
-   - `下一步（Next）:`
-
-重点：
-- 这是质量 / 回归 review，不替代 requirements / gate review。
-- 若发现流程、归因、evidence 缺口，转交给 `$ws-spec-review`。
-
-安全：
-- 不打印 secrets。
-- 不执行破坏性命令。

package/templates/workspace/.claude/skills/ws-req-change/SKILL.md

@@ -1,41 +0,0 @@
----
-name: ws-req-change
-description: 需求变更（更新 REQUIREMENTS 并同步执行合同）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：记录需求变更（更新 `REQUIREMENTS.md` + 追加 `requirements/CHANGELOG.md`），并同步/校验执行合同 `requirements/requirements-issues.csv`。
-
-步骤（必须按顺序）：
-1) 读取：`AI_PROJECT.md`、`REQUIREMENTS.md`、`AI_WORKSPACE.md`、`requirements/CHANGELOG.md`（缺失则创建目录与文件）。
-2) 先产出“拟变更方案”（不要立刻写文件）：
-   - 变更摘要（1–5 条）
-   - 影响范围（API/鉴权/字段/状态码/测试边界）
-   - 回滚思路（1–2 条）
-3) 对比与冲突检查（强制，不写文件）：
-   - 对比“变更前 vs 拟变更后”的差异清单（新增/删除/语义变化）
-   - 整理潜在冲突/不确定点（只列“最可能影响验收/实现”的，避免噪音）
-4) 逐条澄清（强制，避免一次问完）：
-   - 若存在潜在冲突/不确定点：**本轮只问 1 个**最高优先级问题（给出 2–4 个可选答案或二选一），然后停止，等待用户回复；不要继续问下一题，也不要写文件。
-   - 收到用户回复后：更新“拟变更方案”，回到步骤 3) 重新对比，直至没有未决问题。
-5) 强制停下来让用户确认：是否继续落盘？(Y/N)
-6) 用户确认 Y 后再写入：
-   - 更新 `REQUIREMENTS.md`（只保留当前有效版本，不在此堆历史）
-   - 追加 `requirements/CHANGELOG.md`
-7) 同步/补齐需求执行合同（强制，自动处理 FlowSpec 有/无两种情况）：
-   - `python3 tools/requirements_contract_sync.py --workspace .`
-   - 说明：若 `REQUIREMENTS.md` 中不存在 FlowSpec（或 flows 为空），该命令只会确保 `requirements/requirements-issues.csv` 表头存在并给出 WARN（这是预期行为，不要当成失败）。
-8) 校验需求执行合同（强制）：`python3 tools/requirements_contract.py validate`
-9) 同步场景合同（可选，但若存在 FlowSpec 则强烈建议自动执行）：
-   - 若 `REQUIREMENTS.md` 同时包含 `<!-- FLOW_SPEC_BEGIN -->` 与 `<!-- FLOW_SPEC_END -->`：运行 `$ws-req-flow-sync`
-   - 否则：跳过，并提示用户“可以先不维护 FlowSpec；后续需要场景回归时再补”
-
-输出必须包含：
-- 本次更新的文件清单（路径）
-- 回滚方案（如何撤销本次需求变更）
-- 下一步建议命令
-
-安全：
-- 不打印 `secrets/test-accounts.json`
-- 不引入任何 token/密钥到仓库

package/templates/workspace/.claude/skills/ws-req-contract-sync/SKILL.md

@@ -1,17 +0,0 @@
----
-name: ws-req-contract-sync
-description: 合同同步（requirements contract sync）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-用途：从 `REQUIREMENTS.md` 的 FlowSpec 补齐 `requirements/requirements-issues.csv`（只生成骨架，不猜测完成状态）。
-
-执行（在 workspace 根目录）：
-- `python3 tools/requirements_contract_sync.py --workspace .`
-
-输出要求：
-- 说明新增/更新了多少条
-- 明确下一步：手工补齐 CRUD/Inputs/Outputs/Business_Logic/Tests，并将可开工条目标为 `Spec_Status=READY`
-
-下一步建议：`$ws-req-contract-validate`

package/templates/workspace/.claude/skills/ws-req-contract-validate/SKILL.md

@@ -1,12 +0,0 @@
----
-name: ws-req-contract-validate
-description: 合同校验（requirements contract validate）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-执行（失败则修正 CSV 后重试）：
-- `python3 tools/requirements_contract.py validate`
-
-输出要求：
-- 若失败：列出前 20 条缺失字段（Req_ID + field），并给出最小补齐建议

package/templates/workspace/.claude/skills/ws-req-flow-sync/SKILL.md

@@ -1,28 +0,0 @@
----
-name: ws-req-flow-sync
-description: Flow 同步（生成 api-flow 与场景执行合同）
----
-
-用中文输出；命令与路径保持原样不翻译。
-
-目标：基于 `REQUIREMENTS.md` 的 FlowSpec 生成：
-- `docs/api-flow.mmd`（简短逻辑图，Mermaid）
-- `issues/server-scenario-issues.csv`（场景执行合同：TODO/DONE/BLOCKED）
-
-执行（在 workspace 根目录）：
-`python3 tools/requirements_flow_gen.py --workspace .`
-
-若缺少工具 `tools/requirements_flow_gen.py`：提示用户先运行 `$aiws-init`（默认会安装 optional tools），或执行：
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws init .
-elif command -v aiws >/dev/null 2>&1; then
-  aiws init .
-else
-  npx @aipper/aiws init .
-fi
-```
-
-输出要求：只打印生成的文件路径与下一步命令：
-- 查看逻辑图：`cat docs/api-flow.mmd`
-- 查看场景合同：`cat issues/server-scenario-issues.csv`

package/templates/workspace/.claude/skills/ws-req-review/SKILL.md

@@ -1,32 +0,0 @@
----
-name: ws-req-review
-description: 需求评审（对齐真值与验收）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在不修改任何文件的前提下，对 `REQUIREMENTS.md` 做一次整体 QA，输出缺口/冲突/风险，减少实现漂移。
-
-执行步骤（强制）：
-1) 定位项目根目录：`git rev-parse --show-toplevel`（失败则停止并让用户确认根目录）。
-2) 读取（存在则必须读取；缺失则明确列出，不要臆测）：
-   - `AI_PROJECT.md`
-   - `REQUIREMENTS.md`
-   - `AI_WORKSPACE.md`
-   - `requirements/CHANGELOG.md`（若存在）
-   - `requirements/requirements-issues.csv`（若存在）
-3) 输出固定结构的报告：
-
-## Requirements QA
-- 结论：是否可进入实现（是/否/有条件）
-- 漂移风险：最容易导致不一致的点
-- 可验收性缺口：缺少输入/输出/错误码/边界/示例的条目
-- 完整性：Non-goals/兼容性/鉴权/重试/并发/观测性/性能
-- 一致性：与 `AI_PROJECT.md` 约束冲突点
-- 可测试性与证据：最小验证命令 + 期望结果 + 证据路径
-- 风险清单：3–8 条
-- 需要澄清的问题：5–12 个（按优先级）
-
-4) 最后询问用户：是否进入需求落盘流程 `$ws-req-change`？(Y/N)
-
-安全：不打印 `secrets/test-accounts.json`。

package/templates/workspace/.claude/skills/ws-review/SKILL.md

@@ -1,55 +0,0 @@
----
-name: ws-review
-description: 评审（提交前审计与证据落盘）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在提交/交付前审计当前改动，对照真值文件检查是否越界，并把审计证据优先落盘到 `changes/<change-id>/review/`（若无法确定 `change-id` 再回退 `.agentdocs/tmp/review/`）。
-若当前语境已经明确是“准备交付/finish”，则本入口不应只停留在通用 review：应继续同时补齐 `$ws-spec-review` 与 `$ws-quality-review`，把 dual review gate 一次性收敛完。
-
-阶段定位：
-- review 阶段；负责对当前改动做规范、风险和验证完整性的审计。
-
-必需输入：
-- 当前 `git status` / `git diff`
-- 已执行的验证结果
-- 真值文件：`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
-- 当前 `change/<change-id>` 上下文（若能识别）
-- 若存在：`changes/<change-id>/analysis/`、`patches/`、已有 `review/` 文件
-
-必需输出：
-- 审计文件：`changes/<change-id>/review/codex-review.md` 或回退 `.agentdocs/tmp/review/codex-review.md`
-- `主要风险（Top risks）:` 3-8 条
-- `下一步（Next）:` 最小修复清单 + 最小验证命令
-
-阻断条件：
-- 没有可审计的改动或验证上下文
-- 审计证据无法写盘
-
-完成判定：
-- 审计证据已落盘，主要风险和下一步已明确，可作为 commit/deliver 前置输入。
-
-步骤（建议）：
-1) 先做 preflight：定位项目根目录，读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`，输出约束摘要。
-2) 基于 `git status` / `git diff`（以及你实际运行过的测试结果），对照 `AI_PROJECT.md` 与 `REQUIREMENTS.md` 检查：
-   - 是否存在越界目录改动/危险操作
-   - 是否有可复现验证命令与证据
-   - 是否维护了 `changes/<change-id>/` 或相关 `issues/*.csv`
-   - 若存在 `analysis/` / `patches/`：审查这些委托工件是否已被主 agent 理解、是否需要采用/拒绝，并把结论写入 review 文件
-3) 将审计落盘到（目录不存在则创建）：
-   - 默认：`changes/<change-id>/review/codex-review.md`
-   - 回退：`.agentdocs/tmp/review/codex-review.md`（仅在无法确定 `change-id` 时使用）
-   - 若已有其它 reviewer 文件：不要覆盖它们；当前 reviewer 应写自己的文件或更新自己的汇总文件
-4) 若当前任务已进入“准备提交/交付/finish”的语境，继续补齐 dual review gate：
-   - 运行/收敛 `$ws-spec-review`，落盘 `changes/<change-id>/review/spec-review.md`（或回退 `.agentdocs/tmp/review/spec-review.md`）
-   - 运行/收敛 `$ws-quality-review`，落盘 `changes/<change-id>/review/quality-review.md`（或回退 `.agentdocs/tmp/review/quality-review.md`）
-   - 不要把单个 `codex-review.md` 误当成 finish gate 已完成
-5) 回复中输出：
-   - `证据（Evidence）:` 证据文件路径
-   - `主要风险（Top risks）:` 3–8 条（高→低）
-   - `下一步（Next）:` 最小修复清单 + 最小验证命令
-
-安全：
-- 不打印 secrets。
-- 不执行破坏性命令。

package/templates/workspace/.claude/skills/ws-rule/SKILL.md

@@ -1,23 +0,0 @@
----
-name: ws-rule
-description: 规则（解释项目规则与边界）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：把用户口述的“项目特有规则”整理成可执行条款，并写入 `AI_PROJECT.md` 的 `AI_PROJECT_RULES_BEGIN/END` 段（托管块外内容会被保留）。
-
-安全规则（强制）：
-- 不打印/不写入 secrets（token、密钥、内网地址、账号密码）。
-- 不执行破坏性命令。
-
-工作流：
-1) 先做 preflight；若缺失 `AI_PROJECT.md`：提示用户先 `$ws-migrate`（或 `$aiws-init`）。
-2) 写入前创建备份（必须）：
-`ts="$(date +%Y%m%d-%H%M%S)"; mkdir -p .aiws/backups/manual; cp -a AI_PROJECT.md .aiws/backups/manual/AI_PROJECT.md.bak.${ts}`
-3) 先输出“将写入的规则清单”（3–12 条），并要求用户回复 `CONFIRM` 后再落盘。
-4) 用户确认后，**仅更新** BEGIN/END 段内内容（合并去重；写成可检查条款：目录白名单/必须验证命令/禁止项/产物要求）。
-5) 输出必须包含：
-   - 更新了哪些文件（路径）
-   - 回滚方式（恢复备份文件）
-   - 下一步建议：`$aiws-validate`

package/templates/workspace/.claude/skills/ws-spec-review/SKILL.md

@@ -1,57 +0,0 @@
----
-name: ws-spec-review
-description: 规范审查（requirements / plan / evidence / gate 完整性）
----
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：
-- 审查当前改动是否满足真值文件、change 绑定、证据路径和 gate 完整性要求
-- 把“流程/规范层 blocker”与“代码层问题”区分开，优先落盘到 `changes/<change-id>/review/spec-review.md`
-
-阶段定位：
-- review 子 gate；负责 requirements / plan / evidence / workflow gate 完整性审查。
-
-必需输入：
-- `AI_PROJECT.md`
-- `REQUIREMENTS.md`
-- `AI_WORKSPACE.md`
-- 当前 `git diff`
-- 若存在：`plan/...`、`changes/<change-id>/proposal.md`、`tasks.md`、`review/`、`evidence/`
-
-必需输出：
-- `证据（Evidence）:` `changes/<change-id>/review/spec-review.md` 或回退 `.agentdocs/tmp/review/spec-review.md`
-- `阻断项（Blockers）:` requirements 归因 / gate / evidence 缺口
-- `下一步（Next）:` 修复项与最小验证命令
-
-阻断条件：
-- 无法定位项目根或真值文件
-- 无法判断当前 change / 归因上下文
-- 无法写 review 证据
-
-完成判定：
-- 已落盘 spec review 证据，且明确指出 blocker / warning / next。
-
-步骤（建议）：
-1) 先运行 `$ws-preflight`。
-2) 对照 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 检查：
-   - 当前改动能否归因到 `Req_ID` / `Problem_ID`
-   - `plan/...`、`proposal.md`、`tasks.md`、`evidence/` 是否与改动保持一致
-   - 是否存在越界目录改动、危险操作、未声明的非目标扩张
-   - 是否已经准备好可复现验证入口
-3) 把结论落盘到：
-   - 默认：`changes/<change-id>/review/spec-review.md`
-   - 回退：`.agentdocs/tmp/review/spec-review.md`
-4) 输出：
-   - `证据（Evidence）:`
-   - `阻断项（Blockers）:`
-   - `警告（Warnings）:`
-   - `下一步（Next）:`
-
-重点：
-- 这是 spec / gate review，不是代码质量 review。
-- 若发现实现质量或回归问题，转交给 `$ws-quality-review`。
-
-安全：
-- 不打印 secrets。
-- 不执行破坏性命令。

package/templates/workspace/.claude/skills/ws-submodule-setup/SKILL.md

@@ -1,18 +0,0 @@
----
-name: ws-submodule-setup
-description: `aiws submodule-setup` 的薄包装入口
----
-
-# ws-submodule-setup
-
-`aiws submodule-setup` 的薄包装入口。
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws submodule-setup
-elif command -v aiws >/dev/null 2>&1; then
-  aiws submodule-setup
-else
-  npx @aipper/aiws submodule-setup
-fi
-```

package/templates/workspace/.claude/skills/ws-verify-before-complete/SKILL.md

@@ -1,18 +0,0 @@
----
-name: ws-verify-before-complete
-description: `aiws verify-bc` 的薄包装入口
----
-
-# ws-verify-before-complete
-
-`aiws verify-bc` 的薄包装入口。
-
-```bash
-if [[ -x "./node_modules/.bin/aiws" ]]; then
-  ./node_modules/.bin/aiws verify-bc
-elif command -v aiws >/dev/null 2>&1; then
-  aiws verify-bc
-else
-  npx @aipper/aiws verify-bc
-fi
-```

package/templates/workspace/.codex/prompts/aiws-init.md

@@ -1,23 +0,0 @@
----
-description: 初始化工作区（生成真值文件与门禁）
-argument-hint: ""
----
-
-<!-- AIWS_MANAGED_BEGIN:codex:aiws-init -->
-# aiws init
-
-目标：
-- 生成/补齐真值文件与门禁文件（以 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 为准）
-- 写入/更新 `.gitignore` 的 aiws 托管块
-- 生成/更新 `.aiws/manifest.json`（用于漂移检测）
-
-建议执行：
-1) `npx @aipper/aiws init`
-2) `npx @aipper/aiws validate`
-
-约束：
-- 不写入任何 secrets
-- 只允许更新托管块（`AIWS_MANAGED_BEGIN/END`）或 spec 指定的 `replace_file` 文件
-<!-- AIWS_MANAGED_END:codex:aiws-init -->
-
-可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.codex/prompts/aiws-rollback.md

@@ -1,16 +0,0 @@
----
-description: 回滚工作区（从备份恢复）
-argument-hint: ""
----
-
-<!-- AIWS_MANAGED_BEGIN:codex:aiws-rollback -->
-# aiws rollback
-
-目标：
-- 从 `.aiws/backups/` 恢复到某次备份快照
-
-建议执行：
-- `npx @aipper/aiws rollback latest`
-<!-- AIWS_MANAGED_END:codex:aiws-rollback -->
-
-可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.codex/prompts/aiws-update.md

@@ -1,22 +0,0 @@
----
-description: 更新工作区（刷新模板与托管块）
-argument-hint: ""
----
-
-<!-- AIWS_MANAGED_BEGIN:codex:aiws-update -->
-# aiws update
-
-目标：
-- 基于当前 `@aipper/aiws-spec` 刷新模板与 tool-native 文件
-- 更新前备份到 `.aiws/backups/<timestamp>/`
-
-建议执行：
-1) `npx @aipper/aiws update`
-2) `npx @aipper/aiws validate`
-
-约束：
-- 不写入任何 secrets
-- 只更新托管块或 spec 指定的 `replace_file` 文件
-<!-- AIWS_MANAGED_END:codex:aiws-update -->
-
-可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.codex/prompts/aiws-validate.md

@@ -1,17 +0,0 @@
----
-description: 校验工作区（漂移检测 + 门禁）
-argument-hint: ""
----
-
-<!-- AIWS_MANAGED_BEGIN:codex:aiws-validate -->
-# aiws validate
-
-目标：
-- 作为 CI/本地门禁：校验 required 文件结构、托管块、`.aiws/manifest.json` 漂移
-- 强门禁：缺 `python3`/缺 required 脚本也应失败
-
-建议执行：
-- `npx @aipper/aiws validate`
-<!-- AIWS_MANAGED_END:codex:aiws-validate -->
-
-可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.codex/prompts/ws-analyze.md

@@ -1,32 +0,0 @@
----
-description: 分析（定位问题与收集上下文）
-argument-hint: ""
----
-
-<!-- AIWS_MANAGED_BEGIN:codex:ws-analyze -->
-# ws analyze
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在开始实现/修复前做一次技术分析，产出可执行的最小行动清单，并把证据落盘到 `.agentdocs/tmp/analyze/`。
-
-输入：
-- 主题/需求：`$ARGUMENTS`（若为空，先问用户一句“本次分析主题是什么？”）
-
-步骤（建议）：
-1) 先运行 `/ws-preflight`。
-2) 基于真值文件与当前代码现状，输出：
-   - 目标 / 非目标
-   - 现状证据（文件路径/接口路径）
-   - 推荐方案（1 个）+ 备选（可选）
-   - 风险与回滚（3–8 条）
-   - 最小验证命令（可复现）
-3) 将分析落盘到：`.agentdocs/tmp/analyze/codex-analysis.md`（目录不存在则创建）。
-4) 回复中必须包含：`Evidence:` 证据文件路径。
-
-安全：
-- 不打印 secrets（尤其 `secrets/test-accounts.json`）。
-- 不执行破坏性命令。
-<!-- AIWS_MANAGED_END:codex:ws-analyze -->
-
-可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.codex/prompts/ws-dev.md

@@ -1,36 +0,0 @@
----
-description: 开发（按需求实现并验证）
-argument-hint: ""
----
-
-<!-- AIWS_MANAGED_BEGIN:codex:ws-dev -->
-# ws dev
-
-用中文输出（命令/路径/代码标识符保持原样不翻译）。
-
-目标：在 AIWS 约束下完成一个可回放、可验证的小步交付。
-
-建议流程：
-1) 先运行 `/ws-preflight`（读真值文件并输出约束摘要）。
-   - 若 `$ws-plan` 刚创建了 `change/<change-id>` worktree：后续实现必须在该 worktree 中继续；不要回原工作区重复 `aiws change start ...`
-2) 建立变更归因（推荐）：
-   - 若当前目录已经是 `change/<change-id>` worktree（例如由 `$ws-plan` 创建）：直接在这里继续，不要再创建第二个 worktree，也不要回原工作区写代码。
-   - 若 `/ws-plan` 已生成 `plan/...` 或 `changes/<change-id>/...` 导致工作区非空，这是预期行为；此时不要直接再做 `--switch/--worktree`，优先：`aiws change start <change-id> --hooks --no-switch`，或先提交规划工件。
-   - 推荐一键（工作区干净时）：`aiws change start <change-id> --hooks`
-   - 推荐更安全（默认）：`aiws change start <change-id> --hooks --no-switch`
-   - superproject + submodule（推荐）：`aiws change start <change-id> --hooks --worktree --submodules`
-   - 若后续需要在 detached submodule 内提交：先挂到 `aiws/pin/<target-branch>`；不要直接切 `change/<change-id>` / `main` / `master`
-   - 或手工：`git switch -c change/<change-id>`，并创建 `changes/<change-id>/proposal.md` 与 `changes/<change-id>/tasks.md`（参考 `changes/README.md`）
-3) 如涉及需求调整：先 `/ws-req-review` → 用户确认后再 `/ws-req-change`（避免需求漂移）。
-4) 实施最小改动：任何改动都要能归因到 `REQUIREMENTS.md`（验收）或 `issues/problem-issues.csv`（问题）。
-5) 运行 `AI_WORKSPACE.md` 里声明的验证命令；未运行不声称已运行。
-6) 提交前强制：`aiws validate .`（commit/push hooks 也会阻断）。
-7) 交付收尾（推荐，减少手动 merge 出错）：运行 `/ws-finish`（底层调用 `aiws change finish`，默认 fast-forward 安全合并回目标分支）。
-
-输出要求：
-- `变更文件（Changed）:` 文件清单
-- `验证（Verify）:` 实际运行的命令 + 期望结果
-- `证据（Evidence）:` 证据路径（例如 `changes/<change-id>/review/...`、`changes/<change-id>/...` 或 `.agentdocs/tmp/...`）
-<!-- AIWS_MANAGED_END:codex:ws-dev -->
-
-可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。

package/templates/workspace/.codex/prompts/ws-migrate.md

@@ -1,27 +0,0 @@
----
-description: 迁移（补齐/升级 AIWS 工作区文件）
-argument-hint: ""
----
-
-<!-- AIWS_MANAGED_BEGIN:codex:ws-migrate -->
-# ws migrate
-
-用中文输出；命令与路径保持原样不翻译。
-
-目标：把当前仓库补齐为 aiws workspace 模板，并启用可验证门禁。
-
-执行（在项目根目录）：
-1) 若已存在 `.aiws/manifest.json`：`npx @aipper/aiws update .`
-2) 否则：`npx @aipper/aiws init .`
-3) 门禁校验：`npx @aipper/aiws validate .`
-4) 启用本机 git hooks（推荐，本地生效）：`git config core.hooksPath .githooks`
-
-回滚：
-- 恢复最近一次快照：`npx @aipper/aiws rollback . latest`
-
-约束：
-- 不写入任何 secrets。
-- 不执行破坏性命令。
-<!-- AIWS_MANAGED_END:codex:ws-migrate -->
-
-可在下方追加本项目对 Codex 的额外说明（托管块外内容会被保留）。