ceo

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Quick Start

快速入门

Git Workflow

Git 工作流

You have access to git operations for version control. Use these actions to commit, push, and manage your work.
你可以使用Git操作进行版本控制。通过这些操作来提交(commit)、推送(push)和管理你的工作。

When to Use Git Actions

何时使用Git操作

Commit your changes when:
  • You've completed a logical unit of work (feature, bugfix, refactoring)
  • All tests pass successfully
  • Build completes without issues
Push to remote when:
  • You've made one or more commits
  • You're ready for code review
在以下情况提交变更:
  • 你完成了一个逻辑独立的工作单元(功能、bug修复、代码重构)
  • 所有测试执行成功
  • 构建过程无问题
在以下情况推送到远程仓库:
  • 你已完成一次或多次提交
  • 你准备好进行代码评审

Action Format

操作格式

You communicate via JSON actions. Each response is ONE action:
json
{"action": "git_commit", "message": "fix: Resolve auth timeout\n\nBead: bead-abc-123"}
你通过JSON格式的指令进行交互。每个响应对应一个操作:
json
{"action": "git_commit", "message": "fix: Resolve auth timeout\n\nBead: bead-abc-123"}

Git Action Examples

Git操作示例

1. Commit Changes:
json
{"action": "git_commit", "message": "feat: Add user authentication\n\nBead: bead-abc-123"}
2. Push to Remote:
json
{"action": "git_push"}
3. Complete Workflow:
json
{"action": "test", "notes": "Running tests before commit"}
Then after tests pass:
json
{"action": "git_commit", "message": "fix: Resolve authentication timeout issue\n\nBead: bead-abc-123"}
Then:
json
{"action": "git_push", "notes": "Pushing committed fix"}
Then:
json
{"action": "done", "reason": "Fixed auth timeout, committed and pushed"}
1. 提交变更:
json
{"action": "git_commit", "message": "feat: Add user authentication\n\nBead: bead-abc-123"}
2. 推送到远程仓库:
json
{"action": "git_push"}
3. 完整工作流:
json
{"action": "test", "notes": "Running tests before commit"}
测试通过后:
json
{"action": "git_commit", "message": "fix: Resolve authentication timeout issue\n\nBead: bead-abc-123"}
然后:
json
{"action": "git_push", "notes": "Pushing committed fix"}
最后:
json
{"action": "done", "reason": "Fixed auth timeout, committed and pushed"}

Commit Message Format

提交消息格式

Follow conventional commits format:
<type>: <summary>

<detailed description>

Bead: <bead-id>
Types:
  • feat
    : New feature
  • fix
    : Bug fix
  • refactor
    : Code restructuring
  • test
    : Adding or updating tests
  • docs
    : Documentation changes
  • chore
    : Maintenance tasks
遵循约定式提交格式:
<type>: <summary>

<detailed description>

Bead: <bead-id>
类型说明:
  • feat
    : 新功能
  • fix
    : Bug修复
  • refactor
    : 代码重构
  • test
    : 添加或更新测试
  • docs
    : 文档变更
  • chore
    : 维护任务

Git Best Practices

Git最佳实践

  1. Commit After Success: Only commit when tests pass and builds succeed
  2. Atomic Commits: Each commit should represent one logical change
  3. Clear Messages: Write descriptive commit messages explaining why, not what
  4. Reference Beads: Always include bead ID in commits
  1. 成功后提交:仅在测试通过且构建成功时提交
  2. 原子提交:每次提交应代表一个独立的逻辑变更
  3. 清晰的消息:编写描述性的提交消息,解释原因而非内容
  4. 关联Bead:提交中始终包含Bead ID

Security Considerations

安全注意事项

  • Secret Detection: Commits are scanned for API keys, passwords, tokens
  • Commits are automatically tagged with your bead ID and agent ID

  • 敏感信息检测:提交内容会被扫描是否包含API密钥、密码、令牌等
  • 提交会自动标记你的Bead ID和Agent ID

CEO

CEO

The human project owner and final authority. Does not write code or run tools -- resolves tie-breaks, approves or denies major decisions, and unblocks deadlocks.
Specialties: final approvals, tie-breaking, escalation resolution, strategic direction, budget sign-off
人类项目所有者及最终决策者。不编写代码或运行工具——负责解决争议、批准或否决重大决策,并打破僵局。
专长:最终审批、争议解决、升级问题处理、战略方向制定、预算审批