Skip to content

StringKe/std-agent / .stdai/standards/skills/add-target

add-target

Verified

维护 stdagent 的 AI CLI target 全集。发现最新平台、对照官方规范更新适配器(落点、5 种 type、MCP、frontmatter、上下文限额),并在产品停更或配置面消失时移除。用于全量扫描、新增、更新或删除 target。

Maintain targets

目标:ValidTargets 与仍在维护、且有项目级配置面的 AI CLI 对齐。新平台按官方能力接入 5 种 type;已有平台只改有证据的差异;官方停更或配置面消失则移除。不破坏共享输出。

开始前读取 .stdai/standards/references/transformer-design.md、docs/format-spec.md、docs/conversion-rules.md,以及相近 target 的 docs/targets/<name>.md 与 transformer。

  • 用户点名工具:只处理该 target(含接入、更新或移除)。
  • 未点名:必须同时做三件事,先出差异表再改代码。无证据变化不要重写。
    1. 发现未注册的新平台
    2. 复核每个 ValidTargets 的官方规范
    3. 判定停更项并准备移除

未要求时不 commit、不发版。移除是 breaking change:先列出官方证据和受影响路径,确认后再删代码。

发现新平台

对照 internal/config.ValidTargets 搜索尚未接入的 AI coding CLI / IDE agent。用 exa 查产品与新闻,用 context7 和官方站点查项目级配置,用 gh_grep 核仓库实现。社区文章只作明确标注的补充。

接入门槛:有文档化的项目级 rules/skills/commands/agents 配置,且 stdagent 能写出该工具会发现的文件。只有用户级 ~/ 配置或纯聊天 UI 的列入 skip,不要接入。

每个候选记 add / skip / watch,并带来源 URL。

调研现有 target

官方文档和官方仓库是协议依据。每条结论带完整来源 URL。

用当前官方页面对照 adapter 与 docs/targets/<name>.md。逐项标 native / degrade / skip / UNKNOWN:

维度要确认的事实
存活产品是否仍发布;仓库是否 archived;是否改名/被后继产品取代
发现路径项目根文件、目录、加载顺序、嵌套、本地覆盖文件
rules原生路径、path matcher、always-on、是否 inline 到根文件
skills是否 Agent Skills;目录;frontmatter 白名单
commands原生 prompts/commands/workflows,或降为 skill 子目录
references原生目录或 fallback
subagents原生 agents 目录与字段,或 fallback
MCP项目级文件与顶层 key;用户配置合并则不要覆盖
共享路径是否消费 AGENTS.md / .agents/;多 target 同路径必须字节一致
限额单文件、根文件、总量的 soft/hard;超限是截断、拒载还是淘汰
不写hooks、用户 settings、全局 ~/ 配置、crush.json / kilo.jsonc 这类 JSONMerge 用户文件

硬限制只记录有官方证据的值,并同步 internal/budget.Limits。没有文档化上限就写 UNKNOWN,不要发明数字。

停更与移除

满足任一官方证据则移除(或先迁到后继 target):

  • 官方宣布停更、sunset 或产品下线
  • 官方仓库 archived,且没有沿用同一项目配置的后继产品
  • 项目级配置面消失,stdagent 再也写不出该工具会发现的文件
  • 产品改名或被后继取代:优先把现有 target 迁到后继约定,不要留僵尸名

不要因为发布间隔长、用户少、文档暂时 404 就移除。证据不足标 UNKNOWN 并保留。

改名迁移不算静默删除:保留用户仍在用的路径,直到后继 adapter 能写出等价文件。

从 ValidTargets 删除会使旧 config.toml 校验失败,commit 使用 ! 与 BREAKING CHANGE。共享路径(如 AGENTS.md)只要还有其他 producer 就保留。本仓库先从 .stdai/config.toml 去掉该 target,再 go run ./cmd/stdagent sync --no-pull --strict 让 prune 清掉其独占生成物,然后删代码。

实现

优先复用现有 protocol:AgentsMD、ClaudeMD、Cursor、Clinerules、WindsurfStyle、Copilot。仅当多个 target 共享且 adapter 无法表达时扩展协议层。单 target 特性留在 wrapper。

原生能力优先。缺失类型走现有 graceful degradation。不要虚构工具不会消费的文件。同一路径冲突必须在写盘前失败。

新增做完整注册;更新只改被证据触及的项;移除做对称删除:

  1. internal/transformer/<name>.go 及其 smoke / golden 测试
  2. internal/config.ValidTargets 与 Default().Targets(模板里新 target 默认 enabled=false)
  3. 本仓库 .stdai/config.toml 只开本仓库实际使用的 target;多 target / gitignore 模式展示放 examples/
  4. internal/writer.targetIgnorePrefixes(JSONMerge 用户文件不列入)
  5. 该 target 的 internal/budget.Limits
  6. docs/targets/<name>.md
  7. 协议族或 MCP 表:docs/conversion-rules.md
  8. 用户可见清单与数量,以 ValidTargets 为准:.stdai/standards/root.md、internal/cli/root.go 的 Long、README.md / README.zh-CN.md 及其余 README.*、docs/README.md

Done means

  • 差异表覆盖新平台、现有差异、停更项;每项 native / degrade / skip / add / remove / UNKNOWN 都有官方 URL
  • 测试覆盖 5 种 type、target filter、关键路径和所有共享文件;先复现风险再证明修复
  • go test ./...、go test -race ./internal/transformer/...、mise run check
  • go run ./cmd/stdagent sync --no-pull --strict 与 go run ./cmd/stdagent status 通过

无法执行的验证标 UNKNOWN。

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 468kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 321kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 321kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 321kUpdated Claude CodeCodexVerifiedInstall