tsl-playbook/.agents/index.md

TSL Playbook 代理规则集（.agents/tsl）

本规则集用于存放 AI/自动化代理在仓库内工作时必须遵守的规则。

在多语言项目中，推荐将本规则集放在目标项目的 .agents/tsl/ 下（由 scripts/sync_standards.* 同步），并与其他语言规则集并行：

• .agents/tsl/：TSL 标准规则集（本仓库提供）
• .agents/cpp/、.agents/python/ 等：其他语言规则集（按需新增）

这些规则与 docs/ 下的人类开发规范并行：

• docs/：给人看的编码/命名/提交规范
• .agents/：给代理看的任务边界、质量与安全要求

范围与优先级

• 作为仓库级基线规则集使用；更靠近代码目录的规则应更具体并可覆盖基线。
• 当代理规则与 docs 发生冲突时：
  1. 安全/合规优先
  2. 其次保持仓库现有一致性

代理工作原则

• 先理解目标与上下文，再动手改代码。
• 修改要小而清晰；避免无关重构。
• 任何可能影响行为的改动都要补充或更新测试/示例（若项目有测试体系）。
• 不要引入新依赖或工具，除非明确要求。

子文档

• 安全与鉴权：auth.md
• 性能：performance.md
• 代码质量：code_quality.md
• 测试：testing.md

分类（本仓库现状）

当前本规则集下的文件全部为 跨语言通用规则（不绑定具体语言语法/工具链）：

• auth.md：敏感信息/鉴权边界
• code_quality.md：质量底线与 review 清单
• performance.md：性能原则与验证
• testing.md：测试策略

若需要 TSL/C++ 等语言专属的代理要求，建议在目标项目新增对应目录（例如 .agents/tsl/、.agents/cpp/）或在源码子目录放置更具体的 .agents 覆盖规则。

与开发规范的关系

• 代码风格：标准快照 docs/tsl/code_style.md（通常位于目标项目 docs/standards/tsl/docs/tsl/code_style.md）
• 命名规范：标准快照 docs/tsl/naming.md（通常位于目标项目 docs/standards/tsl/docs/tsl/naming.md）
• 提交信息：标准快照 docs/common/commit_message.md（通常位于目标项目 docs/standards/tsl/docs/common/commit_message.md）