✨ feat(playbook): add plan progress tracking and rules updates
This commit is contained in:
@@ -98,7 +98,7 @@ Layer 1: rulesets/ (≤50 行/语言,模板源)
|
||||
└─ 指向 Skills 和 docs
|
||||
|
||||
Layer 2: codex/skills/ (按需加载,$skill-name 触发)
|
||||
├─ tsl-guide: TSL 渐进式语法教学(962 行)
|
||||
├─ tsl-guide: TSL 渐进式语法教学
|
||||
├─ commit-message: 提交信息规范
|
||||
├─ style-cleanup: 代码风格整理
|
||||
└─ bulk-refactor-workflow: 批量重构流程
|
||||
@@ -107,6 +107,14 @@ Layer 3: docs/ (权威静态文档)
|
||||
└─ 完整语法手册/代码风格/工具链配置
|
||||
```
|
||||
|
||||
**各层职责**:
|
||||
|
||||
| 层级 | 加载方式 | 内容 | 作用 |
|
||||
| ------- | ------------------------------ | ------------------------------ | -------------------------- |
|
||||
| Layer 1 | 自动,始终在上下文 | 硬约束与安全红线 | 快速判断能做/不能做 |
|
||||
| Layer 2 | `$<skill-name>` 触发或代理判定 | 操作指南、最佳实践、工作流 | 指导具体怎么做 |
|
||||
| Layer 3 | 按需读取特定章节 | 完整语言手册、代码风格、工具链 | 最终权威(冲突时以此为准) |
|
||||
|
||||
**目录结构**:
|
||||
|
||||
- `rulesets/index.md`:规则集索引(跨语言)
|
||||
@@ -115,7 +123,25 @@ Layer 3: docs/ (权威静态文档)
|
||||
- `rulesets/python/index.md`:Python 核心约定(45 行)
|
||||
- `rulesets/markdown/index.md`:Markdown 核心约定(31 行,仅代码格式化)
|
||||
|
||||
详见:`AGENTS.md`
|
||||
更多说明:`rulesets/index.md`
|
||||
|
||||
### 性能指标
|
||||
|
||||
| 指标 | 优化前 | 优化后 | 改善 |
|
||||
| ------------- | ------- | ------ | ---- |
|
||||
| .agents 规模 | ~500 行 | 167 行 | -67% |
|
||||
| 持久化 tokens | ~12,500 | ~4,200 | -66% |
|
||||
|
||||
### 维护原则
|
||||
|
||||
**.agents/(Layer 1)修改规则**:
|
||||
|
||||
- 可做:增加安全漏洞类型、更新核心约定、添加硬性约束
|
||||
- 不可做:添加推荐型最佳实践(→ skill)、详细语法解释(→ skill/docs)、超过 50 行(→ 拆分)
|
||||
|
||||
**Skills(Layer 2)创建规则**:
|
||||
|
||||
- 可做:增加新流程、从零教授新语言、添加跨语言通用知识
|
||||
|
||||
## SKILLS(Codex CLI)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user