Files
16gagent/protocol-reference/templates.md
T
2026-06-06 10:40:48 +08:00

148 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Templates — Block / Replan / Audit / Portfolio / Dashboard / Recovery
> Full template examples extracted from GOVERNANCE.md and PORTFOLIO.md.
> Main protocol files reference these by path instead of inlining.
---
## progress.log Heartbeat
```json
{"ts":"YYYY-MM-DDTHH:mm:ss+08:00","status":"IN_PROGRESS","completed":["T1"],"remaining":["T2","T3"],"risk":"","next_action":"execute T2"}
```
## blocker.md
```markdown
# Blocker
- **blocker**: <一句话描述>
- **root_cause**: <根本原因>
- **owner**: <负责人>
- **mitigation**: <缓解方案>
- **dependency**: <依赖>
- **created_at**: <ISO-8601>
- **resolved_at**: <可选>
- **escalated**: <YES/NO>
```
## execution-audit.md
```markdown
# Execution Audit — YYYY-MM-DD
## Summary
- completion_rate: XX%
- blocked_rate: XX%
- stale_rate: XX%
- failure_rate: XX%
- replan_count: N
- avg_cycle_time: Xh
## Task Status Matrix
| Agent-ID | Task ID | Status | Last Heartbeat | Cycle Time |
|----------|---------|--------|---------------|------------|
| AP-01 | T1 | IN_PROGRESS | YYYY-MM-DD HH:mm | — |
## Blockers (Active)
| Blocker | Owner | Age | Escalated |
|---------|-------|-----|-----------|
## Replans
### Replan #N (YYYY-MM-DD HH:mm)
- trigger: <R1R8>
- cause: <原因>
- before: <原始>
- after: <修订>
- impact: <影响>
## Health Score
- Delivery: X | Quality: X | Parallelism: X | Dependency: X | Learning: X
- Final: XX → <Rating>
```
## recovery-report.md
```markdown
# Recovery Report
- trigger: <A1/A2/A3>
- entered_at: <ISO-8601>
## Failed
| Agent-ID | Task | Failure Count | Root Cause |
## Blocked
| Agent-ID | Task | Blocked Since | Blocker |
## Root Cause Chain
1. <首次偏差>
2. <累积效应>
3. <触发点>
## Recovery Plan
| Task ID | Name | Depends On | Status |
|---------|------|------------|--------|
```
## portfolio.md (Registry)
```markdown
# Portfolio Registry
| Project-ID | Name | Status | Priority | Health | Agents | Progress | Last Updated | ROI |
|------------|------|--------|----------|--------|--------|----------|-------------|-----|
| P-001 | Alpha | ACTIVE | P1 | 85 | 3 | 65% | YYYY-MM-DD | 2.4 |
```
## portfolio-audit.md
```markdown
# Portfolio Audit — YYYY-MM-DD
## Active Projects
| Project-ID | Name | Health | Priority | Progress | Last Heartbeat | Risk Flag |
|------------|------|--------|----------|----------|----------------|-----------|
## Completed / Blocked / Recovery (per-section)
## Resource Report
- Total Agents: N | Busy: N | Idle: N (Utilization: XX%) | Blocked: N | Recovery: N
## Duplicate Work Report
| Pattern Class | Projects | Action Status |
## Top Risks
1. <risk> — <project>
## Portfolio Health: XX → <Rating>
```
## dashboard.md
```markdown
# Executive Dashboard — YYYY-MM-DD
## Portfolio Health: XX → <Rating>
## Top Projects
| Rank | Project | Health | Priority | Progress | Trend |
## Top Risks / Top Opportunities (per-section)
## Agent Utilization: <Rating> — Busy: N / Idle: N / Blocked: N / Recovery: N
## Learning Reuse
| Pattern | Reuse Count | Saved Effort |
## Quick Actions
- [ ] <action>
```
## Replan Log Entry
```markdown
### Replan #N (YYYY-MM-DD HH:mm)
- **trigger**: <R1R8>
- **cause**: <失败原因>
- **before**: <原始 Task Tree 摘要>
- **after**: <修订后 Task Tree 摘要>
- **impact**: <影响到的 Agent Package 列表>
```