@aipper/aiws-spec 0.0.33 → 0.0.34
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/docs/aiws-bootstrap-routing-design.md +5 -50
- package/docs/aiws-governance-positioning.md +1 -1
- package/docs/cli-interface.md +13 -73
- package/docs/collaboration-artifacts.md +2 -2
- package/docs/opencode-autonomous-swarm.md +0 -2
- package/docs/opencode-omo-adapter.md +0 -2
- package/docs/opencode-omo-validation-checklist.md +0 -1
- package/docs/spec-contract.md +10 -36
- package/docs/workflow-router-rules.json +2 -2
- package/docs/workflow-router-rules.md +2 -2
- package/docs/ws-goal-contract.md +16 -25
- package/package.json +1 -1
- package/templates/workspace/.aiws/continuation/CONTINUATION_PROTOCOL.md +101 -0
- package/templates/workspace/.aiws/manifest.json +2 -10
- package/templates/workspace/.opencode/command/ws-finish.md +4 -0
- package/templates/workspace/.opencode/command/ws-goal.md +5 -0
- package/templates/workspace/.opencode/commands/ws-finish.md +4 -0
- package/templates/workspace/.opencode/skills/ws-goal/SKILL.md +41 -0
- package/templates/workspace/AGENTS.md +1 -3
- package/templates/workspace/AI_PROJECT.md +6 -1
- package/templates/workspace/AI_WORKSPACE.md +1 -1
- package/templates/workspace/manifest.json +156 -447
- package/templates/workspace/.agents/skills/p-aiws-change-archive/SKILL.md +0 -24
- package/templates/workspace/.agents/skills/p-aiws-change-finish/SKILL.md +0 -24
- package/templates/workspace/.agents/skills/p-aiws-change-list/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/p-aiws-change-new/SKILL.md +0 -26
- package/templates/workspace/.agents/skills/p-aiws-change-next/SKILL.md +0 -19
- package/templates/workspace/.agents/skills/p-aiws-change-start/SKILL.md +0 -33
- package/templates/workspace/.agents/skills/p-aiws-change-status/SKILL.md +0 -19
- package/templates/workspace/.agents/skills/p-aiws-change-sync/SKILL.md +0 -19
- package/templates/workspace/.agents/skills/p-aiws-change-templates-init/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/p-aiws-change-templates-which/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/p-aiws-change-validate/SKILL.md +0 -23
- package/templates/workspace/.agents/skills/p-aiws-hooks-install/SKILL.md +0 -30
- package/templates/workspace/.agents/skills/p-aiws-hooks-status/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/p-aiws-init/SKILL.md +0 -27
- package/templates/workspace/.agents/skills/p-aiws-rollback/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/p-aiws-update/SKILL.md +0 -26
- package/templates/workspace/.agents/skills/p-aiws-validate/SKILL.md +0 -22
- package/templates/workspace/.agents/skills/p-tasks-plan/SKILL.md +0 -37
- package/templates/workspace/.agents/skills/using-aiws/SKILL.md +0 -112
- package/templates/workspace/.agents/skills/ws-analyze/SKILL.md +0 -26
- package/templates/workspace/.agents/skills/ws-bugfix/SKILL.md +0 -111
- package/templates/workspace/.agents/skills/ws-commit/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-delegate/SKILL.md +0 -75
- package/templates/workspace/.agents/skills/ws-deliver/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-dev/SKILL.md +0 -109
- package/templates/workspace/.agents/skills/ws-dev-lite/SKILL.md +0 -58
- package/templates/workspace/.agents/skills/ws-finish/SKILL.md +0 -22
- package/templates/workspace/.agents/skills/ws-frontend-design/SKILL.md +0 -126
- package/templates/workspace/.agents/skills/ws-goal/SKILL.md +0 -89
- package/templates/workspace/.agents/skills/ws-handoff/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-intake/SKILL.md +0 -106
- package/templates/workspace/.agents/skills/ws-migrate/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-plan/SKILL.md +0 -144
- package/templates/workspace/.agents/skills/ws-plan-verify/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-preflight/SKILL.md +0 -56
- package/templates/workspace/.agents/skills/ws-pull/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-push/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-quality-review/SKILL.md +0 -56
- package/templates/workspace/.agents/skills/ws-req-change/SKILL.md +0 -41
- package/templates/workspace/.agents/skills/ws-req-contract-sync/SKILL.md +0 -17
- package/templates/workspace/.agents/skills/ws-req-contract-validate/SKILL.md +0 -12
- package/templates/workspace/.agents/skills/ws-req-flow-sync/SKILL.md +0 -28
- package/templates/workspace/.agents/skills/ws-req-review/SKILL.md +0 -32
- package/templates/workspace/.agents/skills/ws-research/SKILL.md +0 -56
- package/templates/workspace/.agents/skills/ws-review/SKILL.md +0 -55
- package/templates/workspace/.agents/skills/ws-rule/SKILL.md +0 -23
- package/templates/workspace/.agents/skills/ws-spec-review/SKILL.md +0 -57
- package/templates/workspace/.agents/skills/ws-submodule-setup/SKILL.md +0 -18
- package/templates/workspace/.agents/skills/ws-verify-before-complete/SKILL.md +0 -18
- package/templates/workspace/.claude/commands/p-aiws-change-archive.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-change-finish.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-change-list.md +0 -23
- package/templates/workspace/.claude/commands/p-aiws-change-new.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-change-next.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-change-start.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-change-status.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-change-sync.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-change-templates-init.md +0 -23
- package/templates/workspace/.claude/commands/p-aiws-change-templates-which.md +0 -23
- package/templates/workspace/.claude/commands/p-aiws-change-validate.md +0 -24
- package/templates/workspace/.claude/commands/p-aiws-hooks-install.md +0 -23
- package/templates/workspace/.claude/commands/p-aiws-hooks-status.md +0 -23
- package/templates/workspace/.claude/commands/p-aiws-init.md +0 -20
- package/templates/workspace/.claude/commands/p-aiws-rollback.md +0 -13
- package/templates/workspace/.claude/commands/p-aiws-update.md +0 -19
- package/templates/workspace/.claude/commands/p-aiws-validate.md +0 -14
- package/templates/workspace/.claude/commands/using-aiws.md +0 -25
- package/templates/workspace/.claude/commands/ws-analyze.md +0 -27
- package/templates/workspace/.claude/commands/ws-bugfix.md +0 -32
- package/templates/workspace/.claude/commands/ws-commit.md +0 -67
- package/templates/workspace/.claude/commands/ws-deliver.md +0 -55
- package/templates/workspace/.claude/commands/ws-dev-lite.md +0 -31
- package/templates/workspace/.claude/commands/ws-dev.md +0 -33
- package/templates/workspace/.claude/commands/ws-finish.md +0 -72
- package/templates/workspace/.claude/commands/ws-goal.md +0 -34
- package/templates/workspace/.claude/commands/ws-handoff.md +0 -23
- package/templates/workspace/.claude/commands/ws-intake.md +0 -19
- package/templates/workspace/.claude/commands/ws-migrate.md +0 -22
- package/templates/workspace/.claude/commands/ws-plan-verify.md +0 -25
- package/templates/workspace/.claude/commands/ws-plan.md +0 -21
- package/templates/workspace/.claude/commands/ws-preflight.md +0 -27
- package/templates/workspace/.claude/commands/ws-pull.md +0 -84
- package/templates/workspace/.claude/commands/ws-push.md +0 -90
- package/templates/workspace/.claude/commands/ws-quality-review.md +0 -24
- package/templates/workspace/.claude/commands/ws-req-change.md +0 -42
- package/templates/workspace/.claude/commands/ws-req-contract-sync.md +0 -18
- package/templates/workspace/.claude/commands/ws-req-contract-validate.md +0 -13
- package/templates/workspace/.claude/commands/ws-req-flow-sync.md +0 -20
- package/templates/workspace/.claude/commands/ws-req-review.md +0 -33
- package/templates/workspace/.claude/commands/ws-review.md +0 -31
- package/templates/workspace/.claude/commands/ws-rule.md +0 -24
- package/templates/workspace/.claude/commands/ws-spec-review.md +0 -24
- package/templates/workspace/.claude/commands/ws-submodule-setup.md +0 -54
- package/templates/workspace/.claude/commands/ws-verify-before-complete.md +0 -24
- package/templates/workspace/.claude/settings.json.example +0 -26
- package/templates/workspace/.claude/skills/p-aiws-change-archive/SKILL.md +0 -24
- package/templates/workspace/.claude/skills/p-aiws-change-finish/SKILL.md +0 -24
- package/templates/workspace/.claude/skills/p-aiws-change-list/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/p-aiws-change-new/SKILL.md +0 -26
- package/templates/workspace/.claude/skills/p-aiws-change-next/SKILL.md +0 -19
- package/templates/workspace/.claude/skills/p-aiws-change-start/SKILL.md +0 -33
- package/templates/workspace/.claude/skills/p-aiws-change-status/SKILL.md +0 -19
- package/templates/workspace/.claude/skills/p-aiws-change-sync/SKILL.md +0 -19
- package/templates/workspace/.claude/skills/p-aiws-change-templates-init/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/p-aiws-change-templates-which/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/p-aiws-change-validate/SKILL.md +0 -23
- package/templates/workspace/.claude/skills/p-aiws-hooks-install/SKILL.md +0 -30
- package/templates/workspace/.claude/skills/p-aiws-hooks-status/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/p-aiws-init/SKILL.md +0 -27
- package/templates/workspace/.claude/skills/p-aiws-rollback/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/p-aiws-update/SKILL.md +0 -26
- package/templates/workspace/.claude/skills/p-aiws-validate/SKILL.md +0 -22
- package/templates/workspace/.claude/skills/p-tasks-plan/SKILL.md +0 -37
- package/templates/workspace/.claude/skills/using-aiws/SKILL.md +0 -87
- package/templates/workspace/.claude/skills/ws-analyze/SKILL.md +0 -26
- package/templates/workspace/.claude/skills/ws-bugfix/SKILL.md +0 -111
- package/templates/workspace/.claude/skills/ws-commit/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-deliver/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-dev/SKILL.md +0 -79
- package/templates/workspace/.claude/skills/ws-dev-lite/SKILL.md +0 -58
- package/templates/workspace/.claude/skills/ws-finish/SKILL.md +0 -22
- package/templates/workspace/.claude/skills/ws-frontend-design/SKILL.md +0 -126
- package/templates/workspace/.claude/skills/ws-handoff/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-intake/SKILL.md +0 -53
- package/templates/workspace/.claude/skills/ws-migrate/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-plan/SKILL.md +0 -138
- package/templates/workspace/.claude/skills/ws-plan-verify/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-preflight/SKILL.md +0 -55
- package/templates/workspace/.claude/skills/ws-pull/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-push/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-quality-review/SKILL.md +0 -56
- package/templates/workspace/.claude/skills/ws-req-change/SKILL.md +0 -41
- package/templates/workspace/.claude/skills/ws-req-contract-sync/SKILL.md +0 -17
- package/templates/workspace/.claude/skills/ws-req-contract-validate/SKILL.md +0 -12
- package/templates/workspace/.claude/skills/ws-req-flow-sync/SKILL.md +0 -28
- package/templates/workspace/.claude/skills/ws-req-review/SKILL.md +0 -32
- package/templates/workspace/.claude/skills/ws-review/SKILL.md +0 -55
- package/templates/workspace/.claude/skills/ws-rule/SKILL.md +0 -23
- package/templates/workspace/.claude/skills/ws-spec-review/SKILL.md +0 -57
- package/templates/workspace/.claude/skills/ws-submodule-setup/SKILL.md +0 -18
- package/templates/workspace/.claude/skills/ws-verify-before-complete/SKILL.md +0 -18
- package/templates/workspace/.codex/prompts/aiws-init.md +0 -23
- package/templates/workspace/.codex/prompts/aiws-rollback.md +0 -16
- package/templates/workspace/.codex/prompts/aiws-update.md +0 -22
- package/templates/workspace/.codex/prompts/aiws-validate.md +0 -17
- package/templates/workspace/.codex/prompts/ws-analyze.md +0 -32
- package/templates/workspace/.codex/prompts/ws-dev.md +0 -36
- package/templates/workspace/.codex/prompts/ws-migrate.md +0 -27
- package/templates/workspace/.codex/prompts/ws-preflight.md +0 -32
- package/templates/workspace/.codex/prompts/ws-req-change.md +0 -39
- package/templates/workspace/.codex/prompts/ws-req-contract-sync.md +0 -23
- package/templates/workspace/.codex/prompts/ws-req-contract-validate.md +0 -18
- package/templates/workspace/.codex/prompts/ws-req-flow-sync.md +0 -25
- package/templates/workspace/.codex/prompts/ws-req-review.md +0 -38
- package/templates/workspace/.codex/prompts/ws-review.md +0 -32
- package/templates/workspace/.codex/prompts/ws-rule.md +0 -29
|
@@ -1,55 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ws-review
|
|
3
|
-
description: 评审(提交前审计与证据落盘)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:在提交/交付前审计当前改动,对照真值文件检查是否越界,并把审计证据优先落盘到 `.aiws/changes/<change-id>/review/`(若无法确定 `change-id` 再回退 `.aiws/tmp/review/`)。
|
|
9
|
-
若当前语境已经明确是“准备交付/finish”,则本入口不应只停留在通用 review:应继续同时补齐 `$ws-spec-review` 与 `$ws-quality-review`,把 dual review gate 一次性收敛完。
|
|
10
|
-
|
|
11
|
-
阶段定位:
|
|
12
|
-
- review 阶段;负责对当前改动做规范、风险和验证完整性的审计。
|
|
13
|
-
|
|
14
|
-
必需输入:
|
|
15
|
-
- 当前 `git status` / `git diff`
|
|
16
|
-
- 已执行的验证结果
|
|
17
|
-
- 真值文件:`AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`
|
|
18
|
-
- 当前 `change/<change-id>` 上下文(若能识别)
|
|
19
|
-
- 若存在:`.aiws/changes/<change-id>/analysis/`、`patches/`、已有 `review/` 文件
|
|
20
|
-
|
|
21
|
-
必需输出:
|
|
22
|
-
- 审计文件:`.aiws/changes/<change-id>/review/codex-review.md` 或回退 `.aiws/tmp/review/codex-review.md`
|
|
23
|
-
- `主要风险(Top risks):` 3-8 条
|
|
24
|
-
- `下一步(Next):` 最小修复清单 + 最小验证命令
|
|
25
|
-
|
|
26
|
-
阻断条件:
|
|
27
|
-
- 没有可审计的改动或验证上下文
|
|
28
|
-
- 审计证据无法写盘
|
|
29
|
-
|
|
30
|
-
完成判定:
|
|
31
|
-
- 审计证据已落盘,主要风险和下一步已明确,可作为 commit/deliver 前置输入。
|
|
32
|
-
|
|
33
|
-
步骤(建议):
|
|
34
|
-
1) 先做 preflight:定位项目根目录(submodule 感知:若在 submodule 内自动上溯到 superproject 根),读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`,输出约束摘要。
|
|
35
|
-
2) 基于 `git status` / `git diff`(以及你实际运行过的测试结果),对照 `AI_PROJECT.md` 与 `REQUIREMENTS.md` 检查:
|
|
36
|
-
- 是否存在越界目录改动/危险操作
|
|
37
|
-
- 是否有可复现验证命令与证据
|
|
38
|
-
- 是否维护了 `.aiws/changes/<change-id>/` 或相关 `issues/*.csv`
|
|
39
|
-
- 若存在 `analysis/` / `patches/`:审查这些委托工件是否已被主 agent 理解、是否需要采用/拒绝,并把结论写入 review 文件
|
|
40
|
-
3) 将审计落盘到(目录不存在则创建):
|
|
41
|
-
- 默认:`.aiws/changes/<change-id>/review/codex-review.md`
|
|
42
|
-
- 回退:`.aiws/tmp/review/codex-review.md`(仅在无法确定 `change-id` 时使用)
|
|
43
|
-
- 若已有其它 reviewer 文件:不要覆盖它们;当前 reviewer 应写自己的文件或更新自己的汇总文件
|
|
44
|
-
4) 若当前任务已进入“准备提交/交付/finish”的语境,继续补齐 dual review gate:
|
|
45
|
-
- 运行/收敛 `$ws-spec-review`,落盘 `.aiws/changes/<change-id>/review/spec-review.md`(或回退 `.aiws/tmp/review/spec-review.md`)
|
|
46
|
-
- 运行/收敛 `$ws-quality-review`,落盘 `.aiws/changes/<change-id>/review/quality-review.md`(或回退 `.aiws/tmp/review/quality-review.md`)
|
|
47
|
-
- 不要把单个 `codex-review.md` 误当成 finish gate 已完成
|
|
48
|
-
5) 回复中输出:
|
|
49
|
-
- `证据(Evidence):` 证据文件路径
|
|
50
|
-
- `主要风险(Top risks):` 3–8 条(高→低)
|
|
51
|
-
- `下一步(Next):` 最小修复清单 + 最小验证命令
|
|
52
|
-
|
|
53
|
-
安全:
|
|
54
|
-
- 不打印 secrets。
|
|
55
|
-
- 不执行破坏性命令。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ws-rule
|
|
3
|
-
description: 规则(解释项目规则与边界)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:把用户口述的“项目特有规则”整理成可执行条款,并写入 `AI_PROJECT.md` 的 `AI_PROJECT_RULES_BEGIN/END` 段(托管块外内容会被保留)。
|
|
9
|
-
|
|
10
|
-
安全规则(强制):
|
|
11
|
-
- 不打印/不写入 secrets(token、密钥、内网地址、账号密码)。
|
|
12
|
-
- 不执行破坏性命令。
|
|
13
|
-
|
|
14
|
-
工作流:
|
|
15
|
-
1) 先做 preflight;若缺失 `AI_PROJECT.md`:提示用户先 `$ws-migrate`(或 `$aiws-init`)。
|
|
16
|
-
2) 写入前创建备份(必须):
|
|
17
|
-
`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}`
|
|
18
|
-
3) 先输出“将写入的规则清单”(3–12 条),并要求用户回复 `CONFIRM` 后再落盘。
|
|
19
|
-
4) 用户确认后,**仅更新** BEGIN/END 段内内容(合并去重;写成可检查条款:目录白名单/必须验证命令/禁止项/产物要求)。
|
|
20
|
-
5) 输出必须包含:
|
|
21
|
-
- 更新了哪些文件(路径)
|
|
22
|
-
- 回滚方式(恢复备份文件)
|
|
23
|
-
- 下一步建议:`$aiws-validate`
|
|
@@ -1,57 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ws-spec-review
|
|
3
|
-
description: 规范审查(requirements / plan / evidence / gate 完整性)
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 审查当前改动是否满足真值文件、change 绑定、证据路径和 gate 完整性要求
|
|
10
|
-
- 把“流程/规范层 blocker”与“代码层问题”区分开,优先落盘到 `.aiws/changes/<change-id>/review/spec-review.md`
|
|
11
|
-
|
|
12
|
-
阶段定位:
|
|
13
|
-
- review 子 gate;负责 requirements / plan / evidence / workflow gate 完整性审查。
|
|
14
|
-
|
|
15
|
-
必需输入:
|
|
16
|
-
- `AI_PROJECT.md`
|
|
17
|
-
- `REQUIREMENTS.md`
|
|
18
|
-
- `AI_WORKSPACE.md`
|
|
19
|
-
- 当前 `git diff`
|
|
20
|
-
- 若存在:`plan/...`、`.aiws/changes/<change-id>/proposal.md`、`tasks.md`、`review/`、`evidence/`
|
|
21
|
-
|
|
22
|
-
必需输出:
|
|
23
|
-
- `证据(Evidence):` `.aiws/changes/<change-id>/review/spec-review.md` 或回退 `.aiws/tmp/review/spec-review.md`
|
|
24
|
-
- `阻断项(Blockers):` requirements 归因 / gate / evidence 缺口
|
|
25
|
-
- `下一步(Next):` 修复项与最小验证命令
|
|
26
|
-
|
|
27
|
-
阻断条件:
|
|
28
|
-
- 无法定位项目根或真值文件
|
|
29
|
-
- 无法判断当前 change / 归因上下文
|
|
30
|
-
- 无法写 review 证据
|
|
31
|
-
|
|
32
|
-
完成判定:
|
|
33
|
-
- 已落盘 spec review 证据,且明确指出 blocker / warning / next。
|
|
34
|
-
|
|
35
|
-
步骤(建议):
|
|
36
|
-
1) 先运行 `$ws-preflight`。
|
|
37
|
-
2) 对照 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 检查:
|
|
38
|
-
- 当前改动能否归因到 `Req_ID` / `Problem_ID`
|
|
39
|
-
- `plan/...`、`proposal.md`、`tasks.md`、`evidence/` 是否与改动保持一致
|
|
40
|
-
- 是否存在越界目录改动、危险操作、未声明的非目标扩张
|
|
41
|
-
- 是否已经准备好可复现验证入口
|
|
42
|
-
3) 把结论落盘到:
|
|
43
|
-
- 默认:`.aiws/changes/<change-id>/review/spec-review.md`
|
|
44
|
-
- 回退:`.aiws/tmp/review/spec-review.md`
|
|
45
|
-
4) 输出:
|
|
46
|
-
- `证据(Evidence):`
|
|
47
|
-
- `阻断项(Blockers):`
|
|
48
|
-
- `警告(Warnings):`
|
|
49
|
-
- `下一步(Next):`
|
|
50
|
-
|
|
51
|
-
重点:
|
|
52
|
-
- 这是 spec / gate review,不是代码质量 review。
|
|
53
|
-
- 若发现实现质量或回归问题,转交给 `$ws-quality-review`。
|
|
54
|
-
|
|
55
|
-
安全:
|
|
56
|
-
- 不打印 secrets。
|
|
57
|
-
- 不执行破坏性命令。
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ws-submodule-setup
|
|
3
|
-
description: `aiws submodule-setup` 的薄包装入口
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# ws-submodule-setup
|
|
7
|
-
|
|
8
|
-
`aiws submodule-setup` 的薄包装入口。
|
|
9
|
-
|
|
10
|
-
```bash
|
|
11
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
12
|
-
./node_modules/.bin/aiws submodule-setup
|
|
13
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
14
|
-
aiws submodule-setup
|
|
15
|
-
else
|
|
16
|
-
npx @aipper/aiws submodule-setup
|
|
17
|
-
fi
|
|
18
|
-
```
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ws-verify-before-complete
|
|
3
|
-
description: `aiws verify-bc` 的薄包装入口
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# ws-verify-before-complete
|
|
7
|
-
|
|
8
|
-
`aiws verify-bc` 的薄包装入口。
|
|
9
|
-
|
|
10
|
-
```bash
|
|
11
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
12
|
-
./node_modules/.bin/aiws verify-bc
|
|
13
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
14
|
-
aiws verify-bc
|
|
15
|
-
else
|
|
16
|
-
npx @aipper/aiws verify-bc
|
|
17
|
-
fi
|
|
18
|
-
```
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-archive -->
|
|
2
|
-
# aiws change archive
|
|
3
|
-
|
|
4
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
5
|
-
|
|
6
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 归档已完成 change 工件,并生成交接文档:`changes/archive/.../handoff.md`
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>"
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change archive "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change archive "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change archive "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-archive -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-finish -->
|
|
2
|
-
# aiws change finish
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 将 change/<change-id> 安全 fast-forward 合并回目标分支
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>" # 可留空(若当前分支可推断)
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change finish "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change finish "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change finish "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-finish -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-list -->
|
|
2
|
-
# aiws change list
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 列出当前仓库 change 工件
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
14
|
-
./node_modules/.bin/aiws change list
|
|
15
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
16
|
-
aiws change list
|
|
17
|
-
else
|
|
18
|
-
npx @aipper/aiws change list
|
|
19
|
-
fi
|
|
20
|
-
```
|
|
21
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-list -->
|
|
22
|
-
|
|
23
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-new -->
|
|
2
|
-
# aiws change new
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 创建 changes/<change-id> 工件目录与基础文件
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>"
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change new "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change new "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change new "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-new -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-next -->
|
|
2
|
-
# aiws change next
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 输出 change 下一步建议动作
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>" # 可留空(若当前分支可推断)
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change next "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change next "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change next "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-next -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-start -->
|
|
2
|
-
# aiws change start
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 切到 change/<change-id> 并初始化变更工件
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>"
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change start "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change start "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change start "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-start -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-status -->
|
|
2
|
-
# aiws change status
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 查看 change 当前状态与阻断项
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>" # 可留空(若当前分支可推断)
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change status "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change status "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change status "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-status -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-sync -->
|
|
2
|
-
# aiws change sync
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 同步当前 change 与真值文件基线
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>"
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change sync "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change sync "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change sync "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-sync -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-templates-init -->
|
|
2
|
-
# aiws change templates init
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 初始化 changes/templates 覆盖模板
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
14
|
-
./node_modules/.bin/aiws change templates init
|
|
15
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
16
|
-
aiws change templates init
|
|
17
|
-
else
|
|
18
|
-
npx @aipper/aiws change templates init
|
|
19
|
-
fi
|
|
20
|
-
```
|
|
21
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-templates-init -->
|
|
22
|
-
|
|
23
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-templates-which -->
|
|
2
|
-
# aiws change templates which
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 查看 change 模板来源
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
14
|
-
./node_modules/.bin/aiws change templates which
|
|
15
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
16
|
-
aiws change templates which
|
|
17
|
-
else
|
|
18
|
-
npx @aipper/aiws change templates which
|
|
19
|
-
fi
|
|
20
|
-
```
|
|
21
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-templates-which -->
|
|
22
|
-
|
|
23
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-change-validate -->
|
|
2
|
-
# aiws change validate
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 按严格模式校验变更工件与绑定关系
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
change_id="<change-id>"
|
|
14
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
15
|
-
./node_modules/.bin/aiws change validate "${change_id}"
|
|
16
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
17
|
-
aiws change validate "${change_id}"
|
|
18
|
-
else
|
|
19
|
-
npx @aipper/aiws change validate "${change_id}"
|
|
20
|
-
fi
|
|
21
|
-
```
|
|
22
|
-
<!-- AIWS_MANAGED_END:claude:aiws-change-validate -->
|
|
23
|
-
|
|
24
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-hooks-install -->
|
|
2
|
-
# aiws hooks install
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 启用 git hooks 门禁(core.hooksPath=.githooks)
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
14
|
-
./node_modules/.bin/aiws hooks install .
|
|
15
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
16
|
-
aiws hooks install .
|
|
17
|
-
else
|
|
18
|
-
npx @aipper/aiws hooks install .
|
|
19
|
-
fi
|
|
20
|
-
```
|
|
21
|
-
<!-- AIWS_MANAGED_END:claude:aiws-hooks-install -->
|
|
22
|
-
|
|
23
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-hooks-status -->
|
|
2
|
-
# aiws hooks status
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
7
|
-
|
|
8
|
-
目标:
|
|
9
|
-
- 查看当前仓库 hooks 门禁状态(只读)
|
|
10
|
-
|
|
11
|
-
执行(在仓库根目录):
|
|
12
|
-
```bash
|
|
13
|
-
if [[ -x "./node_modules/.bin/aiws" ]]; then
|
|
14
|
-
./node_modules/.bin/aiws hooks status .
|
|
15
|
-
elif command -v aiws >/dev/null 2>&1; then
|
|
16
|
-
aiws hooks status .
|
|
17
|
-
else
|
|
18
|
-
npx @aipper/aiws hooks status .
|
|
19
|
-
fi
|
|
20
|
-
```
|
|
21
|
-
<!-- AIWS_MANAGED_END:claude:aiws-hooks-status -->
|
|
22
|
-
|
|
23
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-init -->
|
|
2
|
-
# aiws init
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
目标:
|
|
7
|
-
- 生成/补齐真值文件与门禁文件(以 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md` 为准)
|
|
8
|
-
- 写入/更新 `.gitignore` 的 aiws 托管块
|
|
9
|
-
- 生成/更新 `.aiws/manifest.json`(用于漂移检测)
|
|
10
|
-
|
|
11
|
-
建议执行:
|
|
12
|
-
1) `npx @aipper/aiws init`
|
|
13
|
-
2) `npx @aipper/aiws validate`
|
|
14
|
-
|
|
15
|
-
约束:
|
|
16
|
-
- 不写入任何 secrets
|
|
17
|
-
- 只允许更新托管块(`AIWS_MANAGED_BEGIN/END`)或 spec 指定的 `replace_file` 文件
|
|
18
|
-
<!-- AIWS_MANAGED_END:claude:aiws-init -->
|
|
19
|
-
|
|
20
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,13 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-rollback -->
|
|
2
|
-
# aiws rollback
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
目标:
|
|
7
|
-
- 从 `.aiws/backups/` 恢复到某次备份快照
|
|
8
|
-
|
|
9
|
-
建议执行:
|
|
10
|
-
- `npx @aipper/aiws rollback latest`
|
|
11
|
-
<!-- AIWS_MANAGED_END:claude:aiws-rollback -->
|
|
12
|
-
|
|
13
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,19 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-update -->
|
|
2
|
-
# aiws update
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
目标:
|
|
7
|
-
- 基于当前 `@aipper/aiws-spec` 刷新模板与 tool-native 文件
|
|
8
|
-
- 更新前备份到 `.aiws/backups/<timestamp>/`
|
|
9
|
-
|
|
10
|
-
建议执行:
|
|
11
|
-
1) `npx @aipper/aiws update`
|
|
12
|
-
2) `npx @aipper/aiws validate`
|
|
13
|
-
|
|
14
|
-
约束:
|
|
15
|
-
- 不写入任何 secrets
|
|
16
|
-
- 只更新托管块或 spec 指定的 `replace_file` 文件
|
|
17
|
-
<!-- AIWS_MANAGED_END:claude:aiws-update -->
|
|
18
|
-
|
|
19
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,14 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:aiws-validate -->
|
|
2
|
-
# aiws validate
|
|
3
|
-
|
|
4
|
-
(私有原子入口;日常优先用 /ws-* 链路。)
|
|
5
|
-
|
|
6
|
-
目标:
|
|
7
|
-
- 作为 CI/本地门禁:校验 required 文件结构、托管块、`.aiws/manifest.json` 漂移
|
|
8
|
-
- 强门禁:缺 `python3`/缺 required 脚本也应失败
|
|
9
|
-
|
|
10
|
-
建议执行:
|
|
11
|
-
- `npx @aipper/aiws validate`
|
|
12
|
-
<!-- AIWS_MANAGED_END:claude:aiws-validate -->
|
|
13
|
-
|
|
14
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,25 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:using-aiws -->
|
|
2
|
-
# using aiws
|
|
3
|
-
|
|
4
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
5
|
-
|
|
6
|
-
目标:
|
|
7
|
-
- 把当前任务先路由到正确的 AIWS workflow,而不是直接跳进实现。
|
|
8
|
-
|
|
9
|
-
执行建议:
|
|
10
|
-
1) 先读取 `AI_PROJECT.md` / `REQUIREMENTS.md` / `AI_WORKSPACE.md`。
|
|
11
|
-
2) 若缺失任一真值文件:先 `/ws-preflight`,必要时运行 `aiws init .`,不要继续实现。
|
|
12
|
-
3) 若任务意图、归因或验证入口不明确:先提 1-3 个关键澄清问题并停止。
|
|
13
|
-
4) 路由规则:
|
|
14
|
-
- 需求/验收/合同变更:`/ws-req-review`
|
|
15
|
-
- 中大型实现或需要 change/worktree:`/ws-plan`
|
|
16
|
-
- 小步明确实现:`/ws-dev`(若是 simple/local 单点修复,可显式进入 `/ws-dev-lite`)
|
|
17
|
-
- 评审/审计:`/ws-review`
|
|
18
|
-
- finish / merge / push / cleanup:`/ws-finish`
|
|
19
|
-
- handoff / archive summary:`/ws-handoff`
|
|
20
|
-
5) 输出 `Task intent:` / `Binding:` / `Route:` / `Why:` / `Next:`。
|
|
21
|
-
6) 若 `Route: ws-dev` 且任务属于 simple/local 单点修复:`Next` 可显式建议 `/ws-dev-lite`。
|
|
22
|
-
7) 除非用户只要路由判断,否则给出 route 后继续遵循对应入口的契约。
|
|
23
|
-
<!-- AIWS_MANAGED_END:claude:using-aiws -->
|
|
24
|
-
|
|
25
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:ws-analyze -->
|
|
2
|
-
# ws analyze
|
|
3
|
-
|
|
4
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
5
|
-
|
|
6
|
-
目标:在开始实现/修复前做一次技术分析,产出可执行的最小行动清单,并把证据落盘到 `.agentdocs/tmp/analyze/`。
|
|
7
|
-
|
|
8
|
-
输入:
|
|
9
|
-
- 主题/需求:`$ARGUMENTS`(若为空,先问用户一句“本次分析主题是什么?”)
|
|
10
|
-
|
|
11
|
-
步骤(建议):
|
|
12
|
-
1) 先运行 `/ws-preflight`。
|
|
13
|
-
2) 基于真值文件与当前代码现状,输出:
|
|
14
|
-
- 目标 / 非目标
|
|
15
|
-
- 现状证据(文件路径/接口路径)
|
|
16
|
-
- 推荐方案(1 个)+ 备选(可选)
|
|
17
|
-
- 风险与回滚(3–8 条)
|
|
18
|
-
- 最小验证命令(可复现)
|
|
19
|
-
3) 将分析落盘到:`.agentdocs/tmp/analyze/claude-analysis.md`(目录不存在则创建)。
|
|
20
|
-
4) 回复中必须包含:`证据(Evidence):` 证据文件路径。
|
|
21
|
-
|
|
22
|
-
安全:
|
|
23
|
-
- 不打印 secrets(尤其 `secrets/test-accounts.json`)。
|
|
24
|
-
- 不执行破坏性命令。
|
|
25
|
-
<!-- AIWS_MANAGED_END:claude:ws-analyze -->
|
|
26
|
-
|
|
27
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|
|
@@ -1,32 +0,0 @@
|
|
|
1
|
-
<!-- AIWS_MANAGED_BEGIN:claude:ws-bugfix -->
|
|
2
|
-
# ws bugfix
|
|
3
|
-
|
|
4
|
-
用中文输出(命令/路径/代码标识符保持原样不翻译)。
|
|
5
|
-
|
|
6
|
-
目标:
|
|
7
|
-
- 通过禅道 MCP 拉单、图片证据落盘并汇总 `issues/fix_bus_issues.csv`。
|
|
8
|
-
|
|
9
|
-
建议流程:
|
|
10
|
-
1) 先运行 `/ws-preflight`。
|
|
11
|
-
2) 若当前不在 `change/<change-id>` 分支 / worktree,先建立 change 上下文:
|
|
12
|
-
- 工作区先保持干净
|
|
13
|
-
- 仓库已有提交:优先 `aiws change start <change-id> --hooks --worktree`
|
|
14
|
-
- superproject + submodule:优先 `aiws change start <change-id> --hooks --worktree --submodules`
|
|
15
|
-
- 仓库尚无提交 / 不满足 worktree 前置条件:回退 `aiws change start <change-id> --hooks --no-switch`
|
|
16
|
-
3) 若上一步创建了 worktree:后续 bug 证据、CSV 更新、`/ws-dev` 修复都必须在该 worktree 中继续。
|
|
17
|
-
4) 通过已配置 zentao MCP 拉取 bug 字段与附件列表。
|
|
18
|
-
5) 落盘证据到当前 active change 上下文的 `changes/<change-id>/bug/`:
|
|
19
|
-
- `zentao-bug-<bug-id>.json`
|
|
20
|
-
- `zentao-bug-<bug-id>.md`
|
|
21
|
-
- `images/<bug-id>/...`
|
|
22
|
-
6) upsert 当前 active change 上下文中的 `issues/fix_bus_issues.csv`(主键 `Bug_ID`)。
|
|
23
|
-
7) 进入 `/ws-dev` 修复并回填状态字段 `Fix_Status/Verify_Command/Updated_At`。
|
|
24
|
-
8) 质量门:`aiws change validate <change-id> --strict` + `aiws validate . --stamp`。
|
|
25
|
-
|
|
26
|
-
强制约束:
|
|
27
|
-
- 不自动 commit / push。
|
|
28
|
-
- 不写入 secrets(token、cookie、内网地址)。
|
|
29
|
-
- 无法复现时先输出阻塞信息并落盘,不直接改代码。
|
|
30
|
-
<!-- AIWS_MANAGED_END:claude:ws-bugfix -->
|
|
31
|
-
|
|
32
|
-
可在下方追加本项目对 Claude Code 的额外说明(托管块外内容会被保留)。
|