🐛 fix(playbook): enforce rulesets to agents flow

This commit is contained in:
csh
2026-01-10 22:18:26 +08:00
parent f2df89d483
commit 37546fe4f7
13 changed files with 13 additions and 223 deletions
+9 -4
View File
@@ -46,6 +46,7 @@ PlaybookTSL`.tsl`/`.tsf`+ C++ + Python + Markdown(代码格式化)
> **重要说明**playbook 仓库中的 `rulesets/` 是**规则集模板库**,不是 playbook 项目自身的代理规则。
>
> Playbook 本身不包含源代码,因此不需要 AI 代理遵循规则。`rulesets/` 存在的目的是:
>
> 1. 作为**模板源**,供其他项目复制
> 2. 通过 `sync_standards.sh` 部署到目标项目的 `.agents/`
> 3. 目标项目的 AI 代理读取**项目根目录的 `.agents/`**(从模板生成)
@@ -54,7 +55,7 @@ PlaybookTSL`.tsl`/`.tsf`+ C++ + Python + Markdown(代码格式化)
### 三层架构设计
```
```txt
Layer 1: rulesets/ (≤50 行/语言,模板源)
├─ 核心约束与安全红线
└─ 指向 Skills 和 docs
@@ -69,6 +70,7 @@ Layer 3: docs/ (权威静态文档)
```
**目录结构**
- `rulesets/index.md`:规则集索引(跨语言)
- `rulesets/tsl/index.md`TSL 核心约定(47 行)
- `rulesets/cpp/index.md`C++ 核心约定(50 行)
@@ -82,11 +84,13 @@ Layer 3: docs/ (权威静态文档)
本仓库内置一组 Codex CLI skills(见 `codex/skills/`),用于按需加载的工作流与知识库。
**核心 Skills**
- **`$tsl-guide`**:TSL/TSF 语法完整指南(基础/高级/函数库/最佳实践)
- **`$performance-optimization`**:跨语言性能优化工作流
- **`$testing-workflow`**:跨语言测试策略
**通用 Skills**
- `$code-review-workflow`:代码审查流程
- `$commit-message`:提交信息规范
- `$systematic-debugging`:系统化调试
@@ -182,6 +186,7 @@ git commit -m ":package: deps(playbook): add tsl standards"
> 会自动生成最小版;已存在则不会覆盖。
3. **验收**(任意满足其一即可):
- 目录存在:`.agents/tsl/`
- 规则入口可读:`.agents/tsl/index.md`
- (可选)C++ 规则入口可读:`.agents/cpp/index.md`
@@ -287,9 +292,9 @@ sh docs/standards/playbook/scripts/sync_standards.sh tsl cpp
同步脚本支持以下可选环境变量(默认值可满足大多数项目):
| 变量名 | 默认值 | 说明 |
| ------------------- | ------- | ------------------------------------------------------------------------------------------- |
| `AGENTS_NS` | `tsl` | 同步的规则集名/落地目录名:`.agents/<AGENTS_NS>/`(例如 `tsl`、`cpp`) |
| 变量名 | 默认值 | 说明 |
| ------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AGENTS_NS` | `tsl` | 同步的规则集名/落地目录名:`.agents/<AGENTS_NS>/`(例如 `tsl`、`cpp` |
| `SYNC_GITATTR_MODE` | `append` | `.gitattributes` 同步模式:`append` 仅追加缺失规则(忽略注释/空行,比对后按块追加);`block` 仅维护 managed 区块;`overwrite` 全量覆盖;`skip` 不更新 |
</details>