🎨 style(markdown): format markdown files

This commit is contained in:
csh
2026-01-21 10:20:53 +08:00
parent 8dc8924cbe
commit fc230b7ff9
11 changed files with 76 additions and 12 deletions
+34
View File
@@ -41,6 +41,39 @@ PlaybookTSL`.tsl`/`.tsf`+ C++ + Python + Markdown(代码格式化)
- `templates/ci/`:目标项目 CI 示例模板(如 Gitea
Actions),用于自动化校验部分规范。
## templates/(项目架构模板)
`templates/` 目录除了语言配置模板外,还包含 AI 代理工作环境的项目架构模板:
- `templates/memory-bank/`:项目上下文文档模板(project-brief、tech-stack、architecture、progress、decisions、implementation-plan
- `templates/prompts/`:工作流程模板(agent-behavior、clarify、verify
- `templates/AGENTS.template.md`:路由中心模板(项目主入口)
- `templates/AGENT_RULES.template.md`:执行流程模板
### 快速部署
使用 `sync_templates` 脚本一键部署项目架构:
```bash
# Linux/macOS
sh scripts/sync_templates.sh /path/to/project
# PowerShell
.\scripts\sync_templates.ps1 -ProjectRoot C:\path\to\project
# Windows CMD
scripts\sync_templates.bat C:\path\to\project
```
**部署行为**
- **新项目**:创建完整的 `AGENTS.md``AGENT_RULES.md``memory-bank/``docs/prompts/``TODO.md``CONFIRM.md`
- **已有 AGENTS.md**:追加路由链接(使用 `<!-- playbook:templates:start/end -->` 标记)
- **--full 参数**:追加完整框架(规则优先级 + 新会话开始时)到已有 AGENTS.md
- **其他文件**:如果已存在则跳过(使用 `--force` 覆盖)
详见:`templates/README.md`
## rulesets/(规则集模板库 - 三层架构)
> **重要说明**playbook 仓库中的 `rulesets/` 是**规则集模板库**,不是 playbook 项目自身的代理规则。
@@ -187,6 +220,7 @@ git commit -m ":package: deps(playbook): add tsl standards"
> 会自动生成最小版;已存在则不会覆盖。
3. **验收**(任意满足其一即可):
- 目录存在:`.agents/tsl/`
- 规则入口可读:`.agents/tsl/index.md`
- (可选)C++ 规则入口可读:`.agents/cpp/index.md`