git:20260915.213427d to git:20260924.8cef21d

6 added, 2 removed. Audit A to A.

# AGENTS.md

为 Codex 在本仓库工作提供全局约束；具体业务流程由本次任务适用的 skill 决定。

## 安装 SkillDock

当用户要求“安装 SkillDock”“安装技能管理面板”或安装并打开本应用时，先读 [README 的 Codex 安装说明](README.md#在-codex-中使用-skilldock)。用户在 clone 后的仓库中要求安装时，默认使用本地仓库来源；用户指定 GitHub 来源时按其选择执行。

- 检查 Git 和当前 Codex 的插件安装能力；按 README 添加 marketplace 并仅安装 `skilldock`；不要安装整个 `testany-eng` 代替应用。PATH 的 codex 不可执行或缺少 plugin 能力时，按 README 检查桌面应用内 CLI，并记录最终绝对路径。打开应用时使用其 `launch.sh` 自动准备 Node.js/npm，不将手动安装全局 Node 作为前置步骤。

- 读回安装结果，确认包含 `skill-manager`；不要将 clone、仅添加 marketplace 或复制源码表述为安装完成。

- 用户要求同时打开时，读取实际安装目录中的 `skills/skill-manager/SKILL.md` 并按其启动说明执行。后续可在新的 Codex 任务中用 `$skill-manager` 打开面板。

- 缺少工具或当前宿主不支持所需能力时，明确说明缺少项和可执行的下一步。普通浏览、审查或编辑仓库不触发安装。

+ ## 安装 TeamDesk

+ 用户要求安装 TeamDesk 时，先读 [TeamDesk 安装说明](plugins/teamdesk/README.md#安装与启动)，优先使用根目录 `install-teamdesk.sh` 统一入口：从 clone 运行使用该 clone，用户指定 GitHub 来源时使用文档下载入口。脚本检查依赖、原生安装及启用状态、构建并核验启动图标；缺少系统依赖时按实际错误处理，不声称已完成安装。安装不代表共享连接、hook 信任或员工记账已通过，这些按团队设置提示核验。只阅读或修改仓库不触发安装。

## 仓库与编辑边界

- Testany Agent Skills 按领域聚合 plugin（testany-eng / testany-llm / testany-mrkt / testany-bot；SkillDock 独立应用为 skilldock）。

+ Testany Agent Skills 按领域聚合 plugin（testany-eng / testany-llm / testany-mrkt / testany-bot；独立应用为 skilldock / teamdesk）。

技能位于 `plugins/<plugin>/skills/<skill>/SKILL.md`，slash 入口位于对应 `commands/`。

先读取本次相关材料和当前差异，保留已有未提交修改。只改用户目标涉及的范围，不因普通编辑自动启动完整研发流程、安装、发布或远程操作。

## Skill 规范

- 英文 kebab-case 命名；必须有 SKILL.md，根文件少于 500 行，包含使用示例。

- Frontmatter 包含 name 与带实际触发词/适用范围的 description；不要把局部任务扩大为整个工作流。

- 维护指令默认中文，技术术语可保留英文；工件输出语言遵循具体 skill 与用户要求。

- 根文件保留关键决策、授权边界和完成标准；细节按需放 references/scripts/assets，并保留明确读取条件。

- 脚本/引用按实际安装位置解析；只依赖当前存在的工具能力，不假设旧 skill-creator 脚本或宿主专用工具必然存在。

- 完成声明必须有实际证据；生成、静态检查、远程配置读回、执行终态与正式批准不能互相代替。

## 发现与文档不变量

- 根 README 与各 plugin README 是对外事实源；marketplace、默认组件约定及存在时的 plugin.json 是发现事实源。

- 同一领域新增 skill 不新增 marketplace plugin；新增/删除/重命名时同步相关入口、README、发现配置与 CHANGELOG。

- Plugin version 只能有一个 authority；同一 marketplace 内可复用 symlink，但 dangling 或越出 marketplace root 必须 fail closed。

- 修改或审查 manifest、组件发现路径、symlink、skill 增删改名，或准备安装/发布时，先读 [发现与发布维护](docs/plugin-development.md)，保留 strict/合并/路径/版本语义。

- - 普通局部编辑只执行相关本地验证，不强制读完整发布手册，不自动改版本、安装、提交或推送。

+ - 普通局部编辑只执行相关本地验证，不强制读完整发布手册，不自动改版本、安装、提交或推送；已有用户明确约定的版本规则优先。TeamDesk 每次本地迭代升 patch、每次合并远程 main 升 minor，major 由用户决定，详见 [TeamDesk 版本规则](plugins/teamdesk/AGENTS.md#版本规则)。

## 输出位置

根 `/output/` 只放本机临时交付物并保持 Git ignored；可复用资产放对应 skill 的 assets，可复现样本进入相关 tests/references。