stdagent 是一个轻量级、纯 Go 实现的 AI CLI 配置同步工具。以 .stdai/ 为 内部单一真相源，把 YAML frontmatter + Markdown 同步到 23 个 AI CLI 工具的 扩散文件，外加 MCP 服务器配置。

• spec.md — 完整 spec：std-agent 标准 + 11 工具差异 + 转换实现策略
• ../README.md 项目入口与快速开始
• prd.md 产品需求
• roadmap.md 路线图

• format-spec.md frontmatter 详细 schema
• config-spec.md .stdai/config.toml 字段
• commands.md CLI 命令规范
• conversion-rules.md 转换矩阵 + frontmatter 字段映射
• file-structure.md 目录结构与扩散原则

• architecture.md 模块划分与数据流

Tier 1（14 个）：

• targets/claude-code.md
• targets/codex.md
• targets/cursor.md
• targets/github-copilot.md
• targets/windsurf.md
• targets/gemini-cli.md
• targets/aider.md
• targets/cline.md
• targets/opencode.md
• targets/roo-code.md
• targets/crush.md
• targets/amp.md
• targets/warp.md
• targets/factory.md

Tier 2（9 个）：

• targets/continue.md
• targets/antigravity.md
• targets/qwen-code.md
• targets/pi.md
• targets/kilo-code.md
• targets/augment-code.md
• targets/jules.md
• targets/grok-build.md
• targets/kimi-code.md

1. 项目根 README.md 看产品全貌
2. docs/spec.md 是权威参考，理解概念差异 + 我们 spec
3. docs/architecture.md 看实现模块
4. docs/commands.md 看每个 CLI 命令
5. docs/targets/<X>.md 按需查阅特定工具

所有 markdown / 代码 / commit message 遵守 ASCII + 中文 + 全角中文标点 + 数学符号 （× ÷ ± ≥ ≤）字符白名单。禁止 emoji、装饰星号（★）、装饰勾叉、em/en dash、smart quotes。 优先级用 P0/P1/P2，状态用 PASS/FAIL/SKIP，进度用"已落地/进行中/未开始"。