AbsaOSS / AbsaOSS/agentic-toolkit

Add a spec-first / scoping workflow guide

未关闭
#22 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看
documentation
主要语言
Python
星标
1
派生
0
平均合并
16 小时 52 分钟
30 天内合并 PR
1

描述

## Summary

Add a **spec-first / scoping workflow** guide (and optionally a `spec-writer` skill). We use AI for well-defined scope; the missing piece is documented discipline for *getting to* that scope. Spec-first work means fewer correction loops, which means fewer tokens per task — the metric that actually drives cost.

## The guide should cover

- Why scoping/spec-first reduces cost (tokens-per-task, not per-token price).
- A practical loop: spec → plan → execute → verify.
- How to write a good spec / acceptance criteria for an agent.
- When a task is too vague to hand to an agent, and how to tighten it.
- Optionally: a `spec-writer` skill that helps draft a spec from a rough idea.

## Notes

- Back the findings with web research across multiple independent sources.
- Keep it tool-general (GitHub Copilot CLI, OpenCode, Pi).
- Tie in with existing material on agent mode and token budget.

贡献指南

打开贡献指南

评估

这个 Issue 还没有评估数据。

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。