coding-agent

用途

Coding Agent 是一个增量式开发智能体，用于在初始化之后的后续会话中，按照测试驱动开发（TDD）工作流逐个实现功能。它适合一次实现一个功能、遵循测试驱动开发、进行代码提交或恢复中断会话的场景。

主要能力与使用方式

快速开始

启动一个编码会话：

from scripts.coding_agent import CodingAgent

agent = CodingAgent(project_dir)
context = await agent.start_session()
print(f"Session {context.iteration} started")

实现下一个功能：

feature = await agent.select_next_feature()
result = await agent.implement_feature(feature)

if result.success:
    await agent.mark_feature_complete(feature)
    await agent.commit_work(f"Implement: {feature.description}")

会话协议（Session Protocol）

恢复上下文：读取 claude-progress.txt（快速状态）、读取 feature_list.json（剩余工作）、获取 git log（最近提交）。
环境检查：必要时运行 init.sh、验证服务器运行、运行冒烟测试。
选择功能：获取优先级最高的未完成功能、阅读功能步骤、规划实现。
以 TDD 方式实现：编写失败测试、确认测试失败、实现代码、确认测试通过、必要时验证端到端。
标记完成：更新 feature_list.json（passes: true）；注意功能状态只能由 false 变为 true。
提交工作：git add 相关文件、编写描述性提交信息、引用功能 ID。
更新进度：追加到 claude-progress.txt、列出完成事项与阻塞问题。
结束会话：让代码保持可合并状态、自动继续或关闭。

TDD 工作流

RED：编写失败测试。
GREEN：编写最小代码使测试通过。
REFACTOR：在不破坏测试的前提下清理代码。
E2E：必要时在浏览器中验证。
提交。

关键规则

每次会话只处理一个功能：聚焦以避免上下文耗尽。
测试先行：始终先写测试再实现。
标记前先验证：功能必须确实通过。
描述性提交：引用功能 ID 并说明改动。
可合并状态：代码应始终处于可工作状态。

提交信息格式

<type>: <description>，并附上 Feature: <id>。示例：

feat: implement user signup with email validation

Added SignupForm component with validation
Created /api/auth/signup endpoint
Added email verification check

Tests: 8 passing

Feature: auth-001

集成点

autonomous-session-manager：检测 CONTINUE 会话。
context-state-tracker：提供并更新状态。
security-sandbox：校验命令。
progress-tracker：追踪完成度指标。

参考资料与脚本

参考资料：

references/CODING-WORKFLOW.md：详细工作流。
references/TDD-PATTERNS.md：TDD 最佳实践。
references/COMMIT-CONVENTIONS.md：提交规范。

脚本：

scripts/coding_agent.py：主 CodingAgent 类。
scripts/feature_selector.py：功能优先级排序。
scripts/implementation_workflow.py：TDD 实现流程。
scripts/commit_workflow.py：Git 提交工作流。

限制

资料中未提供关于收费、价格、平台支持范围、性能指标或效果保证的信息，暂未提供。