🐛 fix(playbook): enforce rulesets to agents flow
This commit is contained in:
@@ -46,6 +46,7 @@ Playbook:TSL(`.tsl`/`.tsf`)+ C++ + Python + Markdown(代码格式化)
|
||||
> **重要说明**:playbook 仓库中的 `rulesets/` 是**规则集模板库**,不是 playbook 项目自身的代理规则。
|
||||
>
|
||||
> Playbook 本身不包含源代码,因此不需要 AI 代理遵循规则。`rulesets/` 存在的目的是:
|
||||
>
|
||||
> 1. 作为**模板源**,供其他项目复制
|
||||
> 2. 通过 `sync_standards.sh` 部署到目标项目的 `.agents/`
|
||||
> 3. 目标项目的 AI 代理读取**项目根目录的 `.agents/`**(从模板生成)
|
||||
@@ -54,7 +55,7 @@ Playbook:TSL(`.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>
|
||||
|
||||
Reference in New Issue
Block a user